HP 3000 Manuals HP 3000 Manuals
Symbolic Debugger/iX User's Guide
________________________________________________________________________ |The information contained in this document is subject to change | |without notice. | | | |HEWLETT-PACKARD MAKES NO WARRANTY OF ANY KIND WITH REGARD TO THIS | |MATERIAL, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF | |MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. Hewlett-Packard | |shall not be liable for errors contained herein or for incidental or | |consequential damages in connection with the furnishing, performance | |or use of this material. | | | |Hewlett-Packard assumes no responsibility for the use or reliability | |of its software on equipment that is not furnished by Hewlett-Packard.| | | |This document contains proprietary information which is protected by | |copyright. All rights are reserved. No part of this document may be | |photocopied, reproduced or translated to another language without the | |prior written consent of Hewlett-Packard Company. | ________________________________________________________________________ copyright (c)1989, 1990, 1991, 1992 by Hewlett-Packard Company Printed in U.S.A. 900 Series HP 3000 Computers HP Part No. 31508-90003 Edition Third Edition E0692 Printed June 1992 Print History The following table lists the printings of this document, together with the respective release dates for each edition. Many product releases do not require changes to the document. Therefore, do not expect a one-to-one correspondence between product releases and document editions. Edition Date --------------------------------------------------------------------------------------- First Edition October 1989 Second Edition April 1990 Third Edition June 1992 . Preface The HP Symbolic Debugger/iX User's Guide explains how to debug computer programs on 900 Series HP 3000 computer systems. The manual assumes that you are an experienced programmer familiar with symbolic debuggers on other systems. This manual contains the following chapters: Chapter 1 Introduces the HP Symbolic Debugger/iX - what it is and who can use it. This chapter also explains how to prepare a program for use with the symbolic debugger. Chapter 2 Contains listings of sample debugger programs which are used in sample debugger sessions online. Use these listings for reference to the online programs when experimenting with the debugger. Chapter 3 Describes how to use HP Symbolic Debugger to debug programs. Chapter 4 Discusses the HP Symbolic Debugger commands. Appendix A Lists warning and error messages, along with their remedial actions. Appendix B Lists the language operators for HP C. Appendix C Lists the language operators for HP FORTRAN 77 and explains FORTRAN VMS record support. Appendix D Lists the language operators for HP Pascal. Appendix E Lists the language operators for HP COBOL II. Appendix F Lists special variables used by the HP Symbolic Debugger. Appendix G Lists some limitations of HP Symbolic Debugger and gives some usage hints. Appendix H Lists installed HP Symbolic Debugger files. Appendix I Lists the HP Symbolic Debugger commands. Appendix J Lists the registers displayed by the debugger in disassembly mode. Glossary Lists new terms and their definitions. Additional Documentation This manual does not discuss the MPE/iX operating system in detail. Only those aspects relevant to HP Symbolic Debugger are mentioned. Similarly, details about compiling a program using HP COBOL II, HP FORTRAN 77, HP Pascal, and HP C are only discussed to the extent that they affect how you use HP Symbolic Debugger. See the appropriate operating system or language manual for complete information about those subjects. The following is a partial list of the operating system and language manuals: ---------------------------------------------------------------------- | | | Manual Title Manual Number to Use | | Part Number to | | Order Manual | | | ---------------------------------------------------------------------- | | | HP COBOL II/XL Reference Manual 31500-90001 31500-90001 | | | | HP COBOL II/XL Programmer's Guide 31500-90002 31500-90002 | | | | HP COBOL II/XL Quick Reference Guide 31500-90003 31500-90003 | | | ---------------------------------------------------------------------- | | | HP FORTRAN 77/iX Reference 31501-90010 31501-60021 | | | | HP FORTRAN 77/iX Programmer's Guide 31501-90011 31501-60022 | | | | HP FORTRAN 77/iX Migration Guide 31501-90004 31501-90023 | | | ---------------------------------------------------------------------- | | | HP Pascal/iX Reference Manual 31502-90001 31502-90001 | | | | HP Pascal/iX Programmer's Guide 31502-90002 31502-90002 | | | ---------------------------------------------------------------------- | | | HP C/iX Reference Manual 31506-90005 31506-90005 | | | | HP C/iX Library Reference Manual 30026-90001 30026-90001 | | | | HP C Programmer's Guide 92434-90002 92434-90002 | | | ---------------------------------------------------------------------- | | | HP Link Editor/iX Reference Manual 32650-90030 32650-90030 | | | ---------------------------------------------------------------------- | | | MPE/iX Commands Reference Manual 32650-90003 32650-60002 | | | | MPE/iX Intrinsics Manual 32650-90028 32650-90028 | | | ---------------------------------------------------------------------- | | | PA-RISC 1.1 Architecture and 09740-90039 09740-90039 | | Instruction Set | | | ---------------------------------------------------------------------- Conventions CASE In a syntax statement, commands and keywords are shown in uppercase and lowercase characters. The characters must be entered in the order shown; however, you can enter the characters in either uppercase or lowercase. For example: SHOWJOB can be entered as any of the following: showjob Showjob SHOWJOB It cannot, however, be entered as: shojwob Shojob SHOW_JOB italics In a syntax statement or an example, a word in italics represents a parameter or argument that you must replace with an actual value. In the following example, you must replace filename with the name of the file: RELEASE filename Italics font is also used to emphasize a word or words. punctuation In a syntax statement, punctuation characters (other than brackets, braces, vertical bars, and ellipses) must be entered exactly as shown. In the following example, the parentheses and colon must be entered: (filename):(filename) underlining Within an example that contains interactive dialog, user input and user responses to prompts are indicated by underlining. In the following example, "yes" is the user's response to the prompt: Do you want to continue? >> yes { } In a syntax statement, braces enclose required elements. When several elements are stacked within braces, you must select one. In the following example, you must select either ON or OFF: SETMSG {ON } {OFF} Commands listed in braces are called command lists throughout this manual. Conventions (continued) [ ] In a syntax statement, brackets enclose optional elements. In the following example, ,TEMP can be omitted: PURGE filename[,TEMP] When several elements are stacked within brackets, you can select one or none of the elements. In the following example, you can select devicename or deviceclass or neither. The elements cannot be repeated. SHOWDEV [devicename ] [deviceclass] [...] In a syntax statement, horizontal ellipses enclosed in brackets indicate that you can repeatedly select the element(s) that appear within the immediately preceding pair of brackets or braces. In the example below, you can select itemname zero or more times. Each instance of itemname must be preceded by a comma: [,itemname] [...] In the example below, you only use the comma as a delimiter if itemname is repeated; no comma is used before the first occurrence of itemname: [itemname] [,...] |...| In a syntax statement, horizontal ellipses enclosed in vertical bars indicate that you can select more than one element within the immediately preceding pair of brackets or braces. However, each particular element can only be selected once. In the following example, you must select A, AB, BA or B. The elements cannot be repeated. {A}|...| {B} ...: In an example, horizontal or vertical ellipses indicate where portions of the example have been omitted. In a syntax statement, the space symbol shows a required blank. In the following example, modifier and variable must be separated with a blank: SET [(modifier)] (variable); The symbol indicates a key on the keyboard. For example, RETURN represents the carriage return key. Conventions (continued) CNTLchar CNTLchar indicates a control character. For example, CNTLY means you press the control key and the Y key simultaneously. Comment Explains an operator entry or debug message. > The HP Symbolic Debugger prompt. | Represents "or". ; Separates commands in a command list. base prefixes The prefixes %, #, and $ specify the numerical base of the value that follows: %num specifies an octal number #num specifies a decimal number $num specifies a hexadecimal number If no base is specified, decimal is assumed. Bits (bit:length) When a parameter contains more than one piece of data within its bit field, the different data fields are described in the format Bits (bit:length) bit is the first bit in the field and length is the number of consecutive bits in the field. For example, Bits (13:3) indicates bits 13, 14, and 15:
![[]](../../pic3k/M012092/FFN23c50.gif)