Tools and Utilities Library Inspect Reference Summary Abstract Part Number Edition Published Product Version Release ID Supported Releases This reference summary documents the commands and language-dependent elements of Inspect. 106101 Sixth December 1994 Inspect D30 D30.00 This manual supports D30.00 and all subsequent releases until otherwise indicated in a new edition.
Document History Edition Part Number Product Version Earliest Supported Release Published Fourth Fifth 054438 063742 C30.06 C30/D10.00 September 1991 September 1993 Sixth 106101 Inspect C30 Inspect C30 Inspect D10/D20 D30 D30.00 December 1994 New editions incorporate any updates issued since the previous edition.
Contents v 7 37 43 45 47 49 51 53 Notation Conventions High-Level Inspect Commands Low-Level Inspect Commands Parameters for C Parameters for C++ Parameters for COBOL and SCREEN COBOL Parameters for FORTRAN Parameters for Pascal Parameters for TAL 106101 Tandem Computers Incorporated iii
Contents (This page left intentionally blank) iv 098208 Tandem Computers Incorporated
Notation Conventions The following list summarizes the conventions for syntax presentation in this manual. Notation Meaning UPPERCASE LETTERS Uppercase letters represent keywords and reserved words; enter these items exactly as shown. Boldface letters in a keyword or reserved word indicate the abbreviation of the keyword or reserved word. Lowercase italic letters represent variable items that you supply. Brackets enclose optional syntax items.
Notation Conventions (This page left intentionally blank) vi 098208 Tandem Computers Incorporated
High-Level Inspect Commands The syntax of the following high-level parameters depends on the programming language you are using: scope-path code-location data-location expression The language subsections of this appendix describe these parameters. ADD The ADD command adds an item to one of the lists of information that Inspect maintains.
Inspect Reference Summary High-Level Inspect Commands ADD ALIAS The ADD ALIAS command adds a name for a command string to the alias list for the current Inspect session. ADD ALIAS alias-name [=] replacement-string replacement-string: one of " [ character ]... " ' [ character ]... ' ADD KEY The ADD KEY command adds a function-key definition to the function-key list for the current Inspect session.
Inspect Reference SUmmary High-Level Inspect Commands ADD SOURCE ASSIGN The ADD SOURCE ASSIGN command adds a source assignment to the current program's source assignment list. Source assignments enable you to inform Inspect of changes in the names or locations of source files. ADD SOURCE ASSIGN [ original-name , ] new-name original-name: one of [ \system. ] $volume [ .subvolume [ .file ] ] [ \system. ] $process [ .#qual-1 [ .qual-2 ] ] [ \system. ] cpu, pin [ \system. ] $volume.
Inspect Reference Summary High-Level Inspect Commands data-subtype: one of ACCESS CHANGE brk-action: one of READ WRITE READ WRITE WRITE READ TEMP [ integer ] THEN { command-string | alias-name } CD The CD command changes the current OSS directory. CD { oss-pathname } CLEAR The CLEAR command clears one or more breakpoints in the current program.
Inspect Reference SUmmary High-Level Inspect Commands original-name: one of [ \system. ] $volume [ .subvolume [ .file ] ] [ \system. ] $process [ .#qual-1 [ .qual-2 ] ] [ \system. ] cpu, pin [ \system. ] $volume.#number /oss-pathname [/oss-pathname...] DELETE ALIAS The DELETE ALIAS command removes one or all aliases from the alias list for the current Inspect session.
Inspect Reference Summary High-Level Inspect Commands DISPLAY The DISPLAY command formats and displays the value of a variety of items including constants, expressions, code, and data. DISPLAY item [ , item ]...
Inspect Reference SUmmary High-Level Inspect Commands for-count: one of non-negative integer data-location register-item: ALL one of BOTH register-name: TNS register-name TNS/R one of tns-register-name tns/r-register-name tns-register-name: P R0 RA E R1 RB one of L R2 RC tns/r-register-name: S R3 RD R4 RE R5 RF R6 RG R7 RH $S7 $T7 $T8 one of $0 $1 $2 $3...
Inspect Reference Summary High-Level Inspect Commands token-spec: token-code [ : token-index ] [ SSID ssid-string ] token-code: one of token-index ssid-string value-list: one of integer integer , integer integer , integer , integer , integer formatting-clause: one of IN base [ base ]... { FORMAT | FMT } format-list PIC mask-string [ , mask-string ]...
Inspect Reference SUmmary High-Level Inspect Commands ENV The ENV command displays the current settings of the Inspect environment and selectable parameters. ENV [ env-parameter ] env-parameter: one of DIRECTORY LANGUAGE LOG PROGRAM SCOPE SOURCE SYSTEM SYSTEM SYSTYPE VOLUME EXIT The EXIT command stops the Inspect process. Programs being debugged with Inspect are not stopped. EXIT FA-Fix Alias The FA command enables you to retrieve, edit, and reissue an existing alias definition.
Inspect Reference Summary High-Level Inspect Commands FILES The FILES command shows the status of files that have been opened by the current program. FILES { * | file-list } [ [ file-type ] ] [ DETAIL ] file-list file-number file-type: ]... one of FORTRAN FK-Fix Key [, file-number FD GUARDIAN The FK command enables you to retrieve, edit, and reissue an existing function-key definition.
Inspect Reference SUmmary High-Level Inspect Commands HOLD The HOLD command suspends the execution of a program on the program list, placing it in the hold state. Inspect does not begin prompting again until all suspensions are accomplished. HOLD [ program [ , program ]... ] [ * ] program: one of program-number program-name cpu,pin ICODE The ICODE command displays instruction mnemonics starting at a specified statement or code address.
Inspect Reference Summary High-Level Inspect Commands tns/r-address-expression: tns/r-value [ operator tns/r-value ]... tns-address-expression: tns-value [ operator tns-value ]... operator: * / one of << tns-value: >> + - one of ( tns-expression ) 16-bit number tns-register tns/r-value: one of ( tns/r-address-expression ) 32-bit number 16-bit number [ .
Inspect Reference SUmmary High-Level Inspect Commands INFO The INFO command displays information about various kinds of items in the current program. INFO info-item info-item: one of IDENTIFIER { * | identifier-spec } LOCATION [ * | [ SCOPE scope-path | scope-ordinal ] ] OBJECTFILE [ FILE filename ] OPENS [ { * | file-list } [ DETAIL ] [ F ] ] SAVEFILE [ FILE filename ] SCOPE [ scope-number | scope-path ] SEGMENT[S] [ * | segment-id ] [[, ] DETAIL ] SIGNALS[S] [ * | signal-id [, signal-id ...
Inspect Reference Summary High-Level Inspect Commands INFO OBJECTFILE The INFO OBJECTFILE command displays information about the current program's object files, or any specified object file. It provides additional information for object files created by the Accelerator. FILE filename INFO OBJECTFILE [ INFO OPENS ] The INFO OPENS command shows the status of files that have been opened by the current program.
Inspect Reference SUmmary High-Level Inspect Commands INFO SIGNALS The INFO SIGNALS command displays signal information for the current program. INFO SIGNAL[S] [ * | signal-id [, signal-id...] ] [ [, ] DETAIL ] KEY The KEY command adds a function-key definition or displays one or all function-key definitions in the function-key list for the current Inspect session.
Inspect Reference Summary High-Level Inspect Commands LIST ALIAS The LIST ALIAS command displays either one or all aliases from the alias list for the current Inspect session. LIST ALIAS[ES] [ alias-name ] [ AS COMMAND[S] ] LIST BREAKPOINT The LIST BREAKPOINT command displays either one or all breakpoints defined in the current program. This command applies to breakpoints set by both Inspect and Debug.
Inspect Reference SUmmary High-Level Inspect Commands LIST SOURCE ASSIGN The LIST SOURCE ASSIGN command displays the source assignments from the source-assignment list for the current Inspect session. LIST SOURCE ASSIGN[S] [ AS COMMAND[S] ] LIST SOURCE OPEN The LIST SOURCE OPEN command displays the names of the files that are currently open as a result of previous SOURCE commands. LIST SOURCE OPEN[S] LOG The LOG command records the session input, output, or both input and output in a permanent file.
Inspect Reference Summary High-Level Inspect Commands register-name: one of tns-register-name tns/r-register tns-register-name: P R0 RA E R1 RB L R2 RC S R3 RD tns/r-register: $PC one of R4 RE R6 RG R7 RH one of $H1 $LO signal-id: R5 RF $0 $1...
Inspect Reference SUmmary High-Level Inspect Commands OPENS The OPENS command shows the status of files that have been opened by the current program. OPENS { * | file-list } [ [ DETAIL ] [ file-type ] ] file-list file-number file-type: ]... one of FORTRAN OUT [, file-number FD GUARDIAN The OUT command directs the output listing to a specified file.
Inspect Reference Summary High-Level Inspect Commands SAVE The SAVE command creates a save file of the current program, including its extended segments and registers. For accelerated programs, this included the current instruction set being executed, and TNS/R machine registers. Note that the SAVE command is invalid for PATHWAY requestor programs. SAVE filename [ ! ] SCOPE The SCOPE command changes or displays the current scope path.
Inspect Reference SUmmary High-Level Inspect Commands SELECT LANGUAGE The SELECT LANGUAGE command changes the current source language. The current source language affects the acceptable syntax of language-dependent entities such as code locations, data locations, and expressions. SELECT LANGUAGE language language: one of C C++ FORTRAN Pascal SELECT PROGRAM COBOL SCOBOL COBOL85 TAL The SELECT PROGRAM command selects a program from the program list as the current program.
Inspect Reference Summary High-Level Inspect Commands SET SET set-assignment set-assignment: one of CHARACTER FORMAT [=] { ASCII | GRAPHICS | XASCII } DEREFERENCE DEPTH [=] integer ECHO echo-item [=] { ON | OFF } LOCATION FORMAT [ level ] [=] loc-fmt [, loc-fmt ]... PRIV MODE [=] { ON | OFF } PROMPT [=] [ prompt-item [ , prompt-item ]...
Inspect Reference SUmmary High-Level Inspect Commands count: integer [ STATEMENT[S] | LINE[S] | INSTRUCTION[S] ] range: F one of L #line-number statement-number status-item-list: status-item [ , status-item ]...
Inspect Reference Summary High-Level Inspect Commands SET LOCATION FORMAT The SET LOCATION FORMAT command controls how Inspect displays code locations. In addition, the SET LOCATION FORMAT command allows you to differentiate between statement numbers and labels within FORTRAN programs. SET LOCATION FORMAT [ level ] [=] loc-fmt [, loc-fmt ]...
Inspect Reference SUmmary High-Level Inspect Commands SET RADIX The SET RADIX command changes the default radix (numeric base) for integer representations of input, output, or both. Inspect uses the default input radix to qualify integer values that are unqualified—that is, integers whose base is not specified. Each source language provides its own mechanism for specifying bases.
Inspect Reference Summary High-Level Inspect Commands SET STATUS ACTION The SET STATUS ACTION command specifies actions that Inspect is to perform after it displays the event status message. SET STATUS ACTION [ level ] [=] [ cmd-string ] level: BOTH one of HIGH cmd-string: LOW one of " command [ ; command ]... " ' command [ ; command ]...
Inspect Reference SUmmary High-Level Inspect Commands SET TRACE The SET TRACE command controls the dynamic trace facility of Inspect. When dynamic tracing is activated, Inspect displays trace information concerning the current program as it executes. SET TRACE enables you to activate this facility and control the level of tracing.
Inspect Reference Summary High-Level Inspect Commands SOURCE The SOURCE command's primary function is to display source text. It performs other functions, including searching for source text, displaying text from an arbitrary file, and allowing you to redefine the location of source files. SOURCE [ source-locator ] [ limit-spec ]...
Inspect Reference SUmmary High-Level Inspect Commands STOP The STOP command stops one or more programs, removing the stopped programs from the program list. STOP [ * | program ] program: one of program-number program-name cpu,pin SYSTEM The SYSTEM command sets the default system for expanding file names as operands to Inspect commands. SYSTEM [ \system ] TERM The TERM command alters Inspect's command terminal by changing the home terminal of the Inspect process to another terminal or a process.
Inspect Reference Summary High-Level Inspect Commands XC-eXecute Command The XC command reissues a command line from the history buffer.
Low-Level Inspect Commands Low-level Inspect supports all high-level commands except: BREAK CLEAR DISPLAY MODIFY SCOPE The following low-level Inspect command parameters are described after the low-level commands themselves: address A code-address data-address expr The A command displays data and registers in ASCII.
Inspect Reference Summary Low-Level Inspect Commands D The D command displays memory or register contents. D [ [ unit ] address [ , amount ] ] [ : base ] [ register ] unit: B one of W D amount: F one of num T width * height base: A one of F B D H register: one of P R0 RA L R2 RC E R1 RB I O S R3 RD R4 RE X # R5 RF R6 RG R7 RH The F command shows status of files opened by the current program. F [ expr ] FN The FN command searches memory for a particular value.
Inspect Reference Summary Low-Level Inspect Commands M The M command allows changes to data locations or registers in the current program. M { register | data-address } [ , expr ]... P register: one of P R0 RA L R2 RC E R1 RB S R3 RD R4 RE R5 RF R6 RG R7 RH The P command suppresses Inspect prompts until a debug event occurs in any program under the control of Inspect, or until the specified pause time (measured in centiseconds) has expired.
Inspect Reference Summary Low-Level Inspect Commands Low-Level Addresses address: one of code-address data-address Low-Level Code Addresses code-address: [ base-mode ] expr base-mode: one of C UC [ .space-id ] UL [ .
Inspect Reference Summary Low-Level Inspect Commands Low-Level Expressions expr: value [ operator value ]... operator: * value: / one of << >> + - one of ( expression ) 'ASCII-character ASCII-character #code-block #data-block number [ .
Inspect Reference Summary Low-Level Inspect Commands (This page left intentionally blank) 42 106101 Tandem Computers Incorporated
Parameters for C C Scope Units and Scope Paths scope-path: #function C Code Locations code-location: { scope-path } [ FROM module˚] [ offset˚]... { [scope-path.]code-spec } code-spec: one of function label statement-number #line-number [ (source-file) ] offset: { + | - } num [ code-unit ] code-unit: one of INSTRUCTION[S] C Data Locations STATEMENT[S] VERB[S] data-location: [ scope-path [ (instance) ] . ] data-reference [ #data-block.
Inspect Reference Summary Parameters for C C Expressions expression: one of primary *expression &expression -expression !expression ~expression expression binary-op expression primary: one of data-location binary-op: * << != 44 / < & constant string one of % > ^ + <= | 106101 Tandem Computers Incorporated >= && >> == || ( expression )
Parameters for C++ C++ Scope Units and Scope Paths scope-path: #function C++ Code Locations code-location: { scope-path } [ FROM module˚] [ offset˚]... { [ scope-path.] code-spec } code-spec: one of function label statement-number #line-number [ (source-file) ] offset: { + | - } num [ code-unit ] code-unit: one of INSTRUCTION[S] C ++ Data Locations STATEMENT[S] VERB[S] data-location: [ scope-path [ (instance) ] . ] data-reference [ #data-block.
Inspect Reference Summary Parameters for C++ C++ Expressions expression: one of primary *expression &expression -expression !expression ~expression expression binary-op expression primary: one of data-location binary-op: * << != 46 / < & constant string one of % > ^ + <= | 106101 Tandem Computers Incorporated >= && >> == || ( expression )
Parameters for COBOL and SCREEN COBOL COBOL 74 and SCOBOL Scope Units and Scope Paths scope-path: #program-unit COBOL85 Scope Paths scope-path: #program-unit [ .program-unit ]... COBOL Code Locations code-location: { scope-path } [ offset ]... { [scope-path.
Inspect Reference Summary Parameters for COBOL and SCREEN COBOL COBOL Expressions expression: condition [ { AND | OR } condition ]... condition: [ NOT ] { simple-exp [ rel-op simple-exp ]... } { level-88-condition } rel-op: [ NOT ] { > = < GREATER EQUAL LESS } simple-exp: [ + | - ] term [ { + | - } term ]... term: factor [ { * | / } factor ]...
Parameters for FORTRAN FORTRAN Scope Units and Scope Paths scope-path: #scope-unit scope-unit: program FORTRAN Code Locations one of subroutine function code-location: { scope-path } [ offset ]... { [scope-path.
Inspect Reference Summary Parameters for FORTRAN FORTRAN Data Locations data-location: [ scope-path [ (instance) ] . ] data-reference instance: [ + | - ] num data-reference: one of identifier data-reference ( index [ ,index ]... ) data-reference^identifier index: expression [ :expression ] FORTRAN Expressions expression: condition [ bool-op condition ]... bool-op: one of .AND. .OR. .EQV. .NEQV. condition: [ .NOT. ] simple-exp [ rel-op simple-exp ] rel-op: .LT. one of .LE. .GT. .GE. .EQ. .
Parameters for Pascal Pascal Scope Units and Scope Paths scope-path: #scope-unit [ .scope-unit ]... scope-unit: one of function Pascal Code Locations procedure code-location: { scope-path } [ FROM module˚] [ offset˚]... { [scope-path.
Inspect Reference Summary Parameters for Pascal Pascal Data Locations data-location: [ scope-path [ (instance) ] . ] data-reference [ #data-block. ] instance: [ + | - ] integer data-reference: one of identifier data-reference '[' index [ ,index ]... ']' data-reference.identifier data-reference^ index: expression [ :expression ] Pascal Expressions expression: simple-exp [ rel-op simple-exp ]... rel-op: one of = < <> > <= >= simple-exp: [ + | - ] term [ add-op term ]...
Parameters for TAL TAL Scope Units and Scope Paths scope-path: #procedure TAL Code Locations code-location: { scope-path } [ code-offset ] { [ scope-path. ] code-reference } code-reference: one of procedure subproc [ subproc. ] label [ subproc. ] entry-point statement-number #line-number [ (source-file) ] code-offset: { + | - } num [ code-unit ] code-unit: one of INSTRUCTION[S] TAL Data Locations STATEMENT[S] data-location: [ [ [ [ scope-path [ (instance) ] . ] [ scope-path.
Inspect Reference Summary Parameters for TAL TAL Expressions expression: condition [ { AND | OR } condition ]... condition: [ NOT ] simple-exp [ rel-op simple-exp ]... rel-op: < '<' one of <= '<=' = '=' >= '>=' > '>' <> '<>' simple-exp: [ + | - ] term [ add-op term ]... add-op: + LOR one of LAND '+' XOR '-' term: factor [ mult-op factor ]... mult-op: * << one of factor: / >> '*' '<<' '/' '>>' '\' one of primary primary. primary: one of data-location .