%ì Librarian I01-42|ÿÛ¹»øµ¬tܹ»øµ½ô¾5Q DEBUG  ­¬tܹ»øµ1 DEBUG> The Debugger Command Dictionary contains detailed referenceA information about all debugger commands, organized as follows:= o Command Format explains how to enter debugger commands.= o Commands Disabled in DECwindows lists commands that are: disabled in the command entry view of the debugger's! DECwindows Motif interface.B o Messages gives general information about debugger diagnostic= messages. Debugger Command Dictionary contains detailed8 reference information about the debugger commands. 2 Address_Expressions@ Several debugger commands require that you specify an address@ expression. An address expression is an entity that denotes a? memory address or a register. Commands for which you specify address expressions are:, (SET,ACTIVATE,DEACTIVATE,CANCEL) BREAK, (SET,ACTIVATE,DEACTIVATE,CANCEL) TRACE, (SET,ACTIVATE,DEACTIVATE,CANCEL) WATCH EVALUATE/ADDRESS EXAMINE- DEPOSIT (at the left of the equal sign)C In general, you can specify address expressions using the syntax. of the currently set language. For example:" DBG> EXAMINE A(1) ! FORTRAN! DBG> SET WATCH A[1] ! Pascal DBG> EXAMINE C OF R ! COBOLD In addition, you can specify address expressions numerically, andB you can also use the built-in symbols %LINE and %LABEL to refer to code locations: DBG> EXAMINE 512 DBG> SET BREAK %LINE 10@ You can also use the following operators to specify addresses< that you might not be able to access by name (nonsymbolic addresses): + - * Arithmetic operators / @ or . Indirection Select bit field> For example, examine the instruction 3 bytes after line 10: DBG> EXAMINE %LINE 10 + 3( Examine the location pointed to by P: DBG> EXAMINE @PC Do not confuse an address expression with a language expression,< which denotes a value rather  than a program location. TheD following examples show how the same command parameter is treated> either as an address expression or as a language expression depending on the command:; Show the address of the variable X (address expression): DBG> EVALUATE/ADDR X 5124 Show the current value of X (address expression): DBG> EXAMINE X X: 0$ Evaluate X (language expression): DBG> EVALUATE X 0& Evaluate X+1 (language expression): DBG> EVALUATE X+1 1!= Show value at location X plus 1 byte (address expression): DBG> EXAMINE X+1 513: 0 53 Using_Symbols_and_Operators_in_Address_ExpressionsD The symbols and operators that can be used in address expressions? are listed below. A unary operator has one operand. A binary operator has two operands. Symbol DescriptionC %LABEL Specifies that the numeric literal that followsB is a program label (for languages like FORTRAN>" that have numeric program labels). You canB qualify the label with a path name prefix that4 specifies the containing module.C %LINE Specifies that the numeric literal that follows= is a line number in your program. You canC qualify the line number with a path name prefix9 that specifies the containing module.? Backslash (\) When used within a path name, delimi #ts eachB element of the path name. In this context, theC backslash cannot be the leftmost element of the' complete path name.B When used as the prefix to a symbol, specifiesD that the symbol is to be interpreted as a globalB symbol. In this context, the backslash must beA the leftmost element of the symbol's complete path name.B At si$gn (@) Unary operators. In an address expression, theA Period (.) at sign (@) and period (.) each function as? a "contents-of" operator. The "contents-of"D operator causes its operand to be interpreted asC a memory address and thus requests the contents; of (or value residing at) that address.; Bit field Unary operator. You can apply bit fieldA selection to an address-expr %ession. To select@ a bit field, you supply a bit offset (p), aB bit length (s), and a sign extension bit (e),& which is optional.B Plus sign (+) Unary or binary operator. As a unary operator,A indicates the unchanged value of its operand.D As a binary operator, adds the preceding operand4 and succeeding operand together.B Minus sign (-) Unary or binary operator. As a u &nary operator,> indicates the negation of the value of its@ operand. As a binary operator, subtracts theB succeeding operand from the preceding operand.= Multiplication Binary operator. Multiplies the preceding6 sign (*) operand by the succeeding operand.B Division sign Binary operator. Divides the preceding operand. (/) by the succeeding operand.D The following examples illustrate the use of built-'in symbols and$ operators in address expressions. 4 %LINE_and_%LABEL_OperatorsC The following command sets a tracepoint at line 26 of the module- in which execution is currently suspended: DBG> SET TRACE %LINE 26A The next command displays the source line associated with line 47: DBG> EXAMINE/SOURCE %LINE 47 module MAIN2 47: procedure SWAP(X,Y: in out INTEGER) is DBG>A The next command sets a breakpoint at label 10 of module MOD4: ( DBG> SET BREAK MOD4\%LABEL 10 4 Path_Name_OperatorsA The following command displays the value of the variable COUNTB that is declared in routine ROUT2 of module MOD4. The backslash= (\) path name delimiter separates the path name elements: DBG> EXAMINE MOD4\ROUT2\COUNT MOD4\ROUT2\COUNT: 12 DBG>C The following command sets a breakpoint on line 26 of the module QUEUMAN:" DBG> SET BREAK QUEUMAN\%LINE 26C The following command displays the value of) the global symbol X: DBG> EXAMINE \X 4 Arithmetic_Operators? The order in which the debugger evaluates the elements of anA address expression is similar to that used by most programming< languages. The order is determined by the following threeB factors, listed in decreasing order of precedence (first listed have higher precedence):@ 1. The use of delimiters (usually parentheses or brackets) to. group operands with particular operators: 2. The assign*ment of relative priority to each operator) 3. Left-to-right priority of operators; The debugger operators are listed in decreasing order of precedence as follows:, 1. Unary operators ((.), (@), (+), (-))7 2. Multiplication and division operators ((*), (/))4 3. Addition and subtraction operators ((+), (-))= For example, when evaluating the following expression, theD debugger first adds the operands within parentheses, then divides5 the result by 4, then+ subtracts the result from 5. 5-(T+5)/4C The following command displays the value contained in the memory location X + 4 bytes: DBG> EXAMINE X + 4 4 Contents-of_Operator; The following examples illustrate use of the contents-of@ operator. In the next example, the instruction at the currentC PC value is obtained (the instruction whose address is contained, in the PC and which is about to execute): DBG> EXAMINE .%PC MOD\%LINE 5: PUSHL S^#8 D,BG>A In the next example, the source line at the PC value one levelA down the call stack is obtained (at the call to routine SWAP): DBG> EXAMINE/SOURCE .1\%PC module MAIN! MAIN\%LINE 134: SWAP(X,Y); DBG>B For the next example, assume that the value of pointer variableA PTR is 7FF00000 hexadecimal, the address of an entity that youC want to examine. Assume further that the value of this entity isC 3FF00000 hexadecimal. The following command shows how t-o examine the entity: DBG> EXAMINE/LONG .PTR 7FF00000: 3FF00000 DBG> 4 Bit-Field_OperatorA The following example shows how to use the bit-field operator.A For example, to examine the address expression X_NAME startingD at bit 3 with a length of 4 bits and no sign extension, you would enter the following command: DBG> EXAMINE X_NAME <3,4,0> 2 Built_in_Symbols? The debugger built-in symbols provide options for specifying@ program entit.ies and values in debugger commands, as follows: Function SymbolsA Specify %Rn, %R31, %AP, %FP, %SP, %PC, %PSL, %Vn, %VCR,' Alpha %VLR, %VMR, %Fn, %F31 and VAX registersD Specify %ARn, %Bn, %CRn, %Fn, %IPn, %IR0, %PRED, %Pn, %Rn, Itanium[R] %SR registers. %LANGUAGE Specify the current language' %NAME Construct identifiers? %PARCNT Count parameters passed in command procedures %BIN, %DEC,/ Control radix %HEX, %OCT? %CURLOC, Specify consecutive program locations and the, %NEXTLOC, current value of an entity %PREVLOC, %CURVAL9 %LABEL, Specify numeric labels and line numbers %LINE@ %ADDR, Specify the argument passing mechanism for the %DESCR, CALL command %REF, %VAL? Specify %ADAEXC_NAME, %EXC_FACILITY, %EXC_NAME, %EXC_B processes, NUM, %EXC_SEVERITY, %PROCESS_NAME, %PROCESS_PID,D tas 0ks, or %PROCESS_NUMBER, %NEXT_PROCESS, %PREVIOUS_PROCESS,? information %VISIBLE_PROCESS, %ACTIVE_TASK, %CALLER_TASK,2 about %NEXT_TASK, %TASK. %VISIBLE_TASK exceptionsC Specify %PAGE, %WIDTH, %DECWINDOWS, %CURDISP, %CURSCROLL,A information %NEXTDISP, %NEXTINST, %NEXTOUTPUT, %NEXTSCROLL,D about the %NEXTSOURCE, %SOURCE_SCOPE, %INST_SCOPE, %CURRENT_B interface SCOPE_ENTRY, %NEXT_SCOPE_ENTRY, %PREVIOUS_SCOPE_ ENTRY 13 %ARnA On I64 systems, specifies the following application registers: Register Symbol Definition" %AR0 . . . Kernel registers %AR7. %AR16 Register Stack Configuration' %AR17 Backing Store Pointer9 %AR18 Backing Store Pointer for Memory Stores$ %AR19 RSE NaT Collection4 %AR32 Compare and Exchange Compare Value% %AR36 User NaT Collection' %AR40 Floating=point Status) %AR642 Previous Function State %AR65 Loop Count %AR66 Epilog Count 3 %AP> On VAX systems, specifies the VAX argument pointer register (%R12). 3 %BnA On I64 systems, specifies branch registers %B0 through %B7, as follows: Register Symbol Definition3 %B0 Branch register 0; return pointer) %B1 . . . %B7 Branch registers 1 to 7 3 %CRnB On I64 systems, specifies control registers %CR0 through 3%CR81, as follows: Register Symbol Definition! %CR0 Default control1 %CR1 Interval timer match (SCD only)8 %CR2 Interruption vector address (SCD only)/ %CR8 Page table address (SCD only)/ %CR16,%IPSR Interruption processor status% %CR17 Interruption status2 %CR19 Interruption instruction pointer/ %CR20 Interruption faulting address, %CR21 Interruption TLB insertion3 4 %CR22 Interruption instruction previous- %CR23 Interruption function state( %CR24 Interruption immediate+ %CR25 Interruption hash address/ %CR64 Local interrupt ID (SCD only)* %CR66 Task priority (SCD only)> %CR68 - External interrupt request 0 to 3 (SCD only) %CR71+ %CR72 Interval timer (SCD only)3 %CR73 Performance monitoring (SCD only); %CR74 Corrected machine check vector5 (SCD only)6 %CR80 . . . Local redirection 0 and 1 (SCD only) %CR81 3 %FnA On Alpha systems, specifies the Alpha floating-point registersB %F0 through %F30. On I64 systems, specifies IEEE floating-point registers %F0 through %F127. 3 %F31A On Alpha systems, specifies the ReadAsZero/Sink floating-pointB register. This register is permanently assigned the value zero. 3 %FPC On VAX systems, specifies the VAX frame pointer register (%R13).B On 6Alpha systems, specifies the Alpha stack frame base register (%R29). 3 %GP? On I64 systems, specifies general registers R0 through R127. 3 %IP? On I64 systems, specifies a special register for the programB counter (i.e., Instruction pointer; slot number). Equivlient to %PC. 3 %PnD On I64 systems, specifies a predicate (single-bit) registers 0 to 63. 3 %PC? On VAX or Alpha, specifies the program counter (PC) registerC containing the addr7ess of the next instruction to be executed byB the processor. On I64, specifies the instruction bundle addressB (from the %IP register) and the slot offset within this bundle. VAX Examples:3 DBG> EXAMINE %PC ! Display the value in the PC MOD3\%PC: 1554, ! address of next instruction to executeB DBG> EXAMINE %PC ! Display the value at the address in the PC& MOD3\%LINE 12: MOVL B^12(R11),R13 ! next instruction to execute 3 %PREDD8 On I64 systems, specifies a 64-bit predicate collection register,D PRED, representing predicate registers P0 through P63. Individual> predicate registers can be examined using the syntax in the following example: PRn,1,0+ where n is the predicate register number 3 %PSC On Alpha systems, specifies the Alpha processor status register. 3 %PSL? On VAX systems, specifies the VAX processor status longword. 3 %RnB On VAX systems, specifies the VAX9 general purpose registers %R0> through %R11. On Alpha systems, specifies the Alpha integer@ registers %R0 through %R28. On I64 systems, specifies integer+ registers %R0 through %R127, as follows: Register Symbol Definition, %R0 General integer register 0% %R1 (%GP) Global Data Pointer3 %R2 . . . %R11 General integer registers 2 to 11 %R12 Stack Pointer %R13 Thread Pointer4 %R14 . . . General integer register:s 14 to 24 %R24& %R25 Argument informationD %R26 . . . General integer registers 26 to 127 (%R32 to %R1275 %R127 may or may not be allocated/active) Example: DBG> DEPOSIT %R1 = 23 3 %R31A On Alpha systems, specifies the ReadAsZero/Sink register. This3 register is permanently assigned the value zero. 3 %SPC On VAX systems, specifies the VAX stack pointer register (%R14).? On Alpha systems, specifies the Alpha stack point;er registerC (%R30). On I64 systems, specifies the I64 stack pointer register (%R12). 3 %SR9 On I64 systems, specifies the invocation handle (%IH). 3 %VnA On VAX systems, specifies the VAX vector registers %V0 through %V15. 3 %VLRC On VAX systems, specifies the VAX vector length register (%VLR).B The VLR limits the highest element of a vector register that is% processed by a vector instruction. 3 %VMRA On VAX systems, specifies the V <AX vector mask register (%VMR).9 The VMR specifies a mask (a bit pattern) that a vector@ instruction uses in order to operate on only certain elements of a vector register operand. 3 %LANGUAGE> Specifies the current language. The current language is the> language last established with the SET LANGUAGE command. BYD default, if you did not enter a SET LANGUAGE command, the current= language is the language of the module containing the main$ program (image transfer add=ress). Example: DBG> EVALUATE %LANGUAGE 'FORTRAN' DBG> SET LANGUAGE ADA DBG> EVALUATE %LANGUAGE "ADA" 3 %NAMED Enables you to constuct identifiers that are not ordinarily legal in the current language. Format: %NAME id-char-string %NAME 'any-char-string' Examples:; DBG> EXAMINE %NAME 12 ! Examine variable nameD '12'= DBG> EXAMINE %NAME 'P.AAA' ! Examine generated label P.AAA 3 %PARCNTC Specifies the number of > actual parameters to the current command? procedure. Use %PARCNT in command procedures that can take aA variable number of actual parameters. You can use %PARCNT onlyA inside command procedures; it is not defined when commands are entered from the terminal.B For example, suppose the command procedure ABC is executed withA the command @ABC 111,222,333. Inside ABC, %PARCNT then has the@ value 3 because there are three parameters on this particular call to ABC. E?xample: EVALUATE %PARCNT8 FOR I = 1 TO %PARCNT DO (DECLARE X:VALUE; EVALUATE X) 3 %BIN= Specifies that a following numeric literal (or all numericC literals in a following parenthesized expression) be interpreted in binary radix. Examples: DBG> EVALUATE/DEC %BIN 10 2# DBG> EVALUATE/DEC %BIN (10 + 10) 4 3 %DEC= Specifies that a following numeric literal (or all numericC literals in a following parenthesized expression) be interpre@ted in decimal radix. Examples: DBG> EVALUATE/HEX %DEC 10 0A( DBG> DBG> EVALUATE/HEX %DEC (10 + 10) 14 3 %HEX= Specifies that a following numeric literal (or all numericC literals in a following parenthesized expression) be interpreted in hexadecimal radix. Examples: DBG> EVALUATE/HEX %DEC 10 16# DBG> EVALUATE/DEC %HEX (10 + 10) 32 3 %OCT= Specifies that a following numeric literal (or all numericC literals inA a following parenthesized expression) be interpreted in octal radix. Examples: DBG> EVALUATE/DEC %OCT 10 8# DBG> EVALUATE/DEC %OCT (10 + 10) 16 3 %CURLOC= Specifies the current logical entity (that is, the program6 location last referenced by an EXAMINE, DEPOSIT, orC EVALUATE/ADDRESS command). You can also use the period character (.) for this purpose. Example: DBG> EXAMINE RADIUS CIRCLE\RADIUS: 0.0000000E+00/ DBG> DEPOSIT %CBURLOC = 1 ! Set RADIUS to 1/ DBG> DEPOSIT . = 2 ! Set RADIUS to 2 3 %NEXTLOCB Specifies the logical successor of the current entity (that is,@ the program location that logically follows the location lastC referenced by an EXAMINE, DEPOSIT, or EVALUATE/ADDRESS command).C The EXAMINE command without a parameter is equivalent to EXAMINE %NEXTLOC. Example: DBG> EXAMINE PRIMES(4) SIEVE\PRIMES(4): 7 DBG> EXAMINE %NEXTLOC SIEVE\PRIMES(5): C113 DBG> EXAMINE ! Equivalent to EXAMINE %NEXTLOC SIEVE\PRIMES(6): 13 3 %PREVLOCD Specifies the logical predecessor of the current entity (that is,A the program location that logically precedes the location lastC referenced by an EXAMINE, DEPOSIT, or EVALUATE/ADDRESS command).C You can also use the circumflex character (^) for this purpose. Examples: DBG> EXAMINE PRIMES(6) SIEVE\PRIMES(6): 13 DBG> EXAMINE %PREVLOC SIEVE\PRIMES(5): 113 D DBG> EXAMINE ^ ! Equivalent to EXAMINE %PREVLOC SIEVE\PRIMES(4): 7 3 %CURVAL? Specifies the value last displayed by an EVALUATE or EXAMINEC command, or deposited by a DEPOSIT command. You can also use theC backslash character (\) for this purpose. These two symbols are/ not affected by an EVALUATE/ADDRESS command. Example: DBG> EXAMINE RADIUS CIRCLE\RADIUS: 0.0000000E+00 DBG> EVALUATE %CURVAL 0.0000000E+00 3 %LABELC %LABEL n is theE debugger syntax for referring to label n in yourB program. This is intended for languages like FORTRAN which haveD numeric program labels. You can qualify the label with a pathname$ specifying the containing module. Example:& DBG> SET BREAK MODULENAME\%LABEL 10? The old syntax of %LABEL MODULENAME\n is no longer accepted. 3 %LINE< %LINE n is the debugger syntax for referring to line n in@ your program. You can qualify the line number with a pathname$ speciFfying the containing module. Example:% DBG> SET BREAK MODULENAME\%LINE 10> The old syntax of %LINE MODULENAME\n is no longer accepted. 3 %PAGEC Specifies the current height of the screen, in lines, as used by the debbuger.B For example, the following command defines a screen mode window? named MIDDLE that occupies a region around the middle of the screen: DBG> SET WINDOW MIDDLE AT -, _DBG> (%PAGE/4,%PAGE/2,%WIDTH/4,%WIDTH/2) 3 %WIDTHD G Specifies the current width of the screen, in columns, as used by the debugger.B For example, the following command defines a screen mode window? named MIDDLE that occupies a region around the middle of the screen: DBG> SET WINDOW MIDDLE AT -, _DBG> (%PAGE/4,%PAGE/2,%WIDTH/4,%WIDTH/2) 3 %DECWINDOWS@ Enables you to determine whether you are using the debugger's< command interface or DECwindows Motif interface. With theD DECwindows Motif interface, the value oHf %DECWINDOWS is 1 (TRUE).C With the command interface, the value is 0 (FALSE). For example: DBG> EVALUATE %DECWINDOWS 0C The following example shows how to use %DECWINDOWS in a debuggerC initialization file to position the debugger source window, SRC, at debugger startup: IF %DECWINDOWS THEN. ! DECwindows Motif (workstation) syntax:( (DISPLAY SRC AT (100,300,100,700)) ELSE& ! Screen-mode (terminal) syntax: (DISPLAY SRC AT (AT H1)) I3 %ADDR@ (Default.) Used with the CALL command to specify the argumentB passing mechanism. The %ADDR symbol specifies that the argument. is passed by address. See the CALL command. 3 %DESCR= Used with the CALL command to specify the argument passing> mechanism. The %DESCR symbol specifies that the argument is. passed by descriptor. See the CALL command. 3 %REF= Used with the CALL command to specify the argument passingC mechanism. The %REF symbol specifieJs that the argument is passed& by reference. See the CALL command. 3 %VAL= Used with the CALL command to specify the argument passingC mechanism. The %VAL symbol specifies that the argument is passed" by value. See the CALL command. 3 %CURDISPC Specifies the current display (screen mode). This is the display@ most recently referenced with a DISPLAY command (that is, the least occluded display.) Example: DBG> SELECT/SCROLL %CURDISP 3 %CUKRSCROLLA Specifies the current (screen mode) scrolling display. This isD the default display for the SCROLL, MOVE, and EXPAND commands, asC well as for the associated keypad keys (KP2, KP4, KP6, and KP8). Example: DBG> EXPAND/DOWN:5 %CURSCROLL 3 %NEXTDISP> Specifies the next display after the current display in the< screen-mode display list. The next display is the display@ that follows the topmost display. Because the display list is@ circular, this is theL display at the bottom of the pasteboard (the most occluded display). Example: DBG> DISPLAY/POP %NEXTDISP 3 %NEXTINST; Specifies the next instruction display after the currentC instruction display in the screen-mode display list. The currentC instruction display is the display that receives the output from EXAMINE/INSTRUCTION commands. Example: DBG> DISPLAY/REMOVE %NEXTINST 3 %NEXTOUTPUT= Specifies the next output display after the curMrent output= display in the screen-mode display list. An output displayC receives debugger output that is not already directed to another display. Example:$ DBG> EXTRACT %NEXTOUTPUT OUT4.TXT 3 %NEXTSCROLLD Specifies the next display after the current scrolling display in the screen-mode display list. Example:! DBG> SELECT/SCROLL %NEXTSCROLL 3 %NEXTSOURCE= Specifies the next source display after the current source> display in the screNen-mode display list. The current sourceA display is the display which receives the output from TYPE and EXAMINE/SOURCE commands. Example:! DBG> SELECT/SOURCE %NEXTSOURCE 3 %SOURCE_SCOPED Specifies the scope, relative to the call stack, for which sourceD code is displayed in a screen-mode source display. If source codeD is not available for display in that scope, the debugger displaysB source code for the next level down the call stack for which it is avaiOlable.< The %SOURCE_SCOPE symbol is used in the definition of the- predefined screen-mode source display SRC:" DBG> DISPLAY SRC AT H1 SOURCE -, _DBG> (EXAMINE/SOURCE .%SOURCE_SCOPE\%PC) 3 %INST_SCOPE= Specifies the scope, relative to the call stack, for whichB decoded instructions are displayed in a screen-mode instruction display.: The %INST_SCOPE symbol is used in the definition of the3 predefined screen-mode instruction display INST:( DBG> DISPLAY PINST AT H1 INSTRUCTION -( _DBG> (EXAMINE/INST .%INST_SCOPE\%PC) 3 %CURRENT_SCOPE_ENTRYC Specifies the call frame that the debugger is currently using asD reference when displaying source code or decoded instructions, or@ when searching for symbols. By default, this is call frame 0.@ The %CURRENT_SCOPE_ENTRY symbol returns an integer value that? denotes a call frame on the call stack. Call frame 0 denotes? the routine at the top of the call stack, where execution isBQ suspended. Call frame 1 denotes the calling routine, and so on. 3 %NEXT_SCOPE_ENTRYC Specifies the next frame down the call stack from the call frame# denoted by %CURRENT_SCOPE_ENTRY.= The %NEXT_SCOPE_ENTRY symbol returns an integer value that? denotes a call frame on the call stack. Call frame 0 denotes? the routine at the top of the call stack, where execution isB suspended. Call frame 1 denotes the calling routine, and so on. 3 %PREVIOUS_SCOPE_ENTRYA SRpecifies the next frame up the call stack from the call frame# denoted by %CURRENT_SCOPE_ENTRY.A The %PREVIOUS_SCOPE_ENTRY symbol returns an integer value that? denotes a call frame on the call stack. Call frame 0 denotes? the routine at the top of the call stack, where execution isB suspended. Call frame 1 denotes the calling routine, and so on. 3 %PROCESS_NAME: Applies to a multiprocess debugging configuration (when+ DBG$PROCESS has the value MULTIPROCESS).C S When specifying a process name in a debugger command string, youA can optionally precede the name with the symbol %PROCESS_NAME. Example:$ DBG_2> EXIT %PROCESS_NAME JONES_4 3 %PROCESS_PID: Applies to a multiprocess debugging configuration (when+ DBG$PROCESS has the value MULTIPROCESS).= When specifying a process identification number (PID) in aD debugger command string, you must precede the PID with the symbol %PROCESS_PID. Example:' DBG_2> COTNNECT %PROCESS_PID 258001B6 3 %PROCESS_NUMBER: Applies to a multiprocess debugging configuration (when+ DBG$PROCESS has the value MULTIPROCESS).C When specifying a debugger-assigned process number in a debuggerC command string, you must precede the number with %PROCESS_NUMBER (or the abbreviation %PROC). Example: DBG_2> SHOW PROCESS %PROC 3 3 %NEXT_PROCESS: Applies to a multiprocess debugging configuration (when> DBG$PROCESS has the value MULTIUPROCESS). Specifies the nextD process in the debugger's process list after the visible process. Example:( DBG_3> SET PROCESS/HOLD %NEXT_PROCESS 3 %PREVIOUS_PROCESS: Applies to a multiprocess debugging configuration (whenB DBG$PROCESS has the value MULTIPROCESS). Specifies the previous< process in the debugger's process list before the visible process. Example:- DBG_3> SHOW PROCESS/FULL %PREVIOUS_PROCESS 3 %VISIBLE_PROCESS: Applies to a multViprocess debugging configuration (whenA DBG$PROCESS has the value MULTIPROCESS). Specifies the visible> process. This is the process whose stack, register set, andB images are the current context for looking up symbols, register1 values, routine calls, breakpoints, and so on. Example:7 DBG_2> DO/PROCESS=(%VISIBLE_PROCESS,%NEXT_PROCESS) - _DBG_2> (EXAMINE X) 3 %ADAEXC_NAME; A special form of %EXC_NAME for ADA programs. In ADA, an? exception can be raised wWith syntax such as "raise XXX;". InA this case, the exception name in the operating system sense is@ just "EXCEPTION," which is what %E returns. The ADA exception, name ("XXX") is returned by %ADAEXC_NAME. Example:" DBG> SET BREAK/EXCEPTION WHEN - _DBG> (%ADAEXC_NAME = "XXX") 3 %EXC_FACILITYC Gives you the facility of the current exception. This provides a& way of qualifying exception breaks. Example: DBG> EVALUATE %EXC_FACILITY "SYSTEM" X DBG> SET BREAK/EXC WHEN - _DBG> (%EXC_FAC = "SYSTEM") 3 %EXC_NAMEC Gives you the name of the current exception. This provides a way" of qualifying exception breaks. Example: DBG> EVALUATE %EXC_NAME "FLTDIV_F"3 DBG> SET BREAK/EXC WHEN (%EXC_NAME = "FLTDIV_F") 3 %EXC_NUMA Gives you the current exception number. This provides a way of qualifying exception breaks. Example: DBG> EVALUATE %EXC_NUM 12 DBG> EVALUATE/COND %EXC_NYUM0 %SYSTEM-F-ACCVIO, access violation at PC !XL, virtual address !XL* DBG> SET BREAK/EXC WHEN (%EXC_NUM = 12) 3 %EXC_SEVERITY= Gives you the severity code of the current exception. This1 provides a way of qualifying exception breaks. Example: DBG> EVALUATE %EXC_SEVERITY "F"0 DBG> >U>(SET BREAK/EXC WHEN (%EXC_SEV = "F")) 3 %ACTIVE_TASK> (Applies only to tasking programs.) Gives you the currently? active task (the one that was running wZhen the debugger last2 took control). See the SET TASK/ACTIVE command. Example: DBG> EVALUATE %ACTIVE_TASK %TASK 2 3 %CALLER_TASKC (Applies only to Ada tasking programs.) Gives you the task whichC is the entry caller of the active task during a task rendezvous.? If the active task (%ACTIVE_TASK) is not currently executingB an accept statement (that is, a rendezvous is not in progress), %CALLER_TASK returns %TASK 0. Example:; The following[ command sets a breakpoint within an acceptB statement. The breakpoint is triggered only when %TASK 3 is the0 task making the entry call of the rendezvous. DBG> TYPE 51:53 module SAMPLE' 51: accept RENDEZVOUS do; 52: PUT_LINE("Beginning the rendezvous");" 53: end RENDEZVOUS;8 DBG> SET BREAK %LINE 52 WHEN (%CALLER_TASK = %TASK 3) 3 %NEXT_TASKD (Applies only to tasking programs.) Gives you the next task afterD the one c\urrently visible (%VISIBLE_TASK). "Next" in this contextB is just an internal ordering that cycles through all the tasks.A This lets you set up command procedures that cycle through all tasks. Example:$ DBG> WHILE %NEXT NEQ %ACTIVE DO -% _DBG> (SET TASK %NEXT; SHOW CALLS) 3 %TASK& (Applies only to tasking programs.)B %TASK n (where n is a positive decimal integer) is the debugger@ syntax for referring to a task by its task ID. The task ID is> a unique ]number associated with a task at the time the task? is created. The task number n can be obtained using the SHOW1 TASK/ALL command or by examining task objects. Example: DBG> EXAMINE T1 T1: %TASK 2 DBG> SET TASK %TASK 2 3 %VISIBLE_TASKB (Applies only to tasking programs.) Gives you the task that theC debugger is using to do symbol lookups. This is the default taskD assumed by debugging commands when you do not (or cannot) specifyC a task. For example, ^the EXAMINE %R0 command displays register 0 of the visible task.? This is normally the same as %ACTIVE_TASK but can be changed using the SET TASK command. Example: DBG> SET TASK %TASK 2 DBG> EVALUATE %VISIBLE %TASK 2 2 Command_FormatC You can enter debugger commands interactively at the keyboard orB store them within a command procedure to be executed later with% the @ (Execute Procedure) command. 3 General_Rules? A command string is_ the complete specification of a debugger@ command. Although you can continue a command on more than oneD line, the term command string is used to define an entire command" that is passed to the debugger.> A debugger command string consists of a verb and, possibly, parameters and qualifiers.? The verb specifies the command to be executed. Some debuggerC command strings might consist of only a verb or a verb pair. For example: DBG> GO DBG> SHOW IMAGEC A ` parameter specifies what the verb acts on (for example, a file? specification). A qualifier describes or modifies the actionD taken by the verb. Some command strings might include one or moreA parameters or qualifiers. In the following examples, COUNT, I,B J, and K, OUT2, and PROG4.COM are parameters (@ is the "execute; procedure" command); /SCROLL and /OUTPUT are qualifiers. DBG> SET WATCH COUNT DBG> EXAMINE I,J,K! DBG> SELECT/SCROLL/OUTPUT OUT2 DBG> @PROG4.COM aC Some commands accept optional WHEN or DO clauses. DO clauses are0 also used in some screen display definitions.; A WHEN clause consists of the keyword WHEN followed by a@ conditional expression (within parentheses) that evaluates to> true or false in the current language. A DO clause consists< of the keyword DO followed by one or more command stringsA (within parentheses) that are to be executed in the order that> they are listed. You must separate multiple command str bingsA with semicolons (;). These points are illustrated in the next example.B The following command string sets a breakpoint on routine SWAP.? The breakpoint is triggered whenever the value of J equals 4C during execution. When the breakpoint is triggered, the debugger? executes the two commands SHOW CALLS and EXAMINE I,K, in the order indicated.@ DBG> SET BREAK SWAP WHEN (J = 4) DO (SHOW CALLS; EXAMINE I,K)@ The debugger checks the syntax of the commands in a c DO clauseB when it executes the DO clause. You can nest commands within DO clauses. 3 Interactive_Input_RulesB When entering a debugger command interactively at the keyboard,B you can abbreviate a keyword (verb, qualifier, parameter) to asC few characters as are needed to make it unique within the set ofC all debugger keywords. However, some commonly used commands (forC example, EXAMINE, DEPOSIT, GO, STEP) can be abbreviated to theirA first characters. Also, in so dme cases, the debugger interprets= nonunique abbreviations correctly on the basis of context.? Pressing the Return key terminates the current line, causing@ the debugger to process it. To continue a long command stringA on another line, type a hyphen (-) before pressing Return. As? a result, the debugger prompt is prefixed with an underscoreA character (_DBG>), indicating that the command string is still being accepted.< You can enter more than one command string on e one line by2 separating command strings with semicolons (;).B To enter a comment (explanatory text recorded in a debugger logC file but otherwise ignored by the debugger), precede the comment? text with an exclamation point (!). If the comment wraps to; another line, start that line with an exclamation point.? The command line editing functions that are available at theC DCL prompt ($) are also available at the debugger prompt (DBG>),B including command recall with t fhe up arrow and down arrow keys.B For example, pressing the left arrow and right arrow keys moves@ the cursor one character to the left and right, respectively;= pressing Ctrl/H or Ctrl/E moves the cursor to the start orA end of the line, respectively; pressing Ctrl/U deletes all the3 characters to the left of the cursor, and so on.B To interrupt a command that is being processed by the debugger,( press Ctrl/C. See the Ctrl/C command. 3 Command_Procedure_Rules? To gmaximize legibility, it is best not to abbreviate command= keywords in a command procedure. Do not abbreviate commandB keywords to less than four significant characters (not countingC the negation /NO . . . ), to avoid potential conflicts in future releases.D Start a debugger command line at the left margin. (Do not start aD command line with a dollar sign ($) as you do when writing a DCL command procedure).B The beginning of a new line ends the previous command line h(theA end-of-file character also ends the previous command line). To? continue a command string on another line, type a hyphen (-) before starting the new line.< You can enter more than one command string on one line by2 separating command strings with semicolons (;).@ To enter a comment (explanatory text that does not affect the@ execution of the command procedure), precede the comment textB with an exclamation point (!). If the comment wraps to another3 line, starti that line with an exclamation point. 2 Command_Summary? The additional topics list all the debugger commands and anyA related DCL commands in functional groupings, along with brief descriptions. *3 Starting_and_Ending_a_Debugging_Session? The following commands are used to start the debugger, bring< a program under debugger control, and interrupt and end aA debugging session. Except where the DCL RUN and DEBUG commandsB are indicated specifically, all command js are debugger commands.- DEBUG/KEEP (DCL RUN Starts the debugger command)A RUN program-image Brings a program under debugger control< RERUN Reruns the program currently under* debugger controlA RUN program-image If the specified image was linked usingB (DCL RUN command) LINK/DEBUG, starts the debugger and alsoB brings the image under debugger control.= When you sta krt the debugger in thisB manner, you cannot then use the debugger@ RUN or RERUN commands. You can use theD /[NO]DEBUG qualifiers with the RUN commandD to control whether the debugger is started7 when the program is executed.A EXIT, Ctrl/Z Ends a debugging session, executing all' exit handlersD QUIT Ends a debug lging session without executingC any exit handlers declared in the program@ Ctrl/C Aborts program execution or a debuggerD command without interrupting the debugging! sessionB (SET,SHOW) ABORT_KEY (Assigns, identifies) the default Ctrl/C< abort function to another Ctrl-keyD sequence, identifies the Ctrl-key sequenceB curren mtly defined for the abort function> Ctrl/Y-DEBUG Interrupts a program that is runningA (DCL DEBUG command) without debugger control and starts the" debuggerB ATTACH Passes control of your terminal from the< current process to another process? SPAWN Creates a subprocess, enabling you to? execute DCL commands without ending aD debugging sess nion or losing your debugging! context /3 Controlling_and_Monitoring_Program_ExecutionA The following commands are used to control and monitor program execution:= GO Starts or resumes program executionC STEP Executes the program up to the next line,? instruction, or specified instruction= (SET,SHOW) STEP (Establishes, displays) the default9 qualifie ors for the STEP command? (SET,SHOW,CANCEL) (Sets, displays, cancels) breakpoints BREAKA (ACTIVATE,DEACTIVATE) (Activates, deactivates) previously set% BREAK breakpoints? (SET,SHOW,CANCEL) (Sets, displays, cancels) tracepoints TRACEA (ACTIVATE,DEACTIVATE) (Activates, deactivates) previously set% TRACE tracepoints? (SET,SHOW,CANCEL) (Sets, displays, cancels) watchpoints WATCHA (ACTIVATE,DEACTIVATE) (Activates p, deactivates) previously set% WATCH watchpointsA SHOW CALLS Identifies the currently active routine calls@ SHOW STACK Gives additional information about the8 currently active routine calls) CALL Calls a routine "3 Examining_and_Manipulating_DataB The following commands are used to examine and manipulate data:A EXAMINE Displays the value of a va qriable or the8 contents of a program locationC SET MODE [NO]OPERANDS Controls whether the address and contentsC of the instruction operands are displayed9 when you examine an instruction@ DEPOSIT Changes the value of a variable or the8 contents of a program locationD EVALUATE Evaluates a language or address expressionD MONITOR (Applies onl ry to the debugger's DECwindows@ Motif interface). Displays the currentD value of a variable or language expression? in the Monitor View of the DECwindows* Motif interface. 3 Type_Selection_and_Radix@ The following commands are used to control type selection and radix:? (SET,SHOW,CANCEL) (Establishes, displays, restores) the: RADIX radix for data entry s and display? (SET,SHOW,CANCEL) (Establishes, displays, restores) theA TYPE type for program locations that are notC associated with a compiler-generated type; SET MODE [NO]G_FLOAT Controls whether double-precisionB floating-point constants are interpreted/ as G_FLOAT or D_FLOAT $3 Symbol_Searches_and_SymbolizationA The following commands are used to control symbol searches an td symbolization:: SHOW SYMBOL Displays symbols in your program= (SET,SHOW,CANCEL) Sets a module by loading its symbol@ MODULE information into the debugger's symbolA table, identifies, cancels a set module@ (SET,SHOW,CANCEL) Sets a shareable image by loading data? IMAGE structures into the debugger's symbol@ table, identifies, cancels a set image= SET MODE [NO]DYNAMIC u Controls whether or not modules and@ shareable images are set automatically@ when the debugger interrupts execution? (SET,SHOW,CANCEL) (Establishes, displays, restores) the3 SCOPE scope for symbol searchesA SYMBOLIZE Converts a memory address to a symbolic, address expression@ SET MODE [NO]LINE Controls whether program locations are? displayevd in terms of line numbers or4 routine-name + byte offset@ SET MODE [NO]SYMBOLIC Controls whether program locations are? displayed symbolically or in terms of+ numeric addresses 3 Displaying_Source_CodeC The following commands are used to control the display of source code:7 TYPE Displays lines of source codeB EXAMINE/SOURCE Displays the source code at the location= w specified by the address expressionD SEARCH Searches the source code for the specified string= (SET,SHOW) SEARCH (Establishes, displays) the default; qualifiers for the SEARCH command@ SET STEP [NO]SOURCE Enables/disables the display of source< code after a STEP command has beenB executed or at a breakpoint, tracepoint,' x or watchpointD (SET,SHOW) MARGINS (Establishes, displays) the left and rightD margin settings for displaying source code? (SET,SHOW,CANCEL) (Creates, displays, cancels) a source/ SOURCE directory search list 3 Screen_ModeD The following commands are used to control screen mode and screen displays:6 SET MODE [NO]SCREEN Enables/disables screen mode7 DISPLAY Creates or modifies a display+ y SCROLL Scrolls a display8 EXPAND Expands or contracts a display; MOVE Moves a display across the screen9 (SHOW,CANCEL) DISPLAY (Identifies, deletes) a displayA (SET,SHOW,CANCEL) (Creates, identifies, deletes) a window$ WINDOW definitionC SELECT Selects a display for a display attributeC SHOW SELECT Identifies the displays selected for each3 of the dis zplay attributesA SAVE Saves the current contents of a display. into another display? EXTRACT Saves a display or the current screen+ state into a file> (SET,SHOW) TERMINAL (Establishes, displays) the terminalC screen height and width that the debuggerA uses when it formats displays and other output? SET MODE [NO]SCROLL { Controls whether an output display isB updated line by line or once per command. Ctrl/W Refreshes the screen DISPLAY/REFRESH 3 Editing_Source_CodeC The following commands are used to control source editing from a debugging session:= EDIT Starts an editor during a debugging! session> (SET,SHOW) EDITOR (Establishes, identifies) the editor5 started by t|he EDIT command 3 Defining_SymbolsC The following commands are used to define and delete symbols for" addresses, commands, or values:B DEFINE Defines a symbol as an address, command," or value4 DELETE Deletes symbol definitions= (SET,SHOW) DEFINE (Establishes, displays) the default: qualifier for the DEFINE commandC SHOW SYMBOL/DEFINED Identifies symbols that have been defined1} with the DEFINE command 3 Keypad_ModeA The following commands are used to control keypad mode and key definitions:6 SET MODE [NO]KEYPAD Enables/disables keypad mode1 DEFINE/KEY Creates key definitions1 DELETE/KEY Deletes key definitions> SET KEY Establishes the key definition state2 SHOW KEY Displays key definitions &3 Command__Log__Initialization_Files_B The following comma ~nds are used with command procedures and log files:6 @ (Execute Procedure) Executes a command procedureB (SET,SHOW) ATSIGN (Establishes, displays) the default fileA specification that the debugger uses to7 search for command proceduresD DECLARE Defines parameters to be passed to command$ proceduresB (SET,SHOW) LOG (Specifies, identifies) the debugger log  fileA SET OUTPUT [NO]LOG Controls whether a debugging session is logged? SET OUTPUT Controls whether, in screen mode, theB [NO]SCREEN_LOG screen contents are logged as the screen$ is updated@ SET OUTPUT [NO]VERIFY Controls whether debugger commands are= displayed as a command procedure is" executed? SHOW OUTPUT Identifies the current outpu €t options? established by the SET OUTPUT command 3 Control_Structures? The following commands are used to establish conditional and, looping structures for debugger commands:; FOR Executes a list of commands while1 incrementing a variableC IF Executes a list of commands conditionallyA REPEAT Executes a list of commands a specified) number of times= WHILE Executes a list of commands while a+ condition is trueB EXITLOOP Exits an enclosing WHILE, REPEAT, or FOR loop 3 Multiprocess_ProgramsB The following commands are used to debug multiprocess programs.B Note that these commands are specific to multiprocess programs.: Many of the commands listed under other categories have= qualifiers or parameters that are specific to multipr ‚ocessB programs (for example, SET BREAK/ACTIVATING, EXIT process-spec, DISPLAY/PROCESS=).A CONNECT Brings a process under debugger controlA DISCONNECT Release a process from debugger control> DEFINE/PROCESS_GROUP Assigns a symbolic name to a list of0 process specificationsD DO Executes commands in the context of one or( more processesC SET MODE Controls whether ƒ execution is interruptedA [NO]INTERRUPT in other processes when it is paused in& some process= (SET,SHOW) PROCESS Modifies the multiprocess debuggingC environment, displays process information 3 Additional_Commands> The following commands are used for miscellaneous purposes:C HELP Displays online help on debugger commands- and selected topics= (DISABLE,ENABLE,SHO „W) (Disables, enables) the delivery ofA AST ASTs in the program, identifies whether9 delivery is enabled or disabledD (SET,SHOW) EVENT_ (Establishes, identifies) the current run-C FACILITY time facility for Ada, POSIX Threads, and% SCAN events? (SET,SHOW) LANGUAGE (Establishes, identifies) the current" languageB SET MODE [NO]SEPARATE Controls whether the debugge …r, when usedA on a workstation running VWS, creates a@ separate window for debugger input and outputB SET OUTPUT Controls whether debugger output, exceptB [NO]TERMINAL for diagnostic messages, is displayed or$ suppressed7 SET PROMPT Specifies the debugger promptD (SET,SHOW) TASK Modifies the tasking environment, displays* † task informationD (SET,SHOW) VECTOR_ Enables or disables a debugger vector modeD MODE option, identifies the current vector mode; option (for vectorized programs).B SHOW EXIT_HANDLERS Identifies the exit handlers declared in% the program? SHOW MODE Identifies the current debugger modesB established by the SET MODE command (for: example, scree ‡n mode, step mode)? SHOW OUTPUT Identifies the current output options? established by the SET OUTPUT commandB SYNCHRONIZE VECTOR_ Forces immediate synchronization between? MODE the scalar and vector processors (for. vectorized programs) 2 Debugging_Configurations= You can use the debugger in two configurations, default orA multiprocess. Use the default configuration to debug a programA t ˆhat normally runs (without the debugger) in only one process.= Use the multiprocess configuration to debug a program thatD normally runs in more than one process. The configuration depends= only on the definition of the logical name DBG$PROCESS, as$ indicated in the following table: DBG$PROCESS( Definition: Configuration:! DEFAULT or undefined Default& MULTIPROCESS MultiprocessC Note that the debugging configuration does not depend on whethe ‰rD the program runs in one or several processes. Rather, the currentA definition of DBG$PROCESS determines whether debuggable imagesA running in different processes can be controlled from the same debugging session.C Before starting the debugger, enter the DCL command SHOW LOGICALA DBG$PROCESS to determine the current definition of DBG$PROCESS- and the resulting debugging configuration. 3 Default_ConfigurationA Use the default configuration to debug a program Šthat normally8 runs (without the debugger) in only one process. ThisA configuration is achieved when DBG$PROCESS is either undefined! or has the definition DEFAULT.C In the following example, the output of the SHOW LOGICAL commandA indicates that a default debugging configuration is in effect: $ SHOW LOGICAL DBG$PROCESS> %SHOW-S-NOTRAN, no translation for logical name DBG$PROCESSC If DBG$PROCESS has the value MULTIPROCESS, and you want to debug? a program that ‹runs in only one process, enter the following command: $ DEFINE DBG$PROCESS DEFAULT 3 Multiprocess_Configuration= Use the multiprocess configuration to debug a program that@ normally runs in more than one process. This configuration isD achieved when DBG$PROCESS has the definition MULTIPROCESS, and itD enables you to interact with several processes from one debugging session.B Use the following command to establish a multiprocess debugging configuration Œ:( $ DEFINE/JOB DBG$PROCESS MULTIPROCESS< As shown in this example, when defining DBG$PROCESS for aC multiprocess configuration, use a job logical definition so that@ the definition applies to all processes in that job. An imageC can be connected to (and controlled by) an existing multiprocessD debugging session only if the process running the image is in the9 same job as the process running the debugging session.> Although all processes of a multiprocess configuration must? be in the same job tree, they do not have to be related in a@ particular process/subprocess hierachy. Moreover, the programB images running in separate processes do not have to communicate with each other. 3 Examples( $ DEFINE/JOB DBG$PROCESS MULTIPROCESS $ DEBUG/KEEP0 Debugger Banner and Version Number DBG> RUN PROG1= %DEBUG-I-INITIAL, language is FORTRAN, module set to PROG1> %DEBUG-I-NOTATMAIN, type GO to get to start of main pro Žgram? predefined trace on activation at routine PROG1 in %PROCESS_NUMBER 1 DBG_1>: In this example, the DEFINE/JOB command establishes the? multiprocess configuration and the debugger is then started.= After the program PROG1 is brought under debugger control,? the normal prompt changes to DBG_1>, indicating that this is? a multiprocess debugging configuration and that execution isC suspended in process 1 (the first process that was brought under@ debugger control). Process 1 is currently the visible processB (the context for executing process-specific commands like STEP, EXAMINE, and so on). $ DEFINE DBG$PROCESS DEFAULT $ DEBUG/KEEP0 Debugger Banner and Version Number DBG> RUN FORMS< %DEBUG-I-INITIAL, language is PASCAL, module set to FORMS DBG>> In this example, the DEFINE command establishes the defaultD configuration and the debugger is then started. After the programD FORMS is brought under de bugger control, the prompt remains DBG>,? indicating that this is the default debugging configuration. 3 Process_Relationships< The debugger consists of two parts: A main debugger image= (DEBUGSHR.EXE) that contains most of the debugger code and? a smaller kernel debugger image (DEBUG.EXE). This separation> reduces potential interference between the debugger and the> program being debugged and also makes it possible to have a" multiprocess debugging session.D When ‘you start the debugger, a process is created to run the main debugger.C In a multiprocess debugging session, each program being debuggedB runs in a separate process. Each process that is running one orB more images under debugger control is also running a local copy@ of the kernel debugger. The main debugger, running in its own? process, communicates with the other processes through their kernel debuggers.> Although all processes of a multiprocess session must be in? ’ the same job, they do not have to be related in a particular= process/subprocess hierarchy. Moreover, the program images@ running in separate processes do not have to communicate with each other. 2 DECwindows_InterfaceB The debugger has a DECwindows Motif interface for workstations.? When using this interface, you interact with the debugger by> using a mouse and pointer to choose items from menus, click> on buttons, select names in windows, and so on. The defaultD “ DECwindows interface provides the basic debugging and convenience0 features that you will need most of the time.@ You can customize the DECwindows Motif interface with many ofA the special features of the command interface by modifying theC control-panel buttons and their associated commands or by addingB new buttons. You can customize other DECwindows Motif interface? features by modifying the debugger resource file (DECW$USER_ DEFAULTS:VMSDEBUG.DAT).B Occasionally, y”ou may find you prefer to disable the DECwindows> interface, in order to use the somewhat faster command-line@ interface. If you redefine the DBG$DECW$DISPLAY logical name,D as follows, you can use the debugger command-line interface while6 retaining a windows interface for your application: $ DEFINE DBG$DECW$DISPLAY " "A For complete information about the DECwindows Motif interface,5 see the debugger's DECwindows Motif documentation. 3 InvocationC To invoke the• debugger's DECwindows Motif interface from the DCL- command line, issue the following command: $ DEBUG/KEEP 3 Online_Help? To access online help within the DECwindows Motif interface,> choose one of the following items from the Help menu on the debugger's main window:) o On Context: context-sensitive help.$ o On Window: task-oriented help.& o On Help: how to use online help.4 o On Version: copyright and version information.) o On Command–s: debugger command help.: o On Commands, Messages item: diagnostic message help. 3 DBG$DECW$DISPLAY_Logical_NameA Specifies the debugger interface (DECwindows Motif or command)B or the display device (if you are displaying the interface on a workstation).C By default, DBG$DECW$DISPLAY is either undefined or has the sameD definition as the application-wide logical name DECW$DISPLAY (see help on Logical_Names).A The DECwindows Motif interface is the default o—n workstations.C To display the command interface instead of the DECwindows Motif@ interface, enter the following definition before starting the debugger: $ DEFINE DBG$DECW$DISPLAY " "A For complete information about the DECwindows Motif interface,5 see the debugger's DECwindows Motif documentation. "2 Commands_Disabled_in_DECwindowsC The following commands are disabled in the debugger's DECwindowsA Motif interface. Many of them are relevant only to the comman˜d interface's screen mode. ATTACH SELECT* CANCEL MODE (SET,SHOW) ABORT_KEY$ CANCEL WINDOW (SET,SHOW) KEY( DEFINE/KEY (SET,SHOW) MARGINS) DELETE/KEY SET MODE [NO]KEYPAD) DISPLAY SET MODE [NO]SCREEN) EXAMINE/SOURCE SET MODE [NO]SCROLL- EXPAND SET OUTPUT [NO]TERMINAL) EXTRACT (SET,SHOW) TERMINAL' HELP (SET,SHOW) WINDOW+ MOVE (SHOW,CANCEL) DISPLAY! S™AVE SHOW SELECT SCROLL SPAWN? The debugger issues an error message if you try to enter any? of these disabled commands at the command prompt or when the@ debugger executes a command procedure containing any of these commands.; The MONITOR command works only with the DECwindows Motif9 interface (because the command uses the Monitor View). 2 Keypad_Definitions_CI: This help topic describes the keypad definitions in the: debugger's šcommand interface. For information on keypad? definitions in the graphical user interface (GUI), type HELP Keypad_Definitions_GUI.@ On Digital VT-series terminals and MicroVAX workstations, youA can use the numeric keypad to enter debugger commands providedC you are in "keypad mode." Keypad mode is enabled by default, butC can be disabled and enabled by the SET MODE [NO]KEYPAD commands.B In keypad mode, keypad keys are bound to commonly used debugger@ commands such as ST ›EP, GO and EXAMINE. Most keys are bound to> screen mode commands, to help you manipulate the predefined? screen displays efficiently. Some keys are "terminated": the< corresponding command is executed immediately. Others areA not: you can enter additional parameters to the command before@ terminating it with a carriage return or the ENTER key. Also,@ some keys echo on the terminal while others do not, dependingB on the key. You can define your own keypad definitions with the œ DEFINE/KEY command. 3 DEFAULTB Keypad definitions when +--------+--------+--------+--------+B you do not use the GOLD | | Help | Set | |B or BLUE key. | GOLD | Keypad | Mode | BLUE |B | | Default| Screen | |B For more information +--------+--------+--------+--------+B see help on: | Src LH1| | | Disp |B |Inst RH1| Scroll | Disp | next |B KEYPAD BLUE | Out S45| Up | next | S12345 |B KEYPAD GOLD +--------+--------+--------+--------+B KEYPAD STATE_KEYS | Exam | | | |B | Scroll | Source | Scroll | Go |B Ctrl/W does a | Left | .0\%PC | Right | |B DISPLAY/REFRESH +--------+--------+--------+--------+B in screen mode. | | | Select | |B ž | Exam | Scroll | Scroll | E |B | | Down | next | N |B +--------+--------+--------+ T |B | | | E |B | Step | Reset | R |B | | | |B +-----------------+--------+--------+ 3 GOLDB Keypad definitions when +----Ÿ----+--------+--------+--------+B you press the GOLD key. | | Help |Set Mode| |B | GOLD | Keypad | No | BLUE |B Reset cancels the | | Gold | Screen | |B GOLD key. +--------+--------+--------+--------+B |Inst LH1| | Set | |B For more information, | Reg RH1| Scroll | Process| |B see help on: | Out S45| Top | next |   |B +--------+--------+--------+--------+B KEYPAD BLUE | Scroll | | Scroll | Select |B KEYPAD DEFAULT | Left | Show | Right | Source |B KEYPAD STATE_KEYS | 255 | Calls | 255 | next |B +--------+--------+--------+--------+B Ctrl/W does a | Exam | | Select | |B DISPLAY/REFRESH | prev | Scroll | Output | E |B in screen mode. ¡ | | Bottom | next | N |B +--------+--------+--------+ T |B | | | E |B | Step/Into | Reset | R |B | | | |B +-----------------+--------+--------+ 3 BLUEB Keypad definitions when +--------+--------+--------+--------+B you press the BLUE key. | | ¢ Help | | |B | GOLD | Keypad | Disp | BLUE |B "..." means you must | | Blue | Gener | |B type more input after +--------+--------+--------+--------+B pressing the key. |2 SRC Qn| Scroll | 2 SRC | Disp |B | 2 INST | Up | at | Src H1 |B Reset cancels the | at RQn | ... | Q1,Q2 | Out S45|B BLUE key. +--------+--------+--------+--------+B £ | Scroll | Show | Scroll | Select |B For more information, | Left | Calls | Right | Inst |B see help on: | ... | 3 | ... | next |B +--------+--------+--------+--------+B KEYPAD DEFAULT |3 SRC Sn| Scroll | 3 SRC | |B KEYPAD GOLD | 3 INST | Down | at | E |B KEYPAD STATE_KEYS | at RSn | ... |S1,S2,S3| N |B +-- ¤------+--------+--------+ T |B Ctrl/W does a | | | E |B DISPLAY/REFRESH | Step/Over | Reset | R |B in screen mode. | | | |B +-----------------+--------+--------+ 3 MOVEB Keypad definitions in +--------+--------+--------+--------+B the MOVE state when you | | Help | Set | |B do not use GOLD or BLUE. | GOLD | Keypad ¥ | Mode | BLUE |B | | Move | Screen | |B For more information, +--------+--------+--------+--------+B see help on: | Src LH1| | | Disp |B |Inst RH1| Move | Disp | next |B KEYPAD BLUE | Out S45| Up | next | S12345 |B KEYPAD GOLD +--------+--------+--------+--------+B KEYPAD STATE_KEYS | | Exam | | |B ¦ | Move | Source | Move | Go |B Ctrl/W does a | Left | .0\%PC | Right | |B DISPLAY/REFRESH +--------+--------+--------+--------+B in screen mode. | | | Select | |B | Exam | Move | Scroll | E |B | | Down | next | N |B +--------+--------+--------+ T |B | § | | E |B | Step | Reset | R |B | | | |B +-----------------+--------+--------+ 3 EXPANDB Keypad definitions in +--------+--------+--------+--------+B the EXPAND state when | | Help | Set | |B you do not use the GOLD | GOLD | Keypad | Mode | BLUE |B or BLUE key. | | Expand | S ¨creen | |B +--------+--------+--------+--------+B For more information, | Src LH1| | | Disp |B see help on: |Inst RH1| Expand | Disp | next |B | Out S45| Up | next | S12345 |B KEYPAD BLUE +--------+--------+--------+--------+B KEYPAD GOLD | | Exam | | |B KEYPAD STATE_KEYS | Expand | Source | Expand | Go |B © | Left | .0\%PC | Right | |B Ctrl/W does a +--------+--------+--------+--------+B DISPLAY/REFRESH | | | Select | |B in screen mode. | Exam | Expand | Scroll | E |B | | Down | next | N |B +--------+--------+--------+ T |B | | | E |B | Step ª | Reset | R |B | | | |B +-----------------+--------+--------+ 3 CONTRACTB Keypad definitions in +--------+--------+--------+--------+B the CONTRACT state when | | Help | Set | |B you do not use the GOLD | GOLD | Keypad | Mode | BLUE |B or BLUE key. | |Contract| Screen | |B +--------+--------+---- «----+--------+B For more information, | Src LH1| Expand | | Disp |B see help on: |Inst RH1| Up= | Disp | next |B | Out S45| -1 | next | S12345 |B KEYPAD BLUE +--------+--------+--------+--------+B KEYPAD GOLD | Expand | Exam | Expand | |B KEYPAD STATE_KEYS | Left= | Source | Right= | Go |B | -1 | .0\%PC | -1 | |B Ctrl/W does¬ a +--------+--------+--------+--------+B DISPLAY/REFRESH | | Expand | Select | |B in screen mode. | Exam | Down= | Scroll | E |B | | -1 | next | N |B +--------+--------+--------+ T |B | | | E |B | Step | Reset | R |B | ­ | | |B +-----------------+--------+--------+ 3 MOVE_GOLDB Keypad definitions in +--------+--------+--------+--------+B the MOVE state when | | Help |Set Mode| |B you press the GOLD key. | GOLD | Keypad | No | BLUE |B | |MoveGold| Screen | |B For more information, +--------+--------+--------+--------+B see help on: |Inst LH1| Move | Set ® | |B | Reg RH1| Up= | Process| |B KEYPAD BLUE | Out S45| 999 | next | |B KEYPAD DEFAULT +--------+--------+--------+--------+B KEYPAD STATE_KEYS | Move | | Move | Select |B | Left= | Show | Right= | Source |B Ctrl/W does a | 999 | Calls | 999 | next |B DISPLAY/REFRESH +--------+--------+--------+--------+B in screen mod¯e. | Exam | Move | Select | |B | prev | Down= | Output | E |B | | 999 | next | N |B +--------+--------+--------+ T |B | | | E |B | Step/Into | Reset | R |B | | | |B +---------------- °-+--------+--------+ 3 EXPAND_GOLDB Keypad definitions in +--------+--------+--------+--------+B the EXPAND state when | | Help |Set Mode| |B you press the GOLD key. | GOLD | Keypad | No | BLUE |B | |ExpaGold| Screen | |B For more information, +--------+--------+--------+--------+B see help on: |Inst LH1| Expand | Set | |B | Reg RH1| Up= | Proce ±ss| |B KEYPAD BLUE | Out S45| 999 | next | |B KEYPAD DEFAULT +--------+--------+--------+--------+B KEYPAD STATE_KEYS | Expand | | Expand | Select |B | Left= | Show | Right= | Source |B Ctrl/W does a | 999 | Calls | 999 | next |B DISPLAY/REFRESH +--------+--------+--------+--------+B in screen mode. | Exam | Expand | Select | |B ² | prev | Down= | Output | E |B | | 999 | next | N |B +--------+--------+--------+ T |B | | | E |B | Step/Into | Reset | R |B | | | |B +-----------------+--------+--------+ 3 CONTRACT_GOLDB Keypad definitions ³in +--------+--------+--------+--------+B the CONTRACT state when | | Help |Set Mode| |B you press the GOLD key. | GOLD | Keypad | No | BLUE |B | |CntrGold| Screen | |B For more information, +--------+--------+--------+--------+B see help on: |Inst LH1| Expand | Set | |B | Reg RH1| Up= | Process| |B KEYPAD BLUE | Out S45| -999 | ne ´xt | |B KEYPAD DEFAULT +--------+--------+--------+--------+B KEYPAD STATE_KEYS | Expand | | Expand | Select |B | Left= | Show | Right= | Source |B Ctrl/W does a | -999 | Calls | -999 | next |B DISPLAY/REFRESH +--------+--------+--------+--------+B in screen mode. | Exam | Expand | Select | |B | prev | Down= | Output | E |B µ | | -999 | next | N |B +--------+--------+--------+ T |B | | | E |B | Step/Into | Reset | R |B | | | |B +-----------------+--------+--------+ 3 MOVE_BLUEB Keypad definitions in +--------+--------+--------+--------+B the MOVE state when ¶ | | Help | | |B you press the BLUE key. | GOLD | Keypad | Disp | BLUE |B | |MoveBlue| Gener | |B For more information +--------+--------+--------+--------+B see help on: |2 SRC Qn| | 2 SRC | Disp |B | 2 INST | Move | at | Src H1 |B KEYPAD DEFAULT | at RQn | Up=5 | Q1,Q2 | Out S45|B KEYPAD GOLD +--------+--------+------ ·--+--------+B KEYPAD STATE_KEYS | | Show | | Select |B | Move | Calls | Move | Inst |B Ctrl/W does a | Left=10| 3 |Right=10| next |B DISPLAY/REFRESH +--------+--------+--------+--------+B in screen mode. |3 SRC Sn| | 3 SRC | |B | 3 INST | Move | at | E |B | at RSn | Down=5 |S1,S2,S3| N |B ¸ +--------+--------+--------+ T |B | | | E |B | Step/Over | Reset | R |B | | | |B +-----------------+--------+--------+ 3 EXPAND_BLUEB Keypad definitions in +--------+--------+--------+--------+B the EXPAND state when | | Help | | |B you press the BLUE ke¹y. | GOLD | Keypad | Disp | BLUE |B | |ExpaBlue| Gener | |B For more information +--------+--------+--------+--------+B see help on: |2 SRC Qn| | 2 SRC | Disp |B | 2 INST | Expand | at | Src H1 |B KEYPAD DEFAULT | at RQn | Up=5 | Q1,Q2 | Out S45|B KEYPAD GOLD +--------+--------+--------+--------+B KEYPAD STATE_KEYS | | Show | º | Select |B | Expand | Calls | Expand | Inst |B Ctrl/W does a | Left=10| 3 |Right=10| next |B DISPLAY/REFRESH +--------+--------+--------+--------+B in screen mode. |3 SRC Sn| | 3 SRC | |B | 3 INST | Expand | at | E |B | at RSn | Down=5 |S1,S2,S3| N |B +--------+--------+--------+ T |B » | | | E |B | Step/Over | Reset | R |B | | | |B +-----------------+--------+--------+ 3 CONTRACT_BLUEB Keypad definitions in +--------+--------+--------+--------+B the CONTRACT state when | | Help | | |B you press the BLUE key. | GOLD | Keypad | Disp | BLUE |B ¼ | |CntrBlue| Gener | |B For more information, +--------+--------+--------+--------+B see help on: |2 SRC Qn| Expand | 2 SRC | Disp |B | 2 INST | Up= | at | Src H1 |B KEYPAD DEFAULT | at RQn | -5 | Q1,Q2 | Out S45|B KEYPAD GOLD +--------+--------+--------+--------+B KEYPAD STATE_KEYS | Expand | Show | Expand | Select |B | Left= | Calls | Rig ½ht= | Inst |B Ctrl/W does a | -10 | 3 | -10 | next |B DISPLAY/REFRESH +--------+--------+--------+--------+B in screen mode. |3 SRC Sn| Expand | 3 SRC | |B | 3 INST | Down= | at | E |B | at RSn | -5 |S1,S2,S3| N |B +--------+--------+--------+ T |B | | | E |B ¾ | Step/Over | Reset | R |B | | | |B +-----------------+--------+--------+ 3 State_Keys? You can use the four scrolling keys (KP8, KP2, KP4, and KP6)B to expand, contract, and move displays, depending on the keypadC state in effect. Thus, the keys do a SCROLL/UP, /DOWN, /LEFT, orA /RIGHT, or a corresponding MOVE. You can press the GOLD key toB make the operation ¿to advance more than one line or column. The@ commands apply to the current scrolling display. Pressing KP3B selects the current scrolling display from the display circular list.B Four keys on the LK201 keyboard let you set the keypad state toC DEFAULT, MOVE, EXPAND, or CONTRACT. The keypad state changes theB definitions of KP8, KP2, KP4, and KP6. The meaning of all other keys remains unchanged.D If you do not have an LK201 keyboard with the F17-F20 keys on it,C you c Àan get the same effect by typing the corresponding command:? F17 F18 F19 F20C SET KEY/STATE=DEFAULT or +--------+--------+--------+--------+C SET KEY/STATE=MOVE | | | | |C SET KEY/STATE=EXPAND | DEFAULT| MOVE | EXPAND |CONTRACT|C SET KEY/STATE=CONTRACT | | | | |C +--------+--------+--------+--------+C For example, in the M ÁOVE state (key F18), pressing KP2 moves the@ default scrolling display down by one character position, andB pressing GOLD-KP2 moves the display down by a larger increment.@ The keypad remains in the MOVE state until you select another. state, such as the DEFAULT state (key F17). 3 SummaryB Summary of debugger +--------+--------+--------+--------+B keypad definitions. | | | | |B | GOLD | Help | Screen |  BLUE |B For more information, | | | Mode | |B see help on: +--------+--------+--------+--------+B | Select | | | Disp |B KEYPAD BLUE | Screen | Up | Disp | next |B KEYPAD DEFAULT | Layout | | next | at FS |B KEYPAD GOLD +--------+--------+--------+--------+B KEYPAD STATE_KEYS | | | | |B à | Left | Where | Right | Go |B Ctrl/W does a | | am I? | | |B DISPLAY/REFRESH +--------+--------+--------+--------+B in screen mode. | | | | |B | Exam | Down | Select | E |B | | | next | N |B +--------+--------+--------+ T |B | | Ä | E |B | Step | Reset | R |B | | | |B +-----------------+--------+--------+ 2 Keypad_Definitions_GUIB This section describes the keypad definitions in the debugger's: graphical user interface. For information on the keypad: definitions in the command interface, type HELP Keypad_ Definitions_CI.> On workstations running the debugger'Ås GUI, you can use theD numeric keypad to enter predefined debugger commands, as follows:( Key Predefined Command KP0 Step/Line KP1 Examine KPcomma Go GOLD-KP0 Step/Into BLUE-KP0 Step/Over GOLD-KP1 Examine^ KP5 Show Calls" GOLD-KP5 Show Calls 3D To issue one of these commands, press the key indicated, followed" by the Enter key on the keypa Æd.> You can change the commands represented by each key, or map> commands to other keys on your keyboard, by customizing theB EnterCmdOnCmdLine entry in the debugger resource file. For moreC information, see the OpenVMS Debugger Manual. If you are mapping? to other keys, you also need to consult the key designationsA listed in the KeySym Encoding chapter of the X and Motif Quick Reference Guide.? Users of the debugger's command interface keypad definitions? should Çnote that you do not need to be in keypad mode to use! keypad definitions in the GUI. 2 Language_Support 2 Language_SupportC The OpenVMS Debugger supports languages on Integrity servers and Alpha systems.= On Integrity server systems, you can use the debugger with3 programs written in the following VSI languages:( GNAT-Ada Assembler BASIC BLISS (IAS)* C C++ COBOL Fortran MACRO-32 IMACRO PascalC È Note that Integrity servers support the GNAT Pro Ada 95 compilerB from AdaCore. Also note that MACRO-32 must be compiled with the" AMACRO compiler. o Supported constructs in language expressions and address expressions o Supported data types8 o Any other language-specific information, including. restrictions in debugger support, if anyA For more information about language-specific debugger support,C refer to the documentation furnished with a particular language.@ If Ëyour program is written in more than one language, you canC change the debugging context from one language to another during= a debugging session. Use the SET LANGUAGE command with the1 keyword corresponding to your language choice.= On Integrity servers, you can specify one of the following keywords:$ AMACRO BASIC BLISS C) C++ COBOL Fortran PASCAL UNKNOWNC On Alpha systems, you can specify one of the following keywords:( ADA Ì AMACRO BASIC BLISS* C C++ COBOL FORTRAN* MACRO MACRO64 PASCAL UNKNOWN= When you are debugging a program written in an unsupported@ language, enter the SET LANGUAGE UNKNOWN command. To maximizeA the usability of the debugger with unsupported languages, thisD setting causes the debugger to accept a large set of data formatsA and operators, including some that might be specific to only a? few supported languages. For information abouÍt the operatorsA and constructs that are recognized when the language is set to' UNKNOWN, type Help Language_UNKNOWN. 3 GNAT_Ada Integrity servers.= The GNAT Pro (Ada 95) compiler is supported on OpenVMS for= Integrity server systems. For information on this product, contact Adacore directly.& NOTE? HP did not port the HP Ada (Ada 83) compiler from OpenVMS- Alpha to OpenVMS for Integrity servers.C Integrity s Îervers use GNAT Pro Ada 95 from AdaCore Technologies,D Inc. For information about this product, see the following online documents from AdaCore:@ o GNAT Pro Users Guide- This guide describes the use of GNATC Pro, a compiler and software development toolset for the fullC Ada 95 programming language. It can be found at the following URL:W http://www.gnat.com/wp-content/files/auto_update/gnat-unw-docs/html/gnat_ugn.htmlA o GNAT Pro Reference Manual- This Ïmanual contains informationC for writing programs using the GNAT Pro compiler. It includes@ information on implementation-dependent characteristics ofD GNAT Pro, including all the information required by Annex M of9 the standard. It can be found at the following URL:V http://www.gnat.com/wp-content/files/auto_update/gnat-unw-docs/html/gnat_rm.html= For information about HP Ada on OpenVMS Alpha, see HP Ada. 3 HP_Ada Alpha systems.B The followi Ðng subtopics describe debugger support for HP Ada onC Alpha systems. For information specific to Ada tasking programs, see also the debugger manual. 4 Ada_Names_and_SymbolsB The following subtopics describe debugger support for Ada names0 and symbols, including predefined attributes.D Note that parts of names may be language expressions-for example,B attributes such as 'FIRST or 'POS. This affects how you use the? EXAMINE, EVALUATE, and DEPOSIT commands with such namesÑ. ForB examples of enumeration types, type Help Specifying_Attributes_ with_Enumeration_Types. 5 Ada_Names Supported Ada names follow:# Kind of Name Debugger Support? Lexical Full support for Ada rules for the syntax of elements identifiers.A Function designators that are operator symbolsA (for example, + and *) rather than identifiersB must be prefixed with %NAME. Also, the operator> Ò symbol must be enclosed in quotation marks.C Full support for Ada rules for numeric literals,D character literals, string literals, and reserved words.B The debugger accepts signed integer literals in7 the range -2147483648 to 2147483647.= Depending on context and architecture, theA debugger interprets floating-point types as F_C Ó floating, D_floating, G_floating, H_floating, S_+ floating, or T_floating. Indexed Full support. componentsB Slices You can examine and evaluate an entire slice or3 an indexed component of a slice.D You can deposit only to an indexed component of a= slice. You cannot deposit an entire slice.D Selected Full support, including use of the keyword all in components .all. Ô< Literals Full support, including the keyword null.. Boolean Full support (TRUE, FALSE). symbols> Aggregates You can examine the entire record and arrayD objects with the EXAMINE command. You can depositD a value in a component of an array or record. YouB cannot use the DEPOSIT command with aggregates,= except to deposit character string values. 5 Predefined_Attributes< Supported A Õda predefined attributes follow. Note that theB debugger SHOW SYMBOL/TYPE command provides the same informationA that is provided by the P'FIRST, P'LAST, P'LENGTH, P'SIZE, and P'CONSTRAINED attributes. Attribute Debugger Support; P'CONSTRAINEDFor a prefix P that denotes a record object> with discriminants. The value of P'CONSTRAINED? reflects the current state of P (constrained or unconstrained).B P'FIRST For a prefix Ö P that denotes an enumeration type orB a subtype of an enumeration type. Yields the lower bound of P.? P'FIRST For a prefix P that is appropriate for an arrayB type, or that denotes a constrained array subtype.@ Yields the lower bound of the first index range.? P'FIRST(N) For a prefix P that is appropriate for an arrayB type, or that denotes a constrained array subtype.> Yields the lower b ×ound of the Nth index range.C P'LAST For a prefix P that denotes an enumeration type, orB a subtype of an enumeration type. Yields the upper bound of P.? P'LAST For a prefix P that is appropriate for an arrayB type, or that denotes a constrained array subtype.@ Yields the upper bound of the first index range.? P'LAST(N) For a prefix P that is appropriate for an arrayB type, or that denotes a co Ønstrained array subtype.> Yields the upper bound of the Nth index range.? P'LENGTH For a prefix P that is appropriate for an arrayB type, or that denotes a constrained array subtype.D Yields the number of values of the first index range( (zero for a null range).? P'LENGTH(N) For a prefix P that is appropriate for an arrayB type, or that denotes a constrained array subtype.B Yields the number of Ù values of the Nth index range( (zero for a null range).D P'POS(X) For a prefix P that denotes an enumeration type or aC subtype of an enumeration type. Yields the position? number of the value X. The first position is 0.B P'PRED(X) For a prefix P that denotes an enumeration type orB a subtype of an enumeration type. Yields the valueC of type P which has a position number one less than that Ú of X.A P'SIZE For a prefix P that denotes an object. Yields the< number of bits allocated to hold the object.B P'SUCC(X) For a prefix P that denotes an enumeration type orB a subtype of an enumeration type. Yields the valueC of type P which has a position number one more than that of X.B P'VAL(N) For a prefix P that denotes an enumeration type orB a subtype of an enumeration type. Yields the valueÛD of type P which has the position number N. The first position is 0. /6 Specifying_Attributes_with_Enumeration_Types' Consider the following declarations: type DAY isA (MONDAY,TUESDAY,WEDNESDAY,THURSDAY,FRIDAY,SATURDAY,SUNDAY); MY_DAY : DAY;9 The following examples show the use of attributes withB enumeration types. Note that you cannot use the EXAMINE commandC to determine the value of attributes, because attributes are notAÜ variable names. You must use the EVALUATE command instead. ForB the same reason, attributes can appear only on the right of the$ := operator in a DEPOSIT command. DBG> EVALUATE DAY'FIRST MON# DBG> EVALUATE DAY'POS(WEDNESDAY) 2 DBG> EVALUATE DAY'VAL(4) FRI! DBG> DEPOSIT MY_DAY := TUESDAY! DBG> EVALUATE DAY'SUCC(MY_DAY) WED% DBG> DEPOSIT . := DAY'PRED(MY_DAY) DBG> EXAMINE . EXAMPLE.MY_DAY: MONDAY! DBG> EVALUATE DAY'PRED(MY_DAY)< %DEBUÝG-W-ILLENUMVAL, enumeration value out of legal range ,6 Resolving_Overloaded_Enumeration_Literals' Consider the following declarations: type MASK is (DEC,FIX,EXP); type CODE is (FIX,CLA,DEC); MY_MASK : MASK; MY_CODE : CODE;@ In the following example, the qualified expression CODE'(FIX)D resolves the overloaded enumeration literal FIX, which belongs to both type CODE and type MASK: DBG> DEPOSIT MY_CODE := FIX0 %DEBUG-W-NOUNIQUE, symbol 'FIX' is not uniqÞue DBG> SHOW SYMBOL/TYPE FIX data EXAMPLE.FIX8 enumeration type (CODE, 3 elements), size: 1 byte data EXAMPLE.FIX8 enumeration type (MASK, 3 elements), size: 1 byte% DBG> DEPOSIT MY_CODE := CODE'(FIX) DBG> EXAMINE MY_CODE EXAMPLE.MY_CODE: FIX 4 Operators_and_Expressions; The following sections describe debugger support for Ada& operators and language expressions. !5 Langugage_Expression_Operators; Supported Ada operators in langßuage expressions include: Kind Symbol Function( Prefix + Unary plus (identity) Infix + Addition! Infix * Multiplication Infix / Division Infix MOD Modulus Infix REM Remainder! Prefix ABS Absolute value4 Infix & Concatenation (only string types): Infix = Equality (only scalar and string types)< Infix /= Inequality (only scalar and string types)> Infix > Greater than (onl ày scalar and string types)@ Infix >= Greater than or equal (only scalar and string types); Infix < Less than (only scalar and string types)D Infix <= Less than or equal (only scalar and string types) Prefix NOT Logical NOT3 Infix AND Logical AND (not for bit arrays)2 Infix OR Logical OR (not for bit arrays)< Infix XOR Logical exclusive OR (not for bit arrays)5 The debugger does not support the following iteáms:, o Operations on entire arrays or records8 o The short-circuit control forms: and then, or else& o The membership tests: in, not in o User-defined operators 5 Language_Expressions% Supported Ada expressions include: Kind of" Expression Debugger Support9 Type No support for any of the explicit type< conversions conversions specified in Ada. However, the9 debugger performs certain implicit type> â conversions between numeric types during the, evaluation of expressions.= The debugger converts lower-precision types= to higher-precision types before evaluating: expressions involving types of different precision:C o If integer and floating-point types are mixed,D the integer type is converted to floating-point type.D ã o If integer and fixed-point types are mixed, theC integer type is converted to fixed-point type.B o If integer types of different sizes are mixedB (for example, byte-integer and word-integer),B the one with the smaller size is converted to% the larger size.> Subtypes Full support. Note that the debugger denotes@ subtypes and types that have range constraints& ä as "subrange" types.= Qualified Supported as required to resolve overloadedC expressions enumeration literals (literals that have the same@ identifier but belong to different enumerationA types). The debugger does not support qualified4 expressions for any other purpose.@ Allocators No support for any operations with allocators. Universal No support. expressions 4 Data_Types# Supported å Ada data types follow:> Ada Data Type Operating System Data Type Name3 INTEGER Longword Integer (L)/ SHORT_INTEGER Word Integer (W)/ SHORT_SHORT_INTEGER Byte Integer (B)5 SYSTEM.UNSIGNED_QUADWORD Quadword Unsigned (QU)5 SYSTEM.UNSIGNED_LONGWORD Longword Unsigned (LU)1 SYSTEM.UNSIGNED_WORD Word Unsigned (WU)1 SYSTEM.UNSIGNED_BYTE Byte Unsigned (BU)- FLOAT F_Floating æ(F)- SYSTEM.F_FLOAT F_Floating (F)- SYSTEM.D_FLOAT D_Floating (D)C LONG_FLOAT D_Floating (D), if pragma LONG_FLOAT6 (D_FLOAT) is in effect.C G_Floating (G), if pragma LONG_FLOAT6 (G_FLOAT) is in effect.- SYSTEM.G_FLOAT G_Floating (G). IEEE_SINGLE_FLOAT S_Floating (FS) (Alpha specific). IEEE_DOUBLE_FLOAT T_F çloating (FT) (Alpha specific)% Fixed (None)- STRING ASCII Text (T)5 BOOLEAN Aligned Bit String (V)8 BOOLEAN Unaligned Bit String (VU)C Enumeration For any enumeration type whose valueB fits into an unsigned byte or word:B Byte Unsigned (BU) or Word Unsigned@ (WU), respectively. Otherwise: èNoB corresponding operating system data$ type.% Arrays (None)% Records (None)% Access (pointers) (None)% Tasks (None) 4 Compiling_and_LinkingA The Ada predefined units in the ADA$PREDEFINED program libraryA on your system have been compiled with the /NODEBUG qualifier.> Before using the debugger to refer to names declared in theC p éredefined units, you must first copy the predefined unit source= files using the ACS EXTRACT SOURCE command. Then, you mustB compile the copies into the appropriate library with the /DEBUG? qualifier, and relink the program with the /DEBUG qualifier.D If you use the /NODEBUG qualifier with one of the Ada compilationC commands, only global symbol records are included in the modules@ for debugging. Global symbols in this case are names that theD program exports to modules in oêther languages by means of the Ada export pragmas: EXPORT_PROCEDURE EXPORT_VALUED_PROCEDURE EXPORT_FUNCTION EXPORT_OBJECT EXPORT_EXCEPTION PSECT_OBJECTD The /DEBUG qualifier on the ACS LINK command causes the linker toD include all debugging information in the closure of the specified unit in the executable image. 4 Source_DisplayA Source code may not be available for display for the following- reasons that are specific to ëAda programs:B o Execution is paused within Ada initialization or elaboration2 code, for which no source code is available.D o The copied source file is not in the program library where the# unit was originally compiled.D o The external source file is not where it was when the unit was originally compiled.B o The source file has been modified since the executable imageD was generated, and the original copied source file or external# source file ìno longer exists.A The following paragraphs explain how to control the display of! source code with Ada programs.A If the compiler command's /COPY_SOURCE qualifier (the default)= was in effect when you compiled your program, the debugger? obtains the displayed Ada source code from the copied source= files located in the program library where the program was= originally compiled. If you compiled your program with the? /NOCOPY_SOURCE qualifier, the debugger obtains th íe displayedA Ada source code from the external source files associated with$ your program's compilation units.A The file specifications of the copied or external source filesC are embedded in the associated object files. For example, if you@ have used the ACS COPY UNIT command to copy units, or the DCLA command COPY or BACKUP to copy an entire library, the debugger@ still searches the original program library for copied sourceB files. If, after copying, the original unit îs have been modifiedA or the original library has been deleted, the debugger may not@ find the original copied source files. Similarly, if you haveD moved the external source files to another disk or directory, the debugger may not find them.B In such cases, use the SET SOURCE command to locate the correctA files for source display. You can specify a search list of oneB or more program library or source code directories. For example@ (ADA$LIB is the logical name that the pïrogram library manager+ equates to the current program library):4 DBG> SET SOURCE ADA$LIB,DISK:[SMITH.SHARE.ADALIB]A The SET SOURCE command does not affect the search list for theC external source files that the debugger fetches when you use theD debugger EDIT command. To tell the EDIT command where to look for6 your source files, use the SET SOURCE/EDIT command. 4 EDIT_CommandB With Ada programs, by default the debugger EDIT command fetches< the external source ð file that was compiled to produce the? compilation unit in which execution is currently paused. YouC do not edit the copied source file, in the program library, that( the debugger uses for source display.D The file specifications of the source files you edit are embedded@ in the associated object files during compilation (unless youD specify /NODEBUG). If some source files have been relocated after/ compilation, the debugger may not find them.B In such cases, you can us ñe the debugger SET SOURCE/EDIT command@ to specify a search list of one or more directories where the6 debugger should look for source files. For example:4 DBG> SET SOURCE/EDIT [],USER:[JONES.PROJ.SOURCES]B The SET SOURCE/EDIT command does not affect the search list forA copied source files that the debugger uses for source display.D The SHOW SOURCE/EDIT command displays the source-file search listD currently being used for the EDIT command. The CANCEL SOURCE/EDITC commaònd cancels the source-file search list currently being used= for the EDIT command and restores the default search mode. 4 GO_and_STEP_CommandsA Note the following points about using the GO and STEP commands with Ada programs:B o When starting a debugging session, use the GO command rather? than the STEP command to avoid stepping through compiler-$ generated initialization code.C - Use the GO command to go directly to the preset breakpointB a ót the start of the main program, past the initialization& and package elaboration code.C - Use the GO command and breakpoints to suspend execution atA the start of the elaboration of library packages, before, execution reaches the main program.? For information on how to monitor the package elaboration6 phase, type Help Debugging_Ada_Library_Packages.@ o If a line contains more than one statement, a STEP commandB executes all the stateme ônts on that line as part of a single step.? o Ada task entry calls are not the same as subprogram callsC because task entry calls are queued and may not execute right@ away. If you use the STEP command to move execution into a@ task entry call, the results might not be what you expect. !4 Debugging_Ada_Library_PackagesA When an Ada main program (or a non-Ada main program that callsA Ada code) is executed, initialization code is executed for theB Ada õ run-time library and elaboration code for all library units? that the program depends on. The elaboration code causes theA library units to be elaborated in appropriate order before the@ main program is executed. Library specifications, bodies, and> some of their subunits are also elaborated by this process.A The elaboration of library packages accomplishes the following operations:0 o Causes package declarations to take effect: o Initializes any variables whose deöclaration includes initialization codeA o Executes any sequence of statements that appear between the0 begin and end statements of package bodiesB When you bring an Ada program under debugger control, executionA is paused initially before the initialization code is executed< and before the elaboration of library units. For example: DBG> RUN FORMS Language: ADA, Module: FORMS Type GO to reach main program DBG>B At that point, before typing GO t ÷o get to the start of the mainA program, you can step through and examine parts of the library@ packages by setting breakpoints at the package specifications? or bodies you are interested in. You then use the GO command@ to get to the start of each package. To set a breakpoint on aA package body, specify the package unit name with the SET BREAKC command. To set a breakpoint on a package specification, specifyD the package unit name followed by a trailing underscore character ø (_).A Even if you have set a breakpoint on a package body, the break= will not occur if the debugger module for that body is not= set. If the module is not set, the break will occur at theA package specification. This effect occurs because the debugger@ automatically sets modules for the specifications of packages? named in with clauses; it does not automatically set modulesB for the associated package bodies (see the Language_Support Ada subtopic Setting_Modules). ùB Also, to set a breakpoint on a subprogram declared in a package? specification, you must set the module for the package body.@ Note that the compiler generates unique names for subprograms? declared in library packages that are or could be overloadedA names. The debugger uses these unique names in its output, and? requires them in commands where the names would otherwise be@ ambiguous. For more information on resolving overloaded names@ and symbols, see the Language_S úupport Ada subtopic Resolving_ Overloaded_Names_and_Symbols. 4 Predefined_Breakpoints@ When you start the debugger with an Ada program (or a non-AdaD program that calls Ada code), two breakpoints that are associatedC with Ada tasking exception events are automatically established.B These breakpoints are established automatically during debugger; initialization when the Ada run-time library is present.B When you enter a SHOW BREAK command under these conditions, the'û following breakpoints are displayed: DBG> SHOW BREAK< Predefined breakpoint on ADA event "EXCEPTION_TERMINATED" for any value< Predefined breakpoint on ADA event "DEPENDENTS_EXCEPTION" for any value DBG> 4 Monitoring_Exceptions; The debugger recognizes three kinds of exceptions in Ada programs:A o A user-defined exception-an exception declared with the Ada8 reserved word exception in an Ada compilation unit; o An Ada predefined exüception, such as PROGRAM_ERROR or CONSTRAINT_ERROR0 o Any other (non-Ada) exception or conditionB The following subtopics explain how to monitor such exceptions. 5 Monitoring_Any_ExceptionB The SET BREAK/EXCEPTION command enables you to set a breakpointB on any exception or condition. This includes certain conditions@ that are signaled internally within the Ada run-time library.@ These conditions are an implementation mechanism; they do not@ represent programý failures, and they cannot be handled by Ada? exception handlers. If these conditions appear while you areB debugging your program, you may want to consider specifying the/ kind of exceptions when setting breakpoints.@ The following example shows a tracepoint occurring for an AdaD CONSTRAINT_ERROR exception as the result of a SET TRACE/EXCEPTION command: DBG> SET TRACE/EXCEPTION DBG> GO . . .+ %ADA-F-CONSTRAINT_ERRO, CONSTRAINT_ERROR< -ADA-I-EXCRAIPRþI, Exception raised prior to PC = 00000A7C trace on exception preceding1 ADA$RAISE\ADA$RAISE_CONDITION.%LINE 333+12 . . .C In the next example, the SHOW CALLS command displays a traceback= of the calls leading to the subprogram where the exception1 occurred or to which the exception was raised:+ DBG> SET BREAK/EXCEPTION DO (SHOW CALLS) DBG> GO . . .4 %SYSTEM-F-INTDIV, arithmetic trap, integer divide by zero at PC=000008AF,, PSL ÿ=03C000A2 break on exception preceding$ SYSTEM_OPS.DIVIDE.%LINE 17+6 17: return X/Y;? module name routine name line rel PC abs PC@ *SYSTEM_OPS DIVIDE 17 00000015 000008AF@ *PROCESSOR PROCESSOR 19 000000AE 00000BAD *ADA$ELAB_PROCESSOR@ ADA$ELAB_PROCESSOR 00000009 00000809@ LIB$INITIALIZE 00000054 00000C36@ SHARE$ADARTL  00000000 000398BE *ADA$ELAB_PROCESSOR@ ADA$ELAB_PROCESSOR 0000001B 0000081B@ LIB$INITIALIZE 0000002F 00000C21> In this example, the condition SS$_INTDIV is raised at line= 17 of the subprogram DIVIDE in the package SYSTEM_OPS. TheC example shows an important effect: some conditions (such as SS$_A INTDIV) are treated as being equivalent to some Ada predefined exceptions.A The matching of a condition and an Ada predefined exception isC performed by the condition handler provided by Ada for any frame@ that includes an exception part. Therefore, when an exception@ breakpoint or tracepoint is triggered by a condition that hasB an equivalent Ada exception name, the message displays only theD system condition code name, and not the name of the corresponding Ada exception. 5 Monitoring_ExceptionsC Whenever an exception is raised, the debugger sets the following: built-in symbol s. You can use them to qualify exceptionB breakpoints or tracepoints so that they trigger only on certain exceptions.@ %EXC_ A string that names the facility that issued the? FACILITY exception. The facility name for Ada predefined> exceptions and user-defined exceptions is ADA.= %EXC_NAME An uppercase string that names the exception.< If the exception raised is an Ada predefined> exception, its name is truncated if it e xceeds? 15 characters. For example, CONSTRAINT_ERROR isA truncated to CONSTRAINT_ERRO. If the exception is@ a user-defined exception, %EXC_NAME contains theD string "EXCEPTION", and the name of the user-defined7 exception is contained in %ADAEXC_NAME.A %ADAEXC_ If the exception raised is user-defined, %ADAEXC_D NAME NAME contains a string that names the exception, andA %EXC_NAME contai ns the string "EXCEPTION". If theD exception is not user-defined, %ADAEXC_NAME contains? a null string, and the name of the exception is' contained in %EXC_NAME., %EXC_NUM The number of the exception.D %EXC_ A string that gives the exception severity level (F," SEVERITY E, W, I, S, or ?). 5 Monitoring_Handled_Exceptions? The SET BREAK/EVENT and SET TRACE/EVENT commands let you setA breakpoints and tracepoints on exceptions that are about to beD handled by Ada exception handlers. These commands let you observeB the execution of each Ada exception handler that gains control.7 You can specify two event names with these commands:B HANDLED Triggers when an exception is about to be handled? in an Ada exception handler (includes HANDLED_ OTHERS events).? HANDLED_ Triggers only when an exception is about to beC OTHERS handled in an Ada exc eption handler choice others.< For example, the following command sets a breakpoint thatB triggers whenever an exception is about to be handled by an Ada exception handler: DBG> SET BREAK/EVENT=HANDLED< When the breakpoint triggers, the debugger identifies theB exception that is about to be handled and the exception handlerB that is about to be executed. You can then use that informationD to set a breakpoint on a particular handler, or you can enter theD GO command, and see which Ada handler next attempts to handle the exception. For example: DBG> GO . . . break on Ada event HANDLED1 task %TASK 1 is about to handle an exception8 The Ada exception handler is at: PROCESSOR.%LINE 21/ %ADA-F-CONSTRAINT_ERRO, CONSTRAINT_ERROR@ -ADA-I-EXCRAIPRI, Exception raised prior to PC = 00000A7C( DBG> SET BREAK PROCESSOR.%LINE 21; GO "4 Examining_and_Manipulating_Data; When examining and manipulating data, note th e following considerations:A o Before you can examine or deposit into a nonstatic variableD (any variable not declared in a library package), its definingD subprogram, task, and so on, must be active on the call stack.D o Before you can examine, deposit, or evaluate an Ada subprogramD formal parameter or an Ada variable, the parameter or variable< must be elaborated. In other words, you should step or? otherwise move execution past the parameter or varia ble's@ declaration. The value contained in any variable or formalB parameter whose declaration has not been elaborated might be invalid.? In most cases, the debugger enables you to specify variables< and expressions in debugger commands exactly as you would@ specify them in the source code of the program, including useA of qualified expressions. The following subtopics discuss someB additional points about debugger support for records and access types.  5 Records@ Note the following points about debugger support for records:C o With certain Ada record variables, the debugger fails to show@ the record components correctly (possibly with a NOACCESSR@ error message) when the type declaration is in a different1 scope than the record (symbol) declaration.C o With variant records, the debugger lets you examine or assignB a value to a component of a variant part that is not active.@ But because this is an i llegal action in Ada, the debugger? also issues an informational message. For example, assumeD that record REC1 has a variant field named STATUS and that the: value of STATUS is such that REC1.COMP3 is inactive: DBG> EXAMINE REC1.COMP3? %DEBUG-I-BADDISCVAL, incorrect value of 1 in discriminant field STATUS MAIN.REC1.COMP3: 438 5 Access_Types> Note the following points about debugger support for access types:D o The debugg er does not support allocators, so you cannot create+ new access objects with the debugger.D o When you specify the name of an access object with the EXAMINE? command, the debugger displays the memory location of the object it designates.? o To examine the value of a designated object, you must useC selected component notation, specifying .ALL. For example, toB examine the value of a record access object designated by A: DBG> EXAMINE A.ALL   EXAMPLE.A.ALL* NAME(1..10): "John Doe " AGE : 6 NEXT: 1462808C o To examine one component of a designated object, you can omit; .ALL from the selected component syntax. For example: DBG> EXAMINE A.NAME1 EXAMPLE.A.ALL.NAME(1..10): "John Doe "B The following example shows the debugger support for incomplete. types. Consider the following declarations: package P is type T is private; private type T_TYPE; type T is access T_TYPE; end P; package body P is type T_TYPE is record A: NATURAL := 5; B: NATURAL := 4; end record; T_REC: T_TYPE;% T_PTR: T := new T_TYPE'(T_REC); end P; with P; use P; procedure INCOMPLETE is VAR: T; begin . . . end INCOMPLETE;D The debugger does not have complete information about the type T,C so you cannot manipulate the variable VAR. However, the debuggerC does have information about objects declared in the package body= P. Thus, you can manipulate the variables T_PTR and T_REC. 4 Module_Names_and_Path_Names> The names of Ada debugger modules are the same as the names= of the corresponding compilation units, with the followingA provision. To eliminate ambiguity, an underscore character (_)A is appended to a specification name to distinguish it from itsA body name. For example, TEST (body), TEST_ (specification). ToD determine the exact names of the modules in your program, use the SHOW MODULE command.? In most cases when you specify a path name, the debugger canC distinguish body names and specification names from the context.B Therefore, use this naming convention only if needed to resolve an ambiguity.C When the debugger language is set to Ada, the debugger generallyA constructs pathnames that follow the Ada rules, using selected@ compone nt notation to separate path name elements (with other< languages, a backslash is used to separate elements). For example:2 TEST_.A1 ! A1 is declared in the package0 ! specification of unit TEST2 TEST.B1 ! B1 is declared in the package' ! body of unit TESTB The maximum length that you can specify for a subunit path name% (expanded name) is 247 characters.B When a use clause makes a symbol declared in a package direct ly= visible outside the package, you do not need to specify an> expanded name (package-name.symbol) to refer to the symbol,8 either in the program itself or in debugger commands.< The SHOW SYMBOL/USE_CLAUSE command identifies any package@ (library or otherwise) that a specified block, subprogram, orA package mentions in a use clause. If the entity specified is aB package (library or otherwise), the command also identifies anyB block, subprogram, package, and so on, that names the specified' module in a use clause. For example:! DBG> SHOW SYMBOL/USE_CLAUSE B_ package spec B_ used by: F uses: A_D If a label has been assigned to a loop statement or declare blockB in the source code, the debugger displays the label; otherwise,? the debugger displays LOOP$n for a loop statement or BLOCK$n? for a declare block, where n is the line number at which the statement or block begins. 4 Symbol_Lookup_ConventionsC For  Ada programs, when you do not specify a path name (includingC an Ada expanded name), the debugger searches the run-time symbol table as follows.C 1. The debugger looks for the symbol within the block or routineD surrounding the current PC value (where execution is currently paused).@ 2. If the symbol is not found, the debugger then searches anyB package that is mentioned in a use clause. The debugger doesC not distinguish between a library package and a package whoseD declaration is in the same module as the current scope region.A If the same symbol is declared in two or more packages that= are visible, the symbol is not unique (according to Ada> rules), and the debugger issues a message similar to the following:1 %DEBUG-E-NOUNIQUE, symbol 'X' is not uniqueA 3. If the symbol is still not found, the debugger searches the: call stack and other scopes, as for other languages. 4 Setting_Modules > When you or the debugger sets an Ada module, by default the? debugger also sets any "related" module (that is, any module@ whose symbols should be visible within the module being set).A Such modules are related to the one being set through either a) with-clause or a subunit relationship.> Related module setting takes place as follows. If M1 is the; module that is being set, then the following modules are' considered related and are also set:D o If M1 is a library  body, the debugger also sets the associated$ library specification, if any.@ o If M1 is a subunit, the debugger also sets its parent unit/ and, therefore, any parent of the parent.? o If M1 mentions a library package P1 in a with clause, the@ debugger also sets P1's specification. Neither the body ofA P1 nor any possible subunits of P1 are set, because symbols9 declared within them should not be visible outside.C If P1's specification mentions a p ackage P2 in a with clause,= the debugger also sets P2's specification. Likewise, if@ P2's specification mentions a package P3 in a with clause,? the debugger also sets P3's specification, and so on. The< specifications of all such library packages are set so> that you can access data components (for example, record@ components) that may have been declared in other packages.? o If M1 mentions a library subprogram in a with clause, the? debugger does not set the subprogram. Only the subprogram= name needs to be visible in M1 (no declaration within aC library subprogram should be visible outside the subprogram).= Therefore, the debugger inserts the name of the library- subprogram into the RST when M1 is set.@ If debugger performance becomes a problem as more modules areB set, use the SET MODE NODYNAMIC command, which disables relatedB module setting as well as dynamic module setting. You must thenA set ind ividual modules explicitly with the SET MODULE command.: By default, the SET MODULE command sets related modules; simultaneously with the module specified in the command.= The SET MODULE/NORELATED command sets only the modules youD specify explicitly. However, if you use SET MODULE/NORELATED, youC may find that a symbol that is declared in another unit and thatC should be visible at the point of execution is no longer visible@ or that a symbol which should be hidden by a redeclaration of# that same symbol is now visible.@ The CANCEL MODULE/NORELATED command deletes from the RST onlyA the modules you specify explicitly. This command, which is the? default, deletes related modules in a manner consistent withC the intent of Ada's scope and visibility rules. The exact effect# depends on module relationships.D The distinction between related and directly related for subunits- is analogous to that for library packages. 5 Set_Mods_for_Package_Bodies> Modules for package bodies are not automatically set by the debugger.= You may need to set the modules for library package bodies; yourself so that you can debug the package body or debugC subprograms declared in the corresponding package specification. 4 Overloaded_Names_and_Symbols@ When you encounter overloaded names and symbols, the debugger' issues a message like the following:1 %DEBUG-E-NOTUNQOVR, symbol 'ADD' is overloaded7 us e SHOW SYMBOL to find the unique symbol namesB If the overloaded symbol is an enumeration literal, you can use5 qualified expressions to resolve the overloadings.B If the overloaded symbol represents a subprogram or task acceptC statement, you can use the unique name generated by the compilerC for the debugger. The compiler always generates unique names forB subprograms declared in library package specifications, becauseB the names might later be overloaded in the package body. UniqueA names are generated for task accept statements and subprogramsA declared in other places only if the task accept statements or' subprograms are actually overloaded.B Overloaded task accept statement names and subprogram names areC distinguished by a suffix consisting of two underscores followedD by an integer that uniquely identifies the given symbol. You mustB use the unique naming notation in debugger commands to uniquelyC specify a subprogram whose name i s overloaded. However, if there@ is no ambiguity, you do not need to use the unique name, even though one was generated. 4 CALL_Command@ With Ada programs, you can use the CALL command reliably onlyC with a subprogram that has been exported. An exported subprogramD must be a library subprogram or must be declared in the outermost) declarative part of a library package.D The CALL command does not check whether or not the subprogram canB be exported, nor does it ch eck the parameter-passing mechanismsA that you specify. Note that you cannot use the CALL command to# modify the value of a parameter.D A CALL command may result in a deadlock if it is entered when theC Ada run-time library is executing. The run-time library routines@ acquire and release internal locks that allow the routines to= operate in a tasking environment. Deadlock can result if a> subprogram called from the CALL command requires a resourceA that has been locked by! an executing run-time library routine.B To avoid this situation in a nontasking program, enter the CALL@ command immediately before or after an Ada statement has been? executed. However, this approach is not sufficient to assureC that deadlock will not occur in a tasking program, as some otherB task may be executing a run-time library routine at the time ofC the call. If you must use the CALL command in a tasking program,B you can avoid deadlock if the called subprogram does "not do any& tasking or input-output operations. 3 BASIC? The following subtopics describe debugger support for BASIC. !4 Language_Expressions_Operators= Supported BASIC operators in language expressions include: Kind Symbol Function Prefix + Unary plus1 Infix + Addition, String concatenation! Infix * Multiplication Infix / Division! Infix ** Exponentiation! Infix ^ Exponentiation Infix # = Equal to Infix <> Not equal to Infix >< Not equal to Infix > Greater than+ Infix >= Greater than or equal to+ Infix => Greater than or equal to Infix < Less than( Infix <= Less than or equal to( Infix =< Less than or equal to Prefix NOT Bit-wise NOT Infix AND Bit-wise AND Infix OR Bit-wise OR( Infix XOR Bit-wise exclusive OR' Infix IMP Bit-wise implicat$ion' Infix EQV Bit-wise equivalence &4 Constructs_in_Lang_Addr_Expressions? Supported constructs in language and address expressions for BASIC follow: Symbol Construct ( ) Subscripting$ :: Record component selection 4 Data_Types% Supported BASIC data types follow:> BASIC Data Type Operating System Data Type Name/ BYTE Byte Integer (B)/ WORD Word Integer (W)3 LONG % Longword Integer (L)- SINGLE F_Floating (F)- DOUBLE D_Floating (D)- GFLOAT G_Floating (G)1 DECIMAL Packed Decimal (P)- STRING ASCII Text (T)% RFA (None)% RECORD (None)% Arrays (None) 4 Compiling_for_Debugging@ If you make changes to a program in the BASIC environment and &C attempt to compile the program with the /DEBUG qualifier withoutA first saving or replacing the program, BASIC signals the errorB "Unsaved changes, no source line debugging available." To avoidD this problem, save or replace the program, and then recompile the% program with the /DEBUG qualifier. 4 ConstantsB BASIC constants of the form [radix]"numeric-string"[type] (suchD as "12.34"GFLOAT) or the form n% (such as 25% for integer 25) are) not supported in debugger e'xpressions. 4 Evaluating_Expressions9 Expressions that overflow in the BASIC language do notD necessarily overflow when evaluated by the debugger. The debugger? tries to compute a numerically correct result, even when theB BASIC rules call for overflows. This difference is particularly) likely to affect DECIMAL computations. 4 Line_Numbers? The sequential line numbers that you refer to in a debugging> session and that are displayed in a source code display a (reA those generated by the compiler. When a BASIC program includesD or appends code from another file, the included lines of code are- also numbered in sequence by the compiler. 4 Stepping_into_RoutinesD The STEP/INTO command is useful for examining external functions.D However, if you use this command to stop execution at an internalB subroutine or a DEF, the debugger initially steps into run-timeD library (RTL) routines, providing you with no useful information.@ I)n the following example, execution is paused at line 8, at a call to Print_routine: . . . -> 8 GOSUB Print_routine 9 STOP . . . 20 Print_routine:! 21 IF Competition = DoneA 22 THEN PRINT "The winning ticket is #";Winning_ticket, 23 ELSE PRINT "The game goes on." 24 END IF 25 RETURN@ A STEP/INTO command would cause the debugger to step into the> relevant RTL code and would inform you that no so *urce lines? are available for display. On the other hand, a STEP command? alone would cause the debugger to proceed directly to source@ line 9, past the call to Print_routine. To examine the source@ code of subroutines or DEF functions, set a breakpoint on the@ routine label (for example, enter the SET BREAK PRINT_ROUTINE@ command). You can then suspend execution exactly at the startC of the routine (line 20, in this example) and then step directly into the code. 4 + Symbolic_ReferencesB All variable and label names within a single BASIC program must> be unique. Otherwise the debugger cannot resolve the symbol ambiguity. 3 BLISS? The following subtopics describe debugger support for BLISS. $4 Operators_in_Language_Expressions= Supported BLISS operators in language expressions include: Kind Symbol Function Prefix . Indirection Prefix + Unary plus Infix + Addition! Infix * , Multiplication Infix / Division Infix MOD Remainder Infix ^ Left shift Infix EQL Equal to Infix EQLU Equal to Infix EQLA Equal to Infix NEQ Not equal to Infix NEQU Not equal to Infix NEQA Not equal to Infix GTR Greater than( Infix GTRU Greater than unsigned( Infix GTRA Greater than unsigned+ Infix GEQ Greater than or equal to4 Infix GEQU Greater than or equal - to unsigned4 Infix GEQA Greater than or equal to unsigned Infix LSS Less than% Infix LSSU Less than unsigned% Infix LSSA Less than unsigned( Infix LEQ Less than or equal to1 Infix LEQU Less than or equal to unsigned1 Infix LEQA Less than or equal to unsigned Prefix NOT Bit-wise NOT Infix AND Bit-wise AND Infix OR Bit-wise OR( Infix XOR Bit-wise exclusive OR' Infix EQV Bit-wise equivalence. *4 Constructs_in_Lang_and_Addr_Expressions? Supported constructs in language and address expressions for BLISS follow: Symbol Construct [ ] Subscripting [fldname] Field selection Bit field selection 4 Data_Types% Supported BLISS data types follow:> BLISS Data Type Operating System Data Type Name/ BYTE Byte Integer (B)/ WORD Word Integer (W)3 LONG / Longword Integer (L)+ QUAD (Alpha and Integrity Quadword (Q) servers-specific)1 BYTE UNSIGNED Byte Unsigned (BU)1 WORD UNSIGNED Word Unsigned (WU)5 LONG UNSIGNED Longword Unsigned (LU)5 QUAD UNSIGNED (Alpha Quadword Unsigned (QU) and Integrity servers- specific)% VECTOR (None)% BITVECTOR (None)% BLOCK (None)% BLOCKVECTOR 0 (None)% REF VECTOR (None)% REF BITVECTOR (None)% REF BLOCK (None)% REF BLOCKVECTOR (None) 3 C; The following subtopics describe debugger support for C. $4 Operators_in_Language_Expressions9 Supported C operators in language expressions include: Kind Symbol Function Prefix * Indirection Prefix & Address of Prefix sizeof size of Infix + Addition1! Infix * Multiplication Infix / Division Infix % Remainder Infix << Left shift Infix >> Right shift Infix == Equal to Infix != Not equal to Infix > Greater than+ Infix >= Greater than or equal to Infix < Less than( Infix <= Less than or equal to Prefix ~ Bit-wise NOT (tilde) Infix & Bit-wise AND Infix | Bit-wise OR( Infix 2 ^ Bit-wise exclusive OR Prefix ! Logical NOT Infix && Logical AND Infix || Logical ORD Because the exclamation point (!) is an operator in C, it cannot@ be used as the comment delimiter. When the language is set toC C, the debugger instead accepts /* as the comment delimiter. TheC comment continues to the end of the current line. (A matching */B is neither needed nor recognized.) To permit debugger log filesA to be used as debugger inpu 3t, the debugger still recognizes anC exclamation point (!) as a comment delimiter if it is the first nonspace character on a line.B The debugger accepts the prefix asterisk (*) as an indirection? operator in both C language expressions and debugger addressC expressions. In address expressions, prefix "*" is synonymous to3 prefix "." or "@" when the language is set to C.@ The debugger does not support any of the assignment operators> in C (or any other language) in o4rder to prevent unintendedD modifications to the program being debugged. Hence such operatorsD as =, +=, ++, and -- are not recognized. To alter the contents of? a memory location, you must use an explicit DEPOSIT command. *4 Constructs_in_Lang_and_Addr_ExpressionsA Supported constructs in language and address expressions for C follow: Symbol Construct [ ] Subscripting+ . Structure component selection (period)# -> Pointer de5referencing 4 Data_Types! Supported C data types follow:> C Data Type Operating System Data Type Name3 __int64 (Alpha and Quadword Integer (Q) Integrity servers specific)5 unsigned __int64 (Alpha Quadword Unsigned (QU) specific)3 __int32 (Alpha and Longword Integer (L) Integrity servers specific)5 unsigned __int32 (Alpha Longword Unsigned (LU) and Integrity servers specific)3 int 6 Longword Integer (L)5 unsigned int Longword Unsigned (LU)/ __int16 (Alpha and Word Integer (W) Integrity servers specific)1 unsigned __int16 (Alpha Word Unsigned (WU) and Integrity servers specific)/ short int Word Integer (W)1 unsigned short int Word Unsigned (WU)/ char Byte Integer (B)1 unsigned char Byte Unsigned (BU)- float F_F7loating (F)- __f_float (Alpha and F_Floating (F) Integrity servers specific)- double D_Floating (D)- double G_Floating (G)- __g_float (Alpha and G_Floating (G) Integrity servers specific)3 float (Alpha and IEEE S_Floating (FS) Integrity servers specific)3 __s_float (Alpha and IEEE S_Floating (FS) Integrity servers specific)3 double (Alpha and IEEE T_Floating (8FT) Integrity servers specific)3 __t_float (Alpha and IEEE T_Floating (FT) Integrity servers specific)% enum (None)% struct (None)% union (None)% Pointer Type (None)% Array Type (None)@ Floating-point numbers of type float may be represented by F_? Floating or IEEE S_Floating, depending on compiler switches.C Floating-point numbers of type doub9le may be represented by IEEE? T_Floating, D_Floating, or G_Floating, depending on compiler switches. 4 Case_Sensitivity? Symbol names are case sensitive for language C, meaning that; uppercase and lowercase letters are treated as different characters. !4 Static_and_Nonstatic_Variables; Variables of the following storage classes are allocated8 statically: static, globaldef, globalref, and extern.; Variables of the following storage classes are allocate:dC nonstatically (on the stack or in registers): auto and register.B Such variables can be accessed only when their defining routine! is active (on the call stack). 4 Scalar_Variables= You can specify scalar variables of any C type in debugger@ commands exactly as you would specify them in the source code of the program.@ The following paragraphs provide additional information about char variables and pointers.= The char variables are interpreted by the d;ebugger as byteD integers, not ASCII characters. To display the contents of a charA variable ch as a character, you must use the /ASCII qualifier: DBG> EXAMINE/ASCII ch SCALARS\main\ch: "A"> You also must use the /ASCII qualifier when depositing into@ a char variable, to translate the byte integer into its ASCII equivalent. For example: DBG> DEPOSIT/ASCII ch = 'z' DBG> EXAMINE/ASCII ch SCALARS\main\ch: "z"= The following example shows use o<f pointer syntax with the9 EXAMINE command. Assume the following declarations and assignments: static long li = 790374270; static int *ptr = &li; DBG> EXAMINE *ptr% *SCALARS\main\ptr: 790374270 4 ArraysB The debugger handles C arrays as for most other languages. That? is, you can examine an entire array aggregate, a slice of anA array, or an individual array element, using array syntax (forC example EXAMINE arr[3]). And you can deposit into = only one array element at a time. 4 Character_StringsB Character strings are implemented in C as null-terminated ASCIID strings (ASCIZ strings). To examine and deposit data in an entireA string, use the /ASCIZ (or /AZ) qualifier so that the debugger@ can interpret the end of the string properly. You can examine> and deposit individual characters in the string using the CC array subscripting operators ([ ]). When you examine and deposit3 individual characters, use >the /ASCII qualifier.5 Assume the following declarations and assignments: static char *s = "vaxie"; static char **t = &s;@ The EXAMINE/AZ command displays the contents of the character# string pointed to by *s and **t: DBG> EXAMINE/AZ *s *STRING\main\s: "vaxie" DBG> EXAMINE/AZ **t" **STRING\main\t: "vaxie"< The DEPOSIT/AZ command deposits a new ASCIZ string in theA variable pointed to by *s. The EXAMINE/AZ command displays the new conte?nts of the string: DBG> DEPOSIT/AZ *s = "DEC C" DBG> EXAMINE/AZ *s, **t *STRING\main\s: "DEC C"# **STRING\main\t: "DEC C"B You can use array subscripting to examine individual charactersC in the string and deposit new ASCII values at specific locationsD within the string. When accessing individual members of a string,B use the /ASCII qualifier. A subsequent EXAMINE/AZ command shows4 the entire string containing the deposited value: DBG> EXAMINE/ASCI@I s[3] [3]: " " DBG> DEPOSIT/ASCII s[3] = "-" DBG> EXAMINE/AZ *s, **t *STRING\main\s: "VAX-C" **STRING\main\t: "VAX-C" 4 Structures_and_UnionsB You can examine structures in their entirety or on a member-by-A member basis, and deposit data into structures one member at a time.@ To reference members of a structure or union, use the usual CB syntax for such references. That is, if variable p is a pointerD to a structure, you can reference membe Ar y of that structure with@ the expression p ->y. If variable x refers to the base of theB storage allocated for a structure, you can refer to a member of* that structure with the x.y expression.B The debugger uses C type-checking rules to reference members of@ a structure or union. For example, in the case of x.y, y need@ not be a member of x; it is treated as an offset with a type.A When such a reference is ambiguous-when there is more than oneA structure with a member y-t Bhe debugger attempts to resolve theA reference according to the following rules. The same rules forD resolving the ambiguity of a reference to a member of a structure( or union apply to both x.y and p ->y.@ o If only one of the members, y, belongs in the structure or3 union, x, that is the one that is referenced.D o If only one of the members, y, is in the same scope as x, then) that is the one that is referenced.D You can always give a path name with the refeCrence to x to narrow@ the scope that is used and to resolve the ambiguity. The same- path name is used to look up both x and y. 3 C++_V5.5_and_Later (Alpha only.)> On Alpha and Integrity server systems, the OpenVMS debuggerD provides enhanced support for debugging C++ modules compiled withA the Version 5.5 compiler or later (Alpha and Integrity servers only).4 The debugger supports the following C++ features:+ o C++ names and expressions, including:=D - Explicit and implicit this pointer to refer to class members' - Scope resolution operator (::)A - Member access operators: period (.) and right arrow (->) - Template instantiations - Template names o Setting breakpoints in:A - Member functions, including static and virtual functions - Overloaded functions% - Constructors and destructors - Template instantiations - Operators7 o ECalling functions, including overloaded functionsB o Debugging programs containing a mixture of C++ code and code in other languages= The following subtopics describe debugger support for C++. $4 Operators_in_Language_Expressions: Supported C++ operators in language expressions follow: Kind Symbol Function Prefix * Indirection Prefix & Address of Prefix sizeof size of) Prefix - Unary minus (negation) Infix + F Addition Infix - Subtraction! Infix * Multiplication Infix / Division Infix % Remainder Infix << Left shift Infix >> Right shift Infix == Equal to Infix != Not equal to Infix > Greater than+ Infix >= Greater than or equal to Infix < Less than( Infix <= Less than or equal to Prefix ~ Bit-wise NOT (tilde) Infix & Bit-wise AND G Infix | Bit-wise OR( Infix ^ Bit-wise exclusive OR Prefix ! Logical NOT Infix && Logical AND Infix || Logical ORB Because the exclamation point (!) is an operator, it cannot beB used in C++ programs as a comment delimiter. However, to permit@ debugger log files to be used as debugger input, the debuggerD interprets ! as a comment delimiter when it is the first nonspace? character on a line. In C++ language mode, the debugger a HlsoC interprets /* or // as preceding a comment that continues to the end of the current line.B The debugger accepts the asterisk (*) prefix as an indirectionA operator in both C++ language expressions and debugger addressB expressions. In address expressions, the * prefix is synonymousC with either the period (.) prefix or at sign (@) prefix when the$ debugger is in C++ language mode.; To prevent unintended modifications to the program being@ debugged, the debugIger does not support any of the assignmentA operators in C++ (or any other language). Thus, such operatorsD as =, +=, -=, ++, and -- are not recognized in debugger commands.? To alter the contents of a memory location, you must use the debugger DEPOSIT command. *4 Constructs_in_Lang_and_Addr_ExpressionsC Supported constructs in language and address expressions for C++ follow: Symbol Construct [ ] Subscripting+ . Structure component seleJction (period)# -> Pointer dereferencing :: Scope resolution 4 Data_Types# Supported C++ data types follow:> C++ Data Type Operating System Data Type Name3 __int64 (Alpha and Quadword Integer (Q) Integrity servers)5 unsigned __int64 (Alpha Quadword Unsigned (QU) and Integrity servers)3 __int32 (Alpha and Longword Integer (L) Integrity servers)5 unsigned __int32 (Alpha Longword Unsign Ked (LU) and Integrity servers)3 int Longword Integer (L)5 unsigned int Longword Unsigned (LU)/ __int16 (Alpha and Word Integer (W) Integrity servers)1 unsigned __int16 (Alpha Word Unsigned (WU) and Integrity servers)/ short int Word Integer (W)1 unsigned short int Word Unsigned (WU)/ char Byte Integer (B)1 unsigned char Byte Unsigned (BU)- L float F_Floating (F)- __f_float (Alpha and F_Floating (F) Integrity servers)- double D_Floating (D)- double G_Floating (G)- __g_float (Alpha and G_Floating (G) Integrity servers)3 float (Alpha and IEEE S_Floating (FS) Integrity servers)3 __s_float (Alpha and IEEE S_Floating (FS) Integrity servers)3 double (Alpha and IEEE T_Floating (FT) IntegMrity servers)3 __t_float (Alpha and IEEE T_Floating (FT) Integrity servers)% enum (None)% struct (None)% class (None)% union (None)% Pointer Type (None)% Array Type (None)@ Floating-point numbers of type float may be represented by F_? Floating or IEEE S_Floating, depending on compiler switches.C Floating-point numbers of type doNuble may be represented by IEEE? T_Floating, D_Floating, or G_Floating, depending on compiler switches. 4 Case_SensitivityD Symbol names are case sensitive in C++. This means that uppercase= and lowercase letters are treated as different characters. '4 Displaying_Information_About_a_ClassB Use the command SHOW SYMBOL to display static information about? a class declaration. Use the command EXAMINE to view dynamic@ information about class objects (see DisplayiOng Info About an Object).D The command SHOW SYMBOL/FULL displays the class type declaration, including:2 Data members (including static data members): Member functions (including static member functions)" Constructors and destructors& Base classes and derived classes For example: dbg> SHOW SYMBOL /TYPE C type C0 struct (C, 13 components), size: 40 bytes overloaded name C instance C::C(void)" instance C::C(cons Pt C &) dbg> SHOW SYMBOL /FULL C type C0 struct (C, 13 components), size: 40 bytes6 inherits: B1, size: 24 bytes, offset: 0 bytes7 B2, size: 24 bytes, offset: 12 bytes( contains the following members: overloaded name C::g$ instance C::g(int)% instance C::g(long)% instance C::g(char)@ j : longword integer, size: 4 bytes, offset: 24 bytesD s : longword integer,Q size: 4 bytes, address: # [static] overloaded name C int ==(C &) C & =(const C &)# void h(void) [virtual] ~C(void)F __vptr : typed pointer type, size: 4 bytes, offset: 4 bytesF __bptr : typed pointer type, size: 4 bytes, offset: 8 bytesE structure has been padded, size: 4 bytes, offset: 36 bytes overloaded name C instance C::C(void)" instance C::C(const C &) DBG>> Not Re that SHOW SYMBOL/FULL does not display members of base@ classes or derived classes. Use the commands SHOW SYMBOL/FULL= base_class_name and SHOW SYMBOL/FULL derived_class_name toC display information about members of those classes. For example: DBG> SHOW SYMBOL /FULL B1 type B10 struct (B1, 8 components), size: 24 bytes inherits: virtual A is inherited by: C( contains the following members:? i : longword integer, size: 4 bytes, offsSet: 0 bytes overloaded name B1 void f(void) B1 & =(const B1 &)# void h(void) [virtual]F __vptr : typed pointer type, size: 4 bytes, offset: 4 bytesF __bptr : typed pointer type, size: 4 bytes, offset: 8 bytesF structure has been padded, size: 12 bytes, offset: 12 bytes overloaded name B1 instance B1::B1(void)% instance B1::B1(const B1 &) DBG>@ Use the command SHOW SYMBOL/FULL clTass_member_name to display0 information about class members. For example: DBG> SHOW SYMBOL /FULL j record component C::j8 address: offset 24 bytes from beginning of record3 atomic type, longword integer, size: 4 bytes record component A::j7 address: offset 4 bytes from beginning of record3 atomic type, longword integer, size: 4 bytes DBG>C Use the SHOW SYMBOL/FULL command to display detailed information about an object.D Note that SUHOW SYMBOL does not currently support qualified names.C For example, the following commands are not currently supported:+ SHOW SYMBOL object_name.function_name) SHOW SYMBOL class_name::member_name "4 Displaying_Info_About_an_ObjectC The debugger uses C++ symbol lookup rules to display information@ about objects. Use the command EXAMINE to display the current# value of an object. For example: DBG> EXAMINE a! CXXDOCEXAMPLE\main\a: struct A i: 0V j: 1 __vptr: 131168 DBG>B You can also display individual object members using the member> access operators, period (.) and right arrow (->), with the EXAMINE command. For example: DBG> EXAMINE ptr% CXXDOCEXAMPLE\main\ptr: 40 DBG> EXAMINE *ptr$ *CXXDOCEXAMPLE\main\ptr: struct A i: 0 j: 1 __vptr: 131168 DBG> EXAMINE a.i CXXDOCEXAMPLE\main\a.i: 0 DBG> EXAMINE ptr->i$ CXXDOCEXAMPLE\main\ptr->iW: 0 DBG>= The debugger correctly interprets virtual inheritance. For example: DBG> EXAMINE c! CXXDOCEXAMPLE\main\c: struct C inherit B1 inherit virtual A i: 8 j: 9! __vptr: 131200 i: 10 __vptr: 131232 __bptr: 131104 inherit B2: inherit virtual A (already printed, see above) i: 11 __vptr: 131280 X __bptr: 131152 j: 12 __vptr: 131232 __bptr: 131104 DBG>= Use the scope resolution operator (::) to reference global= variables, to reference hidden members in base classes, to@ explicitly reference a member that is inherited, or otherwise? to name a member hidden by the current context. For example: DBG> EXAMINE c.j CXXDOCEXAMPLE\main\c.j: 12 DBG> EXAMINE c.A::j$ CXXDOCEXAMPLE\main\c.A::j: 9 DBG> EXAMINE x Y CXXDOCEXAMPLE\main\x: 101 DBG> EXAMINE ::x CXXDOCEXAMPLE\x: 13 DBG>A To resolve ambiguous member references, the debugger lists theA members that satisfy the reference and requests an unambiguous( reference to the member. For example: DBG> EXAMINE c.i? %DEBUG-I-AMBIGUOUS, 'i' is ambiguous, matching the following! CXXDOCEXAMPLE\main\c.B1::i! CXXDOCEXAMPLE\main\c.B2::iF %DEBUG-E-REENTER, reenter the command using a more precise pathnameZ DBG> EXAMINE c.B1::i% CXXDOCEXAMPLE\main\c.B1::i: 10 DBG>A Use the scope resolution operator (::) to refer to static data members. For example: DBG> EXAMINE c.s CXXDOCEXAMPLE\main\c.s: 42 DBG> EXAMINE C::s C::s: 42 DBG>B Use the SHOW SYMBOL/FULL to display the class type of an object. (see Displaying Information About a Class). 4 Setting_WatchpointsA You can set watchpoints on objects. All nonstatic data members= are watch[ed (including those in base classes). Static dataC members are not watched when you set a watchpoint on the object.= However, you can explicitly set watchpoints on static data members. For example: DBG> SET WATCH cF %DEBUG-I-WPTTRACE, non-static watchpoint, tracing every instruction DBG> GOC watch of CXXDOCEXAMPLE\main\c.i at CXXDOCEXAMPLE\main\%LINE 50+8 50: c.B2::i++; old value: 11 new value: 12' break at CXXDOCEXAMPLE\main\%LINE 51 \ 51: c.s++; DBG> SET WATCH c.s DBG> GOD watch of CXXDOCEXAMPLE\main\c.s at CXXDOCEXAMPLE\main\%LINE 51+16 51: c.s++; old value: 43 new value: 44' break at CXXDOCEXAMPLE\main\%LINE 53 53: b1.f(); DBG> 4 Debugging_FunctionsC The debugger uses C++ symbol lookup rules to display information$ on member functions. For example: DBG> EXAMINE /SOURCE b1.f module CXXDOCEXAMPLE 14: void f() {} DBG> SE]T BREAK B1::f DBG> GO break at routine B1::f 14: void f() {} DBG>D The debugger correctly interprets references to the this pointer. For example: DBG> EXAMINE this B1::f::this: 16 DBG> EXAMINE *this *B1::f::this: struct B1 inherit virtual A i: 2 j: 3 __vptr: 131184 i: 4 __vptr: 131248 __bptr: 131120 DBG> EXAMINE this->i B1::f::this->i: 4^ DBG> EXAMINE this->j B1::f::this->A::j: 3 DBG>EXAMINE i B1::f::this->i: 4 DBG> EXAMINE j B1::f::this->A::j: 3 DBG>B The debugger correctly references virtual member functions. For example: DBG> EXAMINE /SOURCE %LINE 53 module CXXDOCEXAMPLE 53: b1.f(); DBG> SET BREAK this->h DBG> SHOW BREAK breakpoint at routine B1::f breakpoint at routine B1::h !!6 !! We are at the call to B1::f made at 'c.B1::f()'. _ !! Here this->h matches C::h. !! DBG> GO break at routine B1::f 14: void f() {} DBG> EXAMINE /SOURCE %LINE 54 module CXXDOCEXAMPLE 54: c.B1::f(); DBG> SET BREAK this->h DBG> SHOW BREAK breakpoint at routine B1::f breakpoint at routine B1::h breakpoint at routine C::h !!# !! Handling overloaded functions !! DBG> show symbol/full g overloaded name C::g routine C::g(char) type signature: void g(char)`# address: 132224, size: 128 bytes routine C::g(long) type signature: void g(long)" address: 132480, size: 96 bytes DBG> SET BREAK g/ %DEBUG-I-NOTUNQOVR, symbol 'g' is overloaded overloaded name C::g instance C::g(int) instance C::g(long) instance C::g(char)F %DEBUG-E-REENTER, reenter the command using a more precise pathname DBG> SET BREAK g(int) DBG> CANCEL BREAK/ALL DBG>D If you try to set a break on an overlaoaded function, the debuggerD lists the instances of the function and requests that you specify@ the correct instance. For example, with Debugger Version 7.2: DBG> SET BREAK g/ %DEBUG-I-NOTUNQOVR, symbol 'g' is overloaded overloaded name C::g instance void g(int) instance void g(long)! instance void g(char *)F %DEBUG-E-REENTER, reenter the command using a more precise pathname DBG> SET BREAK g(int) DBG>& b NOTEA The means of displaying and specifying overloaded functions= is different than in the OpenVMS Debugger Version 7.1C.< The debugger provides support for debugging constructors,+ destructors, and operators. For example: DBG> SET BREAK C/ %DEBUG-I-NOTUNQOVR, symbol 'C' is overloaded overloaded name C instance C::C(void)" instance C::C(const C &)F %DEBUG-E-REENTER, reenter the command using a more precise pathname DBG> SHOW ScYMBOL /FULL ~C routine C::~C type signature: ~C(void)' code address: #, size: 152 bytes& procedure descriptor address: # DBG> SET BREAK ~C DBG> SET BREAK %NAME'=='I %DEBUG-W-UNALLOCATED, '==' is not allocated in memory (optimized away)7 %DEBUG-E-CMDFAILED, the SET BREAK command has failed DBG> SHOW SYMBOL /FULL ==, routine c::operator==, type signature: bool operator==© code address: 198716, size:! 40 bytes, procedure descriptor adddress: 65752 DBG> SET BREAK operator== DBG> SHOW SYMBOL /FULL == routine C::==" type signature: int ==(C &) address: unallocated DBG> SHOW BREAK breakpoint at routine C::~C DBG> DBG> examine C::~C( C::~C: alloc r35 = ar.pfs, 3F, 01, 00 DBG> DBG> ex/source ~C module CXXDOCEXAMPLE 37: ~C() {} *4 Limitations_on_Debugger_Support_for_C++@ The following limitations apply when you debug a C++ program:B o You cannot specify e a template by name in a debugger command.A You must use the name of the instantiation of the template.B o In C++, expressions in the instantiated template name can beA full constant expressions, such as stack. ThisC form is not yet supported in the debugger; you must enter theC value of the expression (for example, if f is 10 in the stack# example, you must enter 100). 3 COBOL? The following subtopics describe debugger support for COBOLf. $4 Operators_in_Language_Expressions= Supported COBOL operators in language expressions include: Kind Symbol Function Prefix + Unary plus Infix + Addition! Infix * Multiplication Infix / Division Infix = Equal to Infix NOT = Not equal to Infix > Greater than+ Infix NOT < Greater than or equal to Infix < Less than( Infix NOT > Less than or equal to Infix NOT g Logical NOT Infix AND Logical AND Infix OR Logical OR 14 Constructs_in_Language_and_Address_Expressions? Supported constructs in language and address expressions for COBOL follow: Symbol Construct ( ) Subscripting$ OF Record component selection$ IN Record component selection 4 Data_Types% Supported COBOL data types follow:> COBOL Data Type Operating System Data Type Name6 COMP h Longword Integer (L,LU)2 COMP Word Integer (W,WU)6 COMP Quadword Integer (Q,QU)- COMP-1 F_Floating (F). COMP-1 (Alpha and S_Floating (FS) Integrity servers specific)- COMP-2 D_Floating (D). COMP-2 (Alpha and T_Floating (FT) Integrity servers specific)1 COMP-3 Packed Decimal (P)3 INDEX Longword Integer (L)- i Alphanumeric ASCII Text (T)% Records (None)< Numeric Unsigned Numeric string, unsigned (NU)A Leading Separate Sign Numeric string, left separate sign# (NL)D Leading Overpunched Sign Numeric string, left overpunched sign$ (NLO)B Trailing Separate Sign Numeric string, right separate sign# (NR)@ Trailing Overpunched Sign Numer jic string, right overpunched) sign (NRO)A Floating-point numbers of type COMP-1 may be represented by F_? Floating or IEEE S_Floating, depending on compiler switches.A Floating-point numbers of type COMP-2 may be represented by D_? Floating or IEEE T_Floating, depending on compiler switches. 4 Source_DisplayC The debugger can show source text included in a program with theA COPY, COPY REPLACING, or REPLACE statement. However, when COP kY@ REPLACING or REPLACE is used, the debugger shows the originalC source text instead of the modified source text generated by the' COPY REPLACING or REPLACE statement.@ The debugger cannot show the original source lines associatedC with the code for a REPORT section. You can see the DATA SECTIONA source lines associated with a REPORT, but no source lines are? associated with the compiled code that generates the report. 54 COBOL_INITIALIZE_Statement_and_Arrays_(Alphla_Only) Alpha systems only.? On OpenVMS Alpha systems, the debugger can take an unusuallyD great amount of time and resources if you use the STEP command toB execute an INITIALIZE statement in a COBOL program when a large& table (array) is being initialized.= To work around this problem, set a breakpoint on the first= executable line past the INITIALIZE statement, rather than, stepping across the INITIALIZE statement. 3 FortranA The following subtopics descrmibe debugger support for Fortran. $4 Operators_in_Language_Expressions? Supported Fortran operators in language expressions include: Kind Symbol Function Prefix + Unary plus Infix + Addition! Infix * Multiplication Infix / Division Infix // Concatenation Infix .EQ. Equal to Infix == Equal to Infix .NE. Not equal to Infix /= Not equal to Infix .GT. Greater than n Infix > Greater than+ Infix .GE. Greater than or equal to+ Infix >= Greater than or equal to Infix .LT. Less than Infix < Less than( Infix .LE. Less than or equal to( Infix <= Less than or equal to Prefix .NOT. Logical NOT Infix .AND. Logical AND Infix .OR. Logical OR Infix .XOR. Exclusive OR Infix .EQV. Equivalence Infix .NEQV. Exclusive OR 14 Constructs_in_Language_and_Addresos_Expressions? Supported constructs in language and address expressions for Fortran follow: Symbol Construct ( ) Subscripting, . (period) Record component selection, % (percent Record component selection sign) 4 Predefined_Symbols/ Supported Fortran predefined symbols follow: Symbol Description .TRUE. Logical True .FALSE. Logical False 4 Data_Types' Supported Fortran data types follow:> F portran Data Type Operating System Data Type Name1 LOGICAL*1 Byte Unsigned (BU)1 LOGICAL*2 Word Unsigned (WU)5 LOGICAL*4 Longword Unsigned (LU)5 LOGICAL*8 (Alpha and Quadword Unsigned (QU) Integrity servers specific)' BYTE Byte (B)/ INTEGER*1 Byte Integer (B)/ INTEGER*2 Word Integer (W)3 INTEGER*4 Longword Integer (Lq)3 INTEGER*8 (Alpha and Quadword Integer (Q) Integrity servers specific)- REAL*4 F_Floating (F)3 REAL*4 (Alpha and IEEE S_Floating (FS) Integrity servers specific)- REAL*8 D_Floating (D)- REAL*8 G_Floating (G)3 REAL*8 (Alpha and IEEE T_Floating (FT) Integrity servers specific)- REAL*16 (Alpha and H_Floating (H) Integrity servers specific)- CrOMPLEX*8 F_Complex (FC)3 COMPLEX*8 (Alpha and IEEE S_Floating (SC) Integrity servers specific)- COMPLEX*16 D_Complex (DC)- COMPLEX*16 G_Complex (GC)3 COMPLEX*16 (Alpha IEEE T_Floating (TC) and Integrity servers specific)- CHARACTER ASCII Text (T)% Arrays (None)% Records (None)= Even though the data type codes for unsigned inte sgers (BU,? WU, LU, QU) are used internally to describe the LOGICAL dataC types, the debugger (like the compiler) treats LOGICAL variables< and values as being signed when they are used in language expressions.A The debugger prints the numeric values of LOGICAL variables orC expressions instead of .TRUE. or .FALSE. Normally, only the low-@ order bit of a LOGICAL variable or value is significant (0 isA .FALSE. and 1 is .TRUE.). However, Fortran does allow all bitsA i tn a LOGICAL value to be manipulated and LOGICAL values can be? used in integer expressions. For this reason, it is at timesB necessary to see the entire integer value of a LOGICAL variable6 or expression, and that is what the debugger shows.D COMPLEX constants such as (1.0,2.0) are not supported in debugger expressions.= Floating-point numbers of type REAL*4 and COMPLEX*8 may be= represented by F_Floating or IEEE S_Floating, depending on compiler switches.> Flo uating-point numbers of type REAL*8 and COMPLEX*16 may be= represented by D_Floating, G_Floating, or IEEE T_Floating," depending on compiler switches.9 On OpenVMS Alpha systems, the debugger cannot evaluateB expressions that contain complex variables. To work around this> problem, examine the complex variable and then evaluate the? expression using the real and imaginary parts of the complex, variable as shown by the EXAMINE command. 4 Initialization_CodeC When you vdebug a program that compiled with the /CHECK=UNDERFLOWA or /PARALLEL qualifier, a message appears, as in the following example: DBG> RUN FORMS# Language: FORTRAN, Module: FORMS Type GO to reach main program DBG>= The "Type GO to reach MAIN program" message indicates thatA execution is supended before the start of the main program, soC that you can execute initialization code under debugger control.> Entering the GO command places you at the start of the wmain> program. At that point, enter the GO command again to start> program execution, as with other types of Fortran programs. 3 MACRO-32B The following subtopics describe debugger support for MACRO-32. $4 Operators_in_Language_ExpressionsD The MACRO-32 language does not have expressions in the same senseC as high-level languages. Only assembly-time expressions and onlyB a limited set of operators are accepted. To permit the MACRO-32D programmer to use expressions x at debug-time as freely as in otherB languages, the debugger accepts a number of operators in MACRO-A 32 language expressions that are not found in MACRO-32 itself.C In particular, the debugger accepts a complete set of comparisonA and Boolean operators modeled after BLISS. It also accepts the< indirection operator and the normal arithmetic operators. Kind Symbol Function Prefix @ Indirection Prefix . Indirection Prefix + Unary plus y Infix + Addition! Infix * Multiplication Infix / Division Infix MOD Remainder Infix @ Left shift Infix EQL Equal to Infix EQLU Equal to Infix NEQ Not equal to Infix NEQU Not equal to Infix GTR Greater than( Infix GTRU Greater than unsigned+ Infix GEQ Greater than or equal to4 Infix GEQU Greater than or equal to unsigned Infix LSS Less than% Infix LSSU z Less than unsigned( Infix LEQ Less than or equal to1 Infix LEQU Less than or equal to unsigned Prefix NOT Bit-wise NOT Infix AND Bit-wise AND Infix OR Bit-wise OR( Infix XOR Bit-wise exclusive OR' Infix EQV Bit-wise equivalence *4 Constructs_in_Lang_and_Addr_Expressions? Supported constructs in language and address expressions for MACRO-32 follow: Symbol Construct [ ] Subscripting* Bit { field selection as in BLISSA The DST information generated by the MACRO-32 assembler treatsA a label that is followed by an assembler directive for storage@ allocation as an array variable whose name is the label. ThisD enables you to use the array syntax of a high-level language when' examining or manipulating such data.C In the following example of MACRO-32 source code, the label LAB44 designates hexadecimal data stored in four words:# LAB4: .WORD ^X3F,5[2],^|X3C> The debugger treats LAB4 as an array variable. For example,B the following command displays the value stored in each element (word): DBG> EXAMINE LAB4 .MAIN.\MAIN\LAB4 [0]: 003F [1]: 0005 [2]: 0005 [3]: 003C@ The following command displays the value stored in the fourth3 word (the first word is indexed as element "0"): DBG> EXAMINE LAB4[3] .MAIN.\MAIN\LAB4[3]: 03C 4 Data_Types>} MACRO-32 binds a data type to a label name according to theC assembler directive that follows the label definition. Supported MACRO-32 directives follow: MACRO-323 Directives Operating System Data Type Name& .BYTE Byte Unsigned (BU)& .WORD Word Unsigned (WU)* .LONG Longword Unsigned (LU)$ .SIGNED_BYTE Byte Integer (B)$ .SIGNED_WORD Word Integer (W)( .LONG Longword Integer (L)( .QUAD Quadwo~rd Integer (Q)" .F_FLOATING F_Floating (F)" .D_FLOATING D_Floating (D)" .G_FLOATING G_Floating (G)& (Not Packed decimal (P) applicable) 4 MACRO-32_Compiler_(AMACRO)C (Alpha only) Programmers who are porting applications written inB MACRO-32 to Alpha systems use the MACRO-32 compiler (AMACRO). AB debugging session for compiled MACRO-32 code is similar to thatD for assembled code. However, there are some important differencesB that are described in this section. For complete information onB porting these applications, see the Porting VAX MACRO Code from' OpenVMS VAX to OpenVMS Alpha manual. 5 Code_RelocationA One major difference is the fact that the code is compiled. On> a VAX system, each MACRO-32 instruction is a single machineA instruction. On an Alpha system, each MACRO-32 instruction mayA be compiled into many Alpha machine instructions. A major sideB effect of this difference is the relocation € and rescheduling ofB code if you do not specify /NOOPTIMIZE in your compile command.? After you have debugged your code, you can recompile without& /NOOPTIMIZE to improve performance. 5 Symbolic_Variables? Another major difference between debugging compiled code and< debugging assembled code is a new concept to MACRO-2, theD definition of symbolic variables for examining routine arguments.A The arguments do not reside in a vector in memory on Alpha and Integrity servers.9 In the compiled code, the arguments can reside in some combination of: o Registers2 o On the stack above the routine's stack frame@ o In the stack frame, if the argument list was "homed" or ifB there are calls out of the routine that require the register arguments to be saved.D The compiler does not require that you read the generated code to@ locate the arguments. Instead, it provides $ARGn symbols that> point to the correct argument loc ‚ations. $ARG1 is the first> argument, $ARG2 is the second argument, and so forth. TheseB symbols are defined in CALL_ENTRY and JSB_ENTRY directives, but% not in EXCEPTION_ENTRY directives. ,5 Locating_Arguments_Without_$ARGn_Symbols_? There may be additional arguments in your code for which the@ compiler did not generate a $ARGn symbol. The number of $ARGnB symbols defined for a .CALL_ENTRY routine is the maximum number@ detected by the compiler (either by automatic detecƒtion or asD specified by MAX_ARGS) or 16, whichever is less. For a .JSB_ENTRY? routine, since the arguments are homed in the caller's stackD frame and the compiler cannot detect the actual number, it always creates eight $ARGn symbols.C In most cases, you can easily find any additional arguments, but in some cases you cannot. $5 Arguments_That_Are_Easy_to_Locate/ You can easily find additional arguments if:C o The argument list is not homed, and $ARGn symbols „are defined@ to $ARG7 or higher. If the argument list is not homed, the> $ARGn symbols $ARG7 and above always point into the list@ of parameters passed as quadwords on the stack. Subsequent? arguments will be in quadwords following the last defined $ARGn symbol.? o The argument list has been homed, and you want to examineB an argument that is less than or equal to the maximum numberC detected by the compiler (either by automatic detection or asB … specified by MAX_ARGS). If the argument list is homed, $ARGnC symbols always point into the homed argument list. Subsequent? arguments will be in longwords following the last defined $ARGn symbol.D For example, you can examine arguments beyond the eighth argumentA in a JSB routine (where the argument list must be homed in the caller), as follows:+ DBG> EX $ARG8 ; highest defined $ARGn . . .0 DBG> EX .+4 ; next arg is in next long†word . . . DBG> EX .+4 ; and so on= This example assumes that the caller detected at least ten+ arguments when homing the argument list.C To find arguments beyond the last $ARGn symbol in a routine thatA did not home the arguments, proceed exactly as in the previous/ example except substitute EX .+8 for EX .+4. (5 Arguments_That_Are_Not_Easy_to_Locate2 You cannot easily find additional arguments if:C o The argument list is homed, and yo ‡u want to examine argumentsC beyond the number detected by the compiler. The $ARGn symbolsB point to the longwords that are stored in the homed argument? list. The compiler only moves as many arguments as it can@ detect into this list. Examining longwords beyond the lastD argument that was homed will result in examining various other stack context.; o The argument list is not homed, and $ARGn symbols are? defined only as high as $ARG6. In this case, ˆ the existingA $ARGn symbols will either point to registers or to quadword= locations in the stack frame. In both cases, subsequentC arguments cannot be examined by looking at quadword locations' beyond the defined $ARGn symbols.? The only way to find the additional arguments in these casesA is to examine the compiled machine code to determine where theB arguments reside. Both of these problems are eliminated if MAX_@ ARGS is specified correctly for the max‰imum argument that you want to examine. *5 Debugging_Code_with_Floating-Point_DataD The following list provides important information about debugging> compiled MACRO-32 code with floating-point data on an Alpha system:? o You can use the EXAMINE/FLOAT command to examine an Alpha2 integer register for a floating-point value.@ Even though there is a set of registers for floating-point? operations on Alpha systems, those registers are not used< by c Šompiled MACRO-32 code that contains floating-point< operations. Only the Alpha integer registers are used.= Floating-point operations in compiled MACRO-32 code are> performed by emulation routines that operate outside the= compiler. Therefore, performing MACRO-32 floating-pointC operations on, say, R7, has no effect on Alpha floating-point register 7.? o When using the EXAMINE command to examine a location thatB was declared with a .FLOAT directi‹ve or other floating-pointA storage directives, the debugger automatically displays the# value as floating-point data.; o When using the EXAMINE command to examine the G_FLOAT@ data type the debugger automatically displays the value as floating-point data.= o You can deposit floating-point data in an Alpha integer( register with the DEPOSIT command. o H_FLOAT is unsupported. *5 Debugging_Code_with_Packed_Decimal_DataD The following list Œprovides important information about debugging> compiled MACRO-32 code with packed decimal data on an Alpha system:C o When using the EXAMINE command to examine a location that wasC declared with a .PACKED directive, the debugger automatically7 displays the value as a packed decimal data type.D o You can deposit packed decimal data. The syntax is the same as it is on VAX.  3 MACRO-64A (Alpha only) The following subtopics describe debugger supp ort for MACRO-64. $4 Operators_in_Language_Expressions@ Language MACRO-64 does not have expressions in the same senseC as high-level languages. Only assembly-time expressions and onlyB a limited set of operators are accepted. To permit the MACRO-64D programmer to use expressions at debug-time as freely as in otherB languages, the debugger accepts a number of operators in MACRO-A 64 language expressions that are not found in MACRO-64 itself.C In particular, the debuggŽer accepts a complete set of comparisonA and Boolean operators modeled after BLISS. It also accepts the< indirection operator and the normal arithmetic operators. Kind Symbol Function Prefix @ Indirection Prefix . Indirection Prefix + Unary plus Infix + Addition! Infix * Multiplication Infix / Division Infix MOD Remainder Infix @ Left shift Infix EQL Equal to Infix EQLU  Equal to Infix NEQ Not equal to Infix NEQU Not equal to Infix GTR Greater than( Infix GTRU Greater than unsigned+ Infix GEQ Greater than or equal to4 Infix GEQU Greater than or equal to unsigned Infix LSS Less than% Infix LSSU Less than unsigned( Infix LEQ Less than or equal to1 Infix LEQU Less than or equal to unsigned Prefix NOT Bit-wise NOT Infix AND Bit-wise AND Infix OR  Bit-wise OR( Infix XOR Bit-wise exclusive OR' Infix EQV Bit-wise equivalence *4 Constructs_in_Lang_and_Addr_Expressions? Supported constructs in language and address expressions for MACRO-64 follow: Symbol Construct* Bit field selection as in BLISS 4 Data_TypesC MACRO-64 binds a data type to a label name according to the dataC directive that follows the label definition. For example, in theC following code fragment, the .LON‘G data directive directs MACRO-B 64 to bind the longword integer data type to labels V1, V2, and V3: .PSECT A, NOEXE .BYTE 5 V1: V2: V3: .LONG 7< To confirm the type bound to V1, V2, and V3, issue a SHOWA SYMBOL/TYPE command with a V* parameter. The following display results: data .MAIN.\V15 atomic type, longword integer, size: 4 bytes data .MAIN.\V25 atomic type, longword integer, size: 4 bytes data .MAIN.\V36 ’ atomic type, longword integer, size: 4 bytes)( Supported MACRO-64 directives follow: MACRO-643 Directives Operating System Data Type Name& .BYTE Byte Unsigned (BU)& .WORD Word Unsigned (WU)* .LONG Longword Unsigned (LU)$ .SIGNED_BYTE Byte Integer (B)$ .SIGNED_WORD Word Integer (W)( .LONG Longword Integer (L)( .QUAD Quadword Integer (Q)" .F_FLOATING F_Floating (F)" .D_FLOATING “ D_Floating (D)" .G_FLOATING G_Floating (G)" .S_FLOATING S_Floating (S) (Alpha specific)" .T_FLOATING T_Floating (T) (Alpha specific)& (Not Packed decimal (P) applicable) 3 Pascal@ The following subtopics describe debugger support for Pascal. $4 Operators_in_Language_Expressions> Supported Pascal operators in language expressions include: Kind Symbol Function Prefix + Unary plus* Infix +” Addition, concatenation! Infix * Multiplication Infix / Real division# Infix DIV Integer division Infix MOD Modulus Infix REM Remainder! Infix IN Set membership Infix = Equal to Infix <> Not equal to Infix > Greater than+ Infix >= Greater than or equal to Infix < Less than( Infix <= Less than or equal to Prefix NOT Logical NOT Infix AND Logic•al AND Infix OR Logical OR; The typecast operator (::) is not supported in language expressions. *4 Constructs_in_Lang_and_Addr_Expressions? Supported constructs in language and address expressions for Pascal follow: Symbol Construct [ ] Subscripting- . (period) Record component selection( ^ Pointer dereferencing (circumflex) 4 Predefined_Symbols. Supported Pascal predefined symbols fol–low: Symbol Meaning TRUE Boolean True FALSE Boolean False NIL Nil pointer 4 Built-In_Functions. Supported Pascal built-in functions follow: Symbol Meaning SUCC Logical successor PRED Logical predecessor 4 Data_Types& Supported Pascal data types follow:9 Pascal Data Type Operating System Data Type Name. INTEGER Longword Integer (L)- INTEGER Word Integer (W,WU)- INTEGER — Byte Integer (B,BU)0 UNSIGNED Longword Unsigned (LU), UNSIGNED Word Unsigned (WU), UNSIGNED Byte Unsigned (BU)( SINGLE, REAL F_Floating (F). REAL (Alpha and IEEE S_Floating (FS) Integrity servers specific)( DOUBLE D_Floating (D)( DOUBLE G_Floating (G). DOUBLE (Alpha and IEEE T_Floating (FT) Integrity servers specific)( QUADRUPLE (Integrity H_Floating˜ (H) servers specific) BOOLEAN (None)( CHAR ASCII Text (T)+ VARYING OF CHAR Varying Text (VT) SET (None) FILE (None) Enumerations (None) Subranges (None) Typed Pointers (None) Arrays (None) Records (None) Variant records (None)B The debugger accepts Pascal set constants such as [1,2,5,8..10]1 or [RED, BL™UE] in Pascal language expressions.? Floating-point numbers of type REAL may be represented by F_A Floating or IEEE S_Floating, depending on compiler switches or source code attributes.A Floating-point numbers of type DOUBLE may be represented by D_B Floating, G_Floating, or IEEE T_Floating, depending on compiler& switches or source code attributes. 4 Additional_Information: In general, you can examine, evaluate, and deposit into? variables, record fields, and š array components. An exceptionB to this occurs under the following circumstances: if a variable@ is not referenced in a program, the Pascal compiler might notB allocate the variable. If the variable is not allocated and youB try to examine it or deposit into it, you will receive an error message.@ When you deposit data into a variable, the debugger truncatesB the high-order bits if the value being deposited is larger thanB the variable; the debugger fills the high-order b ›its with zeros@ if the value being deposited is smaller than the variable. IfB the deposit violates the rules of assignment compatibility, the. debugger displays an informational message.C You can examine and deposit into automatic variables (within anyD active block); however, because automatic variables are allocated@ in stack storage and are contained in registers, their valuesB are considered undefined until the variables are initialized or assigned a value. 4 Rœestrictions> Restrictions in debugger support for Pascal are as follows.C You can examine a VARYING OF CHAR string, but you cannot examineD the .LENGTH or .BODY fields using the normal language syntax. ForC example, if VARS is the name of a string variable, the following commands are not supported: DBG> EXAMINE VARS.LENGTH DBG> EXAMINE VARS.BODYA To examine these fields, use the techniques illustrated in the following examples. Use Instead of) EXAMINE/WORD VARS EXAMINE VARS.LENGTH' EXAMINE/ASCII EXAMINE VARS.BODY VARS+2 3 PL-I_(Alpha_Only)> The following subtopics describe debugger support for PL/I. $4 Operators_in_Language_Expressions< Supported PL/I operators in language expressions include: Kind Symbol Function Prefix + Unary plus Infix + Addition! Infix * Multiplication Infix / Division! Infix ** Exponentiation Ižnfix || Concatenation Infix = Equal to Infix ^= Not equal to Infix > Greater than+ Infix >= Greater than or equal to+ Infix ^< Greater than or equal to Infix < Less than( Infix <= Less than or equal to( Infix ^> Less than or equal to Prefix ^ Bit-wise NOT Infix & Bit-wise AND Infix | Bit-wise OR *4 Constructs_in_Lang_and_Addr_ExpressionsD Supported constructŸs in language and address expressions for PL/I follow: Symbol Construct ( ) Subscripting+ . Structure component selection (period)# -> Pointer dereferencing 4 Data_Types$ Supported PL/I data types follow:; PL/I Data Type Operating System Data Type NameC FIXED BINARY Byte- (B), Word- (W), or Longword- (L)# Integer. FIXED DECIMAL Packed Decimal (P)* FLOAT  BIN/DEC F_Floating (F)* FLOAT BIN/DEC D_Floating (D)* FLOAT BIN/DEC G_Floating (G)# BIT Bit (V). BIT Bit Unaligned (VU)* CHARACTER ASCII Text (T)- CHARACTER VARYING Varying Text (VT)" FILE (None)" Labels (None)" Pointers (None)" Arrays (None)" Structures (None) !4 Static_and_Nons¡tatic_Variables; Variables of the following storage classes are allocated statically: STATIC EXTERNAL GLOBALDEF GLOBALREF; Variables of the following storage classes are allocated0 nonstatically (on the stack or in registers): AUTOMATIC BASED CONTROLLED DEFINED PARAMETER "4 Examining_and_Manipulating_DataD The following subtopics give examples of the EXAMINE command withC PL/I data types. They also ¢highlight aspects of debugger support that are specific to PL/I. 5 EXAMINE_Command_ExamplesD The following examples show use of the EXAMINE command with a few selected PL/I data types.? o Examine the value of a variable declared as FIXED DECIMAL (10,5): DBG> EXAMINE X PROG4\X: 540.027000 o Examine the value of a structure variable: DBG> EXAMINE PART# MAIN_PROG\INVENTORY_PROG\PART ITEM: "WF-1247" £ PRICE: 49.95 IN_STOCK: 24= o Examine the value of a pictured variable (note that the6 debugger displays the value in quotation marks): DBG> EXAMINE Q MAIN\Q: "666.3330"B o Examine the value of a pointer (which is the virtual address; of the variable it accesses) and display the value in9 hexadecimal radix instead of decimal (the default): DBG> EXAMINE/HEXADECIMAL P PROG4\SAMPLE.P: 0000B2A4B o Examine ¤the value of a variable with the BASED attribute; in@ this case, the variable X has been declared as BASED(PTR), with PTR its pointer: DBG> EXAMINE X PROG\X: "A"@ o Examine the value of a variable X declared as BASED with aD variable PTR declared as POINTER; here, PTR is associated withD X by the following line of PL/I code (instead of X having been: declared as BASED(PTR) as in the preceding example): ALLOCATE X SET (PTR);: In¥ this case, you examine the value of X as follows: DBG> EXAMINE PTR->X PROG6\PTR->X: "A" 5 Notes_on_Debugger_Support= Note the following points about debugger support for PL/I.C You cannot use the DEPOSIT command with entry or label variablesB or formats, or with entire arrays or structures. You cannot use@ the EXAMINE command with entry or label variables or formats;- instead, use the EVALUATE/ADDRESS command.@ You cannot use the EXAMINE command to ¦ determine the values orC attributes of global literals (such as GLOBALDEF VALUE literals)A because they are static expressions. Instead, use the EVALUATE command.= You cannot use the EXAMINE, EVALUATE, and DEPOSIT commands? with compile-time variables and procedures. However, you canA use EVALUATE and DEPOSIT (but not EXAMINE) with a compile-time> constant, as long as the constant is the source and not the destination.> Note that an uninitialized automatic vari §able does not have> valid contents until after a value has been assigned to it.> If you examine it before that point, the value displayed is unpredictable.< You can deposit a value into a pointer variable either byC depositing another pointer's value into it, thus making symbolicA reference to both pointers, or by depositing a virtual addressB into it. (You can find out the virtual address of a variable byD using the EVALUATE/ADDRESS command, and then deposit that address ¨> into the pointer.) When you examine a pointer, the debugger? displays its value in the form of the virtual address of the' variable that the pointer points to.A The debugger treats all numeric constants of the form n or n.n@ in PL/I language expressions as packed decimal constants, notC integer or floating-point constants, in order to conform to PL/IA language rules. The internal representation of 10 is therefore( 0C01 hexadecimal, not 0A hexadecimal.A You can ent ©er floating-point constants using the syntax nEn or n.nEn.@ There is no PL/I syntax for entering constants whose internal= representation is Longword Integer. This limitation is notC normally significant when debugging, since the debugger supportsC the PL/I type conversion rules. However, it is possible to enterA integer constants by using the debugger's %HEX, %OCT, and %BINB operators, because nondecimal radix constants are assumed to beB FIXED BINARY. For example, thªe EVALUATE/HEXADECIMAL 53 + %HEX 0 command displays 00000035. 3 Language_UNKNOWNA The following subtopics describe debugger support for language UNKNOWN. $4 Operators_in_Language_ExpressionsC Supported operators in language expressions for language UNKNOWN follow: Kind Symbol Function Prefix + Unary plus Infix + Addition! Infix * Multiplication Infix / Division Infix & Concatenation Inf«ix // Concatenation Infix = Equal to Infix <> Not equal to Infix /= Not equal to Infix > Greater than+ Infix >= Greater than or equal to Infix < Less than( Infix <= Less than or equal to Infix EQL Equal to Infix NEQ Not equal to Infix GTR Greater than+ Infix GEQ Greater than or equal to Infix LSS Less than( Infix LEQ Less than or equal to Prefix N¬OT Logical NOT Infix AND Logical AND Infix OR Logical OR Infix XOR Exclusive OR Infix EQV Equivalence *4 Constructs_in_Lang_and_Addr_Expressions? Supported constructs in language and address expressions for language UNKNOWN follow: Symbol Construct [ ] Subscripting ( ) Subscripting+ . (period) Record component selection& ^ Pointer dereferencing (circumflex) 4 P­redefined_Symbols< Supported predefined symbols for language UNKNOWN follow: Symbol Meaning TRUE Boolean True FALSE Boolean False NIL Nil pointer 4 Data_Types@ When the language is set to UNKNOWN, the debugger understands? all data types accepted by other languages except a few veryA language-specific types, such as picture types and file types.D In UNKNOWN language expressions, the debugger accepts most scalar' OpenVMS calling standard data ® types.A o For language UNKNOWN, the debugger accepts the dot-notation< for record component selection. For example, if C is a? component of a record B which in turn is a component of aA record A, then C can be referenced as A.B.C. Subscripts canB be attached to any array components; for example, if B is an4 array, then C can be referenced as A.B[2,3].C.= o For language UNKNOWN, the debugger accepts brackets and@ parentheses for subscripts. For exam¯ple, A[2,3] and A(2,3) are equivalent. 2 Logical_Names 3 DBG$DECW$DISPLAYA Specifies the debugger interface (DECwindows Motif or command)B or the display device (if you are displaying the interface on a workstation).C By default, DBG$DECW$DISPLAY is either undefined or has the same@ definition as the application-wide logical name DECW$DISPLAY.A The DECwindows Motif interface is the default on workstations.C To display the command interface instead °of the DECwindows Motif@ interface, enter the following definition before starting the debugger: $ DEFINE DBG$DECW$DISPLAY " "A For complete information about the DECwindows Motif interface,5 see the debugger's DECwindows Motif documentation. 3 DBG$INIT< If the logical name DBG$INIT is defined at the start of aA debugging session, then the file that it translates to is usedC as an initialization file. The commands in the file are executed@ as if the file ±had been called with the @ (Execute Procedure)C command. This is useful if there is a particular set of commands> that you always execute when you start up the debugger, forC example to specify a source directory search list, enable screen mode, log the session. Example: $ CREATE MY_DEBUG.COM SET SOURCE SYS$DISK:[],SRC$ SET MODE SCREEN SET STEP SILENT . . .. $ DEFINE DBG$INIT [JONES.CMD]DEBUG_INIT.COM 3 DBG$INPUT_and_DBG$OUTPUTB The val ²ue of the logical name DBG$INPUT determines the debugger/ input device. By default, this is SYS$INPUT.C The value of the logical name DBG$OUTPUT determines the debugger1 output device. By default, this is SYS$OUTPUT.= If you plan to debug a program that takes its input from a@ file and your debugger input from the terminal, establish the6 following definitions before starting the debugger:( $ DEFINE SYS$INPUT program-input-file7 $ DEFINE/PROCESS DBG$INPUT 'F$LOGICAL("³SYS$COMMAND"); That is, define DBG$INPUT to point to the translation of SYS$COMMAND.@ If you define DBG$INPUT to point to SYS$COMMAND, the debugger+ will try to get its input from the file. 3 DBG$PROCESS; The value of the logical name DBG$PROCESS determines the& debugging configuration as follows: DBG$PROCESS' Definition Configuration! DEFAULT or undefined Default& MULTIPROCESS MultiprocessD Use the default configurati ´on to debug programs that normally runC (without the debugger) in only one process. Use the multiprocessA configuration to debug programs that normally run in more than one process.C When defining DBG$PROCESS for a multiprocess configuration, makeD the definition job wide. This ensures that any processes that areC in the same job tree as the program being debugged (for example,D processes spawned by the program) can be controlled from the same debugging session.> µ For more information, see help on Debugging_Configurations. 2 MessagesB To get help about a debugger message, use the following general command format:( DBG> HELP Messages message-identifier@ where message-identifier is the keyword displayed to the left> of the message text. The additional topics list all message identifiers alphabetically.9 The following information is provided for each message: identifier: message text, explanation, and user action. ¶3 ExampleD For example, suppose the debugger displays the following message:: %DEBUG-I-INITIAL, language is BASIC, module set to TEST= In this example, the message identifier is INITIAL. To get? information about this message, enter the following command: DBG> HELP Messages INITIAL 3 Message_FormatD The following example shows the elements of a debugger diagnostic message:; %DEBUG-W-NOSYMBOL, symbol 'X' is not in the symbol table( 1 2 3 · 4 1 The facility name (DEBUG).. 2 The severity level (W, in this example).= 3 The message identifier (NOSYMBOL, in this example). The@ message identifier is an abbreviation of the message text. 4 The message text.; The identifier enables you to find the explanation for a> diagnostic message from the debugger's online help (and the$ action you need to take, if any). 3 Severity_Levels> The possible severity levels for diagnostic m¸essages are as follows: S (success) I (informational) W (warning) E (error) F (fatal, or severe error)B Success and informational messages inform you that the debugger has performed your request.C Warning messages indicate that the debugger might have performedD some, but not all, of your request and that you should verify the result.C Error messages indicate that the debugger could not perform your? request, but that the sta ¹te of the debugging session was notA changed. The only exceptions are if the message identifier wasC DBGERR or INTERR. These identifiers signify an internal debuggerC error, and you should submit a Software Performance Report (SPR) in such cases.C Fatal messages indicate that the debugger could not perform your@ request and that the debugging session is in an indeterminate? state from which you cannot recover reliably. Typically, the$ error ends the debugging session.º 3 ABORTCMD4Aborting command due to kernel debugger termination. Facility: DEBUG, VMS Debugger= Explanation: The kernel debugger terminated so the current command was aborted.@ User Action: Check the reason the kernel debugger terminated. 3 ABORTEDcommand aborted by user request Facility: DEBUG, VMS Debugger? Explanation: The command being executed was stopped when you typed CTRL-C.$ User Action: No action necessary. 3 ABSDATSYN»absolute date-time syntax error Facility: DEBUG, VMS DebuggerB Explanation: The date-time value could not be converted because& it is not in the proper VMS format.B User Action: Re-enter the date-time value using the correct VMS date-time format. 3 ACCADDCOM9access violation in address computation for address_value Facility: DEBUG, VMS DebuggerB Explanation: The address computation for the specified variable> resulted in an access violation. This normall¼y means that aC register value or a descriptor needed in the address computation! is uninitialized or corrupted.B User Action: If the necessary register or descriptor is not yetB initialized, the variable is not available at this point in theA code. If the register or descriptor is corrupted, the cause of. this error should be located and corrected. 3 ACTIVATINGprogram is activating Facility: DEBUG, VMS Debugger: Explanation: The process process-specificat½ion has just@ activated, and is now connected to the main debugger. Any SET@ BREAK/ACTIVATING or SET TRACE/ACTIVATING events will now take effect.B User Action: Submit an SPR. This message is handled internally,, and should never be signaled to the user. 3 ADDRANCOVCaddress range covers more than one module address_value is in path_"name address_value is in path_name Facility: DEBUG, VMS Debugger9 Explanation: The address range specified in a debugger@ EXAMI¾NE/SOURCE command covers more than a single module. ThisA is not allowed. The start address CZ is in module mod1 and the% end address yyy is in module mod2.@ User Action: Re-enter the command with a valid address range. 3 ADDRESSMODE6instruction uses illegal or undefined addressing modes Facility: DEBUG, VMS Debugger 3 ADDRMBZ/a must-be-zero field in an address was not zero Facility: DEBUG, VMS Debugger3 Explanation: This is an internal debugger error.¿? User Action: If the error is reproducible, submit a Software> Performance Report and, if possible, enclose both a copy ofA the program being debugged and a logged debugging session that reproduces the error. 3 ADDRREGC& not allowed on register variables: operand bound to register_name Facility: DEBUG, VMS DebuggerA Explanation: The C language & operator could not be applied to@ the given operand because the operand is a register variable.4 This is not allÀowed in the C language definition.A User Action: Do not use the & operator on a register variable. 3 ALOCMEMERRDthe debugger detected an error when trying to allocate memory for an object in routine function_name. Facility: DEBUG, VMS Debugger> Explanation: The debugger detected an error when allocating memory.A User Action: Try the debugger again, if the same results exist. submit a Software Performance Report (SPR). 3 ALPHANOSSI3static watchpoints m Áay cause memory probes to fail. Facility: DEBUG, VMS DebuggerD Explanation: The debugger implements static watchpoints by write-? protecting the page containing the variable being watched. AA system service that writes to user memory will probe for writeB access before executing the write. With static watchpoints set,> if such a system service probes a write-protected page, the@ system service will return SS$_ACCVIO instead of successfully= completing. This also holds fÂor user written routines thatA probe memory for write access. On VAX, the debugger could work= around the problem with system services via system serviceA interception. On Alpha AXP this system service interception is not yet implemented.D User Action: If this potential behavior change is not acceptable,6 reset the watchpoint without the /STATIC qualifier. 3 ALREADYCONNECTED8a debugger has already connected to the desired process. Facility: DEBUG, VMS DebuggerÃC Explanation: The process you are trying to connect to is alreadyA connected to a debugger. There can only be one connection at a time.> User Action: Disconnect the other debugger from the desired> process before attempting to reconnect your session. If theB problem cannot be solved, submit a Software Performance Report. 3 AMBFIELD%field_name is an ambiguous field name Facility: DEBUG, VMS DebuggerC Explanation: The reference to the given field cannot beÄ resolved< because there is more than one field with the given name.D User Action: Fully qualify the reference with a complete name for the desired field. 3 AMBIGQUAL%qualifier qualifier_name is ambiguous Facility: DEBUG, VMS DebuggerD Explanation: The qualifier cannot be resolved to a single option.@ There is more than one option to the command that starts with these characters.; User Action: Add more of the characters to the qualifierA string to makÅe the option unambiguous. The qualifier should be4 unambiguous when it has at least four characters. 3 AMPERSAND#operand of ampersand must be lvalue Facility: DEBUG, VMS DebuggerB Explanation: The C language & operator cannot be applied to theA result of an expression. This is not allowed in the C language definition.: User Action: Do not use the & operator in this context. 3 ARGLSTNOREADBargument list for frame frame-addr is not readable at address arg- Æaddr Facility: DEBUG, VMS DebuggerA Explanation: The debugger is attempting to chain down the call? stack, following frame pointers. The debugger has determinedD that part or all of the argument list for the frame at frame-addrA is not accessible for reading. This argument list lies at arg-D addr. This usually indicates a corrupt frame list, but could alsoB indicate that the program has protected part of memory in which4 the frame lies. In either case, this is an erroÇr.D User Action: Determine what part of your code is writing into theA FP register or overwriting the saved frame pointer on the callC stack (or a preceding saved frame pointer) and correct it. SinceC the debugger looks at the call stack to symbolize addresses, youA may suppress some of these messages by typing the command "SET MODE NOSYMBOLIC". 3 ARGNEEDSCOMCa VMS command must be specified in order to pass arguments in a RUNor RERUN command Facility: DEBUG, ÈVMS DebuggerC Explanation: In order to specify arguments on a VMS run command,@ the command must be specified using a foreign command, or setA using SET COMMAND. This VMS definition must be supplied to the5 Debugger RUN command using the /COMMAND qualifier.C User Action: Supply the proper /COMMAND qualifier along with the /ARGUMENT switch. 3 ASTARGNOREAD<AST arguments for AST frame frame-addr at astarg-addr is notreadable Facility: DEBUG, VMS DebuggerA É Explanation: The debugger is attempting to chain down the call? stack, following frame pointers. The debugger has determinedB that part or all of the AST argument array for the AST frame at@ frame-addr is not accessible for reading. This vector lies at@ astarg-addr. This usually indicates a corrupt frame list, butD could also indicate that the program has protected part of memory= in which the frame lies. In either case, this is an error.D User Action: Determine what part ofÊ your code is writing into theA FP register or overwriting the saved frame pointer on the callC stack (or a preceding saved frame pointer) and correct it. SinceC the debugger looks at the call stack to symbolize addresses, youA may suppress some of these messages by typing the command "SET MODE NOSYMBOLIC". 3 ASTWASDISABLED&ASTs were disabled, are still disabled Facility: DEBUG, VMS DebuggerC Explanation: The delivery of asynchronous system traps ASTs wereB Ë already turned off in your program when the DISABLE AST command was issued. User Action: None 3 ASTWASENABLED$ASTs were enabled, are still enabled Facility: DEBUG, VMS DebuggerC Explanation: The delivery of asynchronous system traps ASTs wereD already turned on in your program when the ENABLE AST command was issued. User Action: None 3 ATNEEDSENABLE0the /AT qualifier was specified, /ENABLE was not Facility: DEBUG, VMS Debugger> ExplanatiÌon: The /AT qualifier is only appropriate with the /ENABLE qualifier.8 User Action: Reenter the command, specifying /ENABLE. 3 ATTACHED-terminal now attached to process process_name Facility: DEBUG, VMS DebuggerA Explanation: The control of your terminal is being passed from@ the current process to another process by means of the ATTACH command. User Action: None 3 ATTREQREFattach request refused Facility: DEBUG, VMS Debugger? ExplanaÍtion: The specified process could not be attached to.B Either it was not detached or it did not belong to the caller's job.A User Action: Ensure that the specified process is detached and belongs to the caller's job. 3 BADADDSPA:attempted to compare addresses in different address spaces Facility: DEBUG, VMS Debugger3 Explanation: This is an internal debugger error.? User Action: If the error is reproducible, submit a Software> Performance Report and, iÎf possible, enclose both a copy ofA the program being debugged and a logged debugging session that reproduces the error. 3 BADADDSTACattempted to compare addresses with different address states, error'occurred comparing address with address Facility: DEBUG, VMS Debugger3 Explanation: This is an internal debugger error.? User Action: If the error is reproducible, submit a Software> Performance Report and, if possible, enclose both a copy ofA the program beingÏ debugged and a logged debugging session that reproduces the error. 3 BADBODPACKCincorrect package spec name in body-spec spec-name, module mod-name Facility: DEBUG, VMS Debugger? Explanation: The compiler has generated invalid Debug Symbol Table information.C User Action: Please submit a Software Performance Report against the compiler. 3 BADDESCR8descriptor for 'symbol_name' is bad or is not set up yet Facility: DEBUG, VMS Debugger? ExpÐlanation: The descriptor for the given symbol points into. memory that cannot be read by the Debugger.' User Action: Correct the descriptor. 3 BADDISCVAL<incorrect value of tag_value in discriminant field tag_name. Facility: DEBUG, VMS DebuggerA Explanation: The discriminate value you gave was out of range.> User Action: Supply a discriminate value that is within the correct range. 3 BADDST*bad debugger symbol table (compiler error) Facility: DÑEBUG, VMS Debugger? Explanation: The debugger has detected an error in the DebugD Symbol Table of your program. This indicates an internal error in6 either the debugger or the compiler of this module.< User Action: Please submit a Software Performance Report. 3 BADDSTVERBinvalid version info for module !AC (generated by !AC)!/!_ExpectedV!UW.!UW, got V!UW.!UW Facility: DEBUG, VMS Debugger= Explanation: The compiler-generated Debug Symbol Table for? the specifiÒed module does not contain a valid version number identifier.C User Action: Submit an SPR to the compiler or assembler that wasB used to compile the module. Include the compiler version number: and a sample source program which reproduces the error. 3 BADEVNPAR:parameter does not have permitted data type for this event Facility: DEBUG, VMS Debugger? Explanation: The event you specified cannot be used with theB specified symbol. For example, you cannot specify tÓhe RUN event@ except on TASK type symbols. Please see the documentation forD details on which events can be specified with which symbol types.? User Action: Specify the correct symbol type for this event. 3 BADEXH*the user-mode exit handler list is corrupt Facility: DEBUG, VMS DebuggerB Explanation: While walking the list of user-mode exit handlers,; the debugger detected a forward link which pointed to an# inaccessible exit control block.A User Action: ChÔeck for a call to the SYS$DCLEXH system service> that specifies an illegal exit control block argument. AlsoB verify that exit control blocks are not getting corrupted later in the program. 3 BADFRAME@bad FP or bad saved FP at pointer-addr in call stack, can't readframe near frame-addr Facility: DEBUG, VMS DebuggerA Explanation: The debugger is attempting to chain down the call@ stack, following frame pointers. The FP register (if pointer-= addr is "FFFFFFFF") Õ or the saved frame pointer at location? pointer-addr points to a frame at least part of which is not, read accessible near location frame-addr.D User Action: Determine what part of your code is writing into theA FP register or overwriting the saved frame pointer on the callC stack (or a preceding saved frame pointer) and correct it. SinceC the debugger looks at the call stack to symbolize addresses, youA may suppress some of these messages by typing the command "SET MÖODE NOSYMBOLIC". 3 BADHANDLE,non-existent object handle passed to routine Facility: DEBUG, VMS Debugger< Explanation: The debugger uses object handles for passingA information around within itself. The debugger has used a non-? existent or corrupt handle for an operation. The user should never see this message.: User Action: Submit a Software Performance Report (SPR) 3 BADINCAR,the target system has the wrong incarnation. Facility: DEBUG, VMS Debugg×erC Explanation: After a network failure, the debugger has attemptedB to re-connect to the target system. However, the target systems? incarnation value does not match the last known incarnation,@ therefore this debug session is no longer valid. This is most- likely due to the target system rebooting.B User Action: Start up the debugger and target system again from scratch. 3 BADOPCODEopcode opcode_name is unknown Facility: DEBUG, VMS Debugger= ExplaØnation: The opcode opcode_name specified as a command@ parameter is unknown to the debugger. It may be the case thatB an opcode synonym has been specified which is not recognized by the debugger.C User Action: Specify a valid opcode or specify an opcode synonym that the debugger recognizes. 3 BADPARAMbad parameter value Facility: DEBUG, VMS DebuggerB Explanation: This message indicates an internal debugger error.5 User Action: Submit a Software PerformaÙnce Report. 3 BADSCOPE-invalid pathname path_name, SCOPE not changed Facility: DEBUG, VMS Debugger> Explanation: The scope path_name specified in the SET SCOPE4 command contained a pathname that does not exist.& User Action: Specify a valid scope. 3 BADSIGARGCbad sigarg pointer at pointer-addr or bad sigarg vector, can't readsigarg vector near sigarg-addr Facility: DEBUG, VMS DebuggerA Explanation: The debugger is attempting to chain down the call ÚD stack, following frame pointers, and has encountered an exception@ handler. The signal argument pointer at location pointer-addrC points to a signal argument vector at least part of which is not- read accessible near location sigarg-addr.? User Action: Determine what part of your code is overwriting@ the stored signal argument pointer on the call stack, or partB of the signal argument vector itself, and correct it. Since theC debugger looks at the call stack to symbolizeÛ addresses, you mayB suppress some of these messages by typing the command "SET MODE NOSYMBOLIC". 3 BADSTACK+stack corrupted - no further data available Facility: DEBUG, VMS Debugger< Explanation: While displaying part of the call stack, theA debugger has determined that the stack is corrupted and cannot" continue executing the command.? User Action: See the secondary message for more information. 3 BADSTARTPC&cannot access start PC = address_value Ü Facility: DEBUG, VMS DebuggerC Explanation: Location address_value is not an accessible address> and therefore cannot be executed. This is often caused when> a GO command with no address specification is entered after? the program has terminated. The debugger tries to execute an6 instruction at location 0, which is not accessible.C User Action: Specify a different address specification in the GOC command or, if the program has terminated, you can exit from the> dÝebugger and initiate the program with the DCL command RUN. 3 BADSTATUS%bad status returned from routine-name Facility: DEBUG, VMS DebuggerD Explanation: The debugger got an unexpected error status from the. system service or RTL routine routine-name.= User Action: Examine the error message and consider if the@ problem is related to a lack of quota or otherwise related toC your program's behavior. If so, then take corrective action. If,B after this evaluation, yoÞu believe that the problem lies in the7 debugger, then submit a Software Performance Report. 3 BADSUBPAR=incorrect parent name in subunit sym-name, in module mod-name Facility: DEBUG, VMS Debugger? Explanation: The compiler has generated invalid Debug Symbol Table information.C User Action: Please submit a Software Performance Report against the compiler. 3 BADTAGVAL3incorrect value of tag_value in tag field tag_name. Facility: DEBUG, VMS Debuggßer8 Explanation: The tag value you gave was out of range.> User Action: Supply a tag that is within the correct range. 3 BADTARGET1target location protected, cannot perform deposit Facility: DEBUG, VMS DebuggerC Explanation: The target address of the DEPOSIT command cannot be; made writeable. The DEPOSIT command cannot be performed. User Action: None. 3 BADUSEPACKAincorrect package name in use clause use-name, module module-name Facility: DEBàUG, VMS Debugger? Explanation: The compiler has generated invalid Debug Symbol Table information.C User Action: Please submit a Software Performance Report against the compiler. 3 BADUSREVNT9bad user-specified event table or event entry in user RTL Facility: DEBUG, VMS DebuggerC Explanation: The debugger has detected an internal inconsistencyA in the event tables of the Run Time Library. This indicates anA internal error in either the debugger or the áRun Time Library.< User Action: Please submit a Software Performance Report. 3 BADWATCH*cannot watch protect address address_value Facility: DEBUG, VMS DebuggerB Explanation: A SET WATCH command specified a protected address.; Note that you cannot place a watchpoint on a dynamically? allocated variable because these variables are stored on the stack.6 User Action: Do not use watchpoint on this address. 3 BADWIDGET<the debugger can not write to the âcommand dialog box, is not initialized. Facility: DEBUG, VMS DebuggerD Explanation: The debugger got an unexpected status when trying toC write to the command dialog box. This prevents the debugger from continuing this session.A User Action: Try the debugger again, if the same results exist. submit a Software Performance Report (SPR). 3 BASVARNOTSETbase variable not set up yet Facility: DEBUG, VMS Debugger> Explanation: The pointer to the based variaãble has not been@ set up by an ALLOCATE statement. Without a valid pointer, the reference cannot be made.? User Action: Execute the ALLOCATE statement that defines the> pointer for this based variable and then use the pointer to$ dereference the desired variable. 3 BITRANGEbit range out of limits Facility: DEBUG, VMS DebuggerB Explanation: The EVALUATE command specified a bit field that is too wide.@ User Action: The low limit of the bit field is 0 anäd the high* limit is 31; the maximum range is 31:0. 3 BKPTNOTFOUND=the debugger detected an error searching for this breakpoint. Facility: DEBUG, VMS DebuggerB Explanation: The debugger detected and error when searching forC the existence of the breakpoint in the list current breakpoints.A User Action: Try the debugger again, if the same results exist. submit a Software Performance Report (SPR). 3 BPTDIFMOD9breakpoint or tracepoint being set in a differenåt module. Facility: DEBUG, VMS Debugger> Explanation: The specified line number was not found in the@ current module. Consequently, Debug is setting the breakpoint@ or tracepoint in a module later in the call stack or in a set module not on the call stack.B User Action: If the breakpoint or tracepoint was intended to beA set in the current module, cancel the breakpoint or tracepoint3 and specify a line number in the current module. 3 BPTONDATA3execution breaækpoint or tracepoint set on data item Facility: DEBUG, VMS Debugger@ Explanation: The command requested a breakpoint or tracepoint> for a data item. Typically breakpoints are set only on code locations.* User Action: See the following message. 3 BRINCRITSECDthe breakpoint at !XL (hex) will cause the STx_C at !XL to fail; theLDx_L is at !XL Facility: DEBUG, VMS DebuggerA Explanation: The debugger has limited support for debugging of@ critical sections ç delimited by memory locking/unlocking (e.g.@ LDx_L/STx_C (load-locked/store-conditional) instructions. TheA exception mechanisms used by the debugger causes the lock-flagD set by the locking instruction to be cleared. This action affectsD the behavior of subsequent instructions that rely on memory beingC locked. Such critical sections are (or should be) coded to retry when the LDx_L or STx_C fail.? User Action: Cancel or deactivate all breakpoint events thatB might triggèer while the application being debugged is executingA the critical section; a breakpoint at the LDx_L is permissibleD (will not effect the the lock-flag); a STEP issued from the load_B lock instruction without interfering breakpoints or watchpoints2 will completely step over the critical section. 3 BUFFEROVFbuffer overflow Facility: DEBUG, VMS DebuggerB Explanation: This message indicates an internal debugger error.5 User Action: Submit a Software Performance Reéport. 3 BUFOVRFLOW-An internal buffer overflow has been detected Facility: DEBUG, VMS DebuggerA Explanation: The size of an internal buffer is insufficient to perform this operationB User Action: Please submit a Software Performance Report (SPR). 3 BUTTONEXISTS-Button !AC already exists in the button list. Facility: DEBUG, VMS Debugger 3 BUTTONNOTFOUND0Button !AC not found in the internal button list Facility: DEBUG, VMS Debugger ê3 BUTTONTOOMANY5Too many buttons can not generate unique button name. Facility: DEBUG, VMS Debugger 3 BWLGISMUSDB, W, L, G, I, or S must precede ^ for operand number operand_number Facility: DEBUG, VMS Debugger? Explanation: You must specify the type of offset as either BB (byte), W (word), or L (longword). You must specify the type ofD literal as either I (immediate) or S (short). You may specify the" addressing mode as G (general).C User Action: Enter thëe instruction again, specifying the operand using one of the above modes. 3 CALLDONECall to user program complete Facility: DEBUG, VMS Debugger? Explanation: This signal is generated by the debugger kernel" after a called routine returns.B User Action: Submit an SPR. This message is handled internally,, and should never be signaled to the user. 3 CANBRKWAT;cancel it and set a watchpoint if that is what was intended Facility: DEBUG, VMS DebuggerìB Explanation: If you intended to get notified when the specified@ location was modified rather than executed, then a watchpoint1 should have been set rather than a breakpoint.= User Action: If a watchpoint was intended, then cancel the# breakpoint and set a watchpoint. 3 CANTACCESSMAINcannot access the main debugger Facility: DEBUG, VMS DebuggerD Explanation: The kernel debugger cannot access the main debugger.= The reason is given in the message followiníg this message.C User Action: Correct the problem given by the messages followingC this message. If the problem cannot be solved, submit a Software Performance Report. 3 CANTBLDATTRLIST,Cannot build an ACA Services attribute list. Facility: DEBUG, VMS DebuggerB Explanation: Debug could not build the attribute list needed toB invoke an ACA Services function. The ACA Services function will not be executed.5 User Action: Submit a Software Performance Reportî. 3 CANTCREATEMAIN(could not create the debugger subprocess Facility: DEBUG, VMS Debugger: Explanation: An error occurred while trying to create aA subprocess to run the sharable main debugger image. The reason2 is given in the message following this message.C User Action: Correct the problem given by the messages followingC this message. If the problem cannot be solved, submit a Software Performance Report. 3 CANTFINDELEM>Debug cannot retrieve optiïonal arguments to the DEBUG message. Facility: DEBUG, VMS Debugger> Explanation: Optional arguments were specified to the DEBUGA message however Debug cannot retrieve these arguments from ACA Services.5 User Action: Submit a Software Performance Report. 3 CANTFREEATTRLIST1Cannot deallocate an ACA Services attribute list. Facility: DEBUG, VMS DebuggerD Explanation: Debug could not deallocate the attribute list needed& to invoke an ACA Services function.ð$ User Action: No action necessary. 3 CANTGETFIDBcannot get file-id for image file opened on channel channel-number Facility: DEBUG, VMS DebuggerA Explanation: An error occurred while trying to get the file-idD of the image file opened on channel channel-number. The reason is/ given in the message following this message.C User Action: Correct the problem given by the messages followingC this message. If the problem cannot be solved, submit a Software Perñformance Report. 3 CANTGETLISTCNT5Debug cannot retrieve the list count on an item list. Facility: DEBUG, VMS DebuggerD Explanation: An item list was secified in an ACA Services messageD to Debug, however, in the course of processing the message, DebugB could not retrieve the count of the number of items in the list from ACA Services.5 User Action: Submit a Software Performance Report. 3 CANTINTPROcannot interrupt process !AC Facility: DEBUG, VMS òDebugger> Explanation: The debugger could not interrupt the specifiedA process because it was deleted. This message usually indicatesB that the specified process terminated abnormally-either via the- DCL STOP command or via a call to $DELPRC.D User Action: The debugger failed to interrupt the process. UnlessA the reason for this is apparent, submit a Software Performance Report (SPR). 3 CANTOPNIMG>cannot open image image_name (File: device_name:(file_id,file_ idó,file_id)) Facility: DEBUG, VMS DebuggerB Explanation: The information the debugger needs to allow you toC debug this section of code is in an image file that could not be opened.D User Action: Check for the existence of the specified file and/or- its associated file protection attributes. 3 CANTPAST!cannot paste to read-only window. Facility: DEBUG, VMS DebuggerC Explanation: The window which has the input focus is a read-only2 window. You cannot ôpaste to a read-only window.D User Action: Assign the input focus to a writeable window and, if3 applicable, to the appropriate text-entry field. 3 CANTREGSERVER0Could not register Debug as ACA Services server. Facility: DEBUG, VMS DebuggerB Explanation: Debug could not register itself as an ACA Services Server.B User Action: Verify that ACA Services is installed and that theC Control Server is running on the current system. If ACA Services@ is installed anõd the Control Server is running on the currentD system and this problem still exist, submit a Software Performace? Report, otherwise install ACA Services and start the Control Server. 3 CANTUNREGSERVER2Could not unregister Debug as ACA Services server. Facility: DEBUG, VMS DebuggerD Explanation: Debug could not unregister itself as an ACA Services Server.D User Action: Use ACA Services command, STOP SERVER, to unregister# Debug as an ACA Services server. ö 3 CIRCSTK*circular stack at frame address frame-addr Facility: DEBUG, VMS DebuggerA Explanation: The debugger is attempting to chain down the callD stack, following frame pointers. The debugger has determined that; the linked frames loop back on themselves at frame-addr.D User Action: Determine what part of your code is writing into theA FP register or overwriting the saved frame pointer on the callC stack (or a preceding saved frame pointer) and correct it. Since÷C the debugger looks at the call stack to symbolize addresses, youA may suppress some of these messages by typing the command "SET MODE NOSYMBOLIC". 3 CIREXLST@command aborted after number_of_handlers exit handlers displayed$circular exit handler list suspected Facility: DEBUG, VMS Debugger; Explanation: After displaying information about 100 exit@ handlers, the debugger suspects a circular exit handler list.> User Action: If there is a circular exit handler ølist, then6 identify and correct the error in the user program. 3 CLIBRDFAIclipboard operation failure Facility: DEBUG, VMS DebuggerD Explanation: One of the DECtoolkit clipboard routines has failed.? The attempt to write to the clipboard may not have completed successfully.D User Action: Verify that the clipboard contains the data that you< wrote to it. If it does not, attempt the operation again. 3 CLIBRDLCKclipboard locked Facility: DEBUG, VMùS Debugger@ Explanation: Some other DECWINDOWS application has locked the clipboard.A User Action: Wait until the other application has released the clipboard. 3 CMDBUFFERR@the debugger detected an error in the size of the command buffersize. Facility: DEBUG, VMS Debugger= Explanation: The debugger detected an error when trying to? process the input command. Debug determined that the command8 buffer size was to small to store the command buffer.Aú User Action: Try the debugger again, if the same results exist. submit a Software Performance Report (SPR). 3 CMDFAILEDthe !AC command has failed Facility: DEBUG, VMS Debugger> Explanation: The command has failed. The command has had no+ effect on the current debugging session.A User Action: Reenter the command after correcting the problem. 3 CMDISCOR#the correct command is command_name Facility: DEBUG, VMS DebuggerD Explanation: The previousû message shows the obsolete command. The1 command replacing it is shown in this message.> User Action: Use the correct command as shown. The obsolete; command will not be available in a future release of the debugger. 3 CMDISOBS command command_name is obsolete Facility: DEBUG, VMS Debugger) Explanation: This command is obsolete.D User Action: Do not use this command, it will not be available in$ a future release of the debugger. 3 CMDNOTAVAIL)thüe command command_name is not available Facility: DEBUG, VMS Debugger< Explanation: The specified command, although available in@ some debug implementations, is not available in this one. OneB reason why is that the qualifier just doesn't make sense on the> platform. For example, the /JSB qualifier on a STEP command< doesn't make sense on Alpha VMS because there is no "JSB"( instruction like there is on VAX VMS.' User Action: Choose another command. 3 CMDNOTDWý9The !AC command is not allowed in the DECWindows debugger Facility: DEBUG, VMS Debugger> Explanation: The specified command may not be used with the DECWindows debugger.D User Action: Do not use the command with the DECWindows debugger. 3 CMDNOTONE:The !AC command is not allowed in the one process debugger Facility: DEBUG, VMS Debugger> Explanation: The specified command may not be used with the single process debugger.; User Action: Do not use theþ command with the one process debugger. 3 CMDSYNERR>command syntax error at or near 'the debugger_command_segment' Facility: DEBUG, VMS Debugger< Explanation: There is a syntax error in the Debug command2 somewhere near the string shown in the message.B User Action: Correct the syntax error and re-enter the command. 3 CMPNOTFND*specified component not found in this type Facility: DEBUG, VMS DebuggerA Explanation: The enumeration component named in tÿhis operation@ could not be found in the list of components defined for this type.@ User Action: Correct the name of the enumeration component or correct the expression. 3 CNTRLWRDNOTACCESS)the vector control word is not accessible Facility: DEBUG, VMS Debugger? Explanation: The debugger does not have direct access to theB vector control word. Therefore the operands of this instruction! cannot be displayed correctly.@ User Action: Do not attempt to display the operands of vector; instructions whose control word is not accessible to the debugger. 3 COMPNDSTRNGAthe debugger detected an error when generating a compound string. Facility: DEBUG, VMS DebuggerA Explanation: The debugger could not generate a compound string$ that is utilized by the Xtoolkit.$ User Action: No action necessary. 3 CONFIGSAVEDBthe window configuration is saved. Configuration will be preserved$next time you bring up the debugger. Facility: DEBUG, VMS Debugger 3 CONFLICT=illegal combination of command elements - check documentation Facility: DEBUG, VMS DebuggerC Explanation: Command line elements conflict in their operations.% The command will not be performed.A User Action: Do not specify conflicting command line elements. 3 CONFROMEXC/warning: you are continuing from a severe error Facility: DEBUG, VMS DebuggerB Explanation: The debugger has encountered a severe error and isC continuing. The validity of this debugging session can no longer be guaranteed.D User Action: Determine and correct the cause of the severe error.A If the problem cannot be solved, submit a Software Performance Report (SPR). 3 CONSTRCOMP1illegal deposit to a constrained record component Facility: DEBUG, VMS Debugger> Explanation: The debugger cannot DEPOSIT into a constrained record component.C User Action: Do not attempt to deposit into a constrained record component. 3 COULDNOTRUN(The RUN or RERUN command did not succeed Facility: DEBUG, VMS Debugger: Explanation: An error occurred while trying to create a? subprocess for the program to run. The error status returned= from the RUN or RERUN command is appended to this message.@ User Action: If the error is correctable, correct the problemB and reenter the command. If not, the RUN and RERUN commands are unavailable. 3 CPOSTDECR5side effect on post-decrement operation not performed Facility: DEBUG, VMS DebuggerA Explanation: The debugger does not support the evaluation of a post-decrement expression. User Action: None 3 CPOSTINCR5side effect on post-increment operation not performed Facility: DEBUG, VMS DebuggerA Explanation: The debugger does not support the evaluation of a post-increment expression. User Action: None 3 CPREDECR4side effect on pre-decrement operation not performed Facility: DEBUG, VMS DebuggerA Explanation: The debugger does not support the evaluation of a pre-decrement expression. User Action: None 3 CPREINCR4side effect on pre-increment operation not performed Facility: DEBUG, VMS DebuggerA Explanation: The debugger does not support the evaluation of a pre-increment expression. User Action: None 3 CRMPSCFAIL0failed to map-in the debugger Symbol Table (DST) Facility: DEBUG, VMS DebuggerC Explanation: There will always be a secondary message describingD why the debugger failed to map-in the debugger symbol table (DST) or global symbol table (GST).A User Action: Please refer to the secondary message to take the appropriate action. 3 CVTNEGUNSBcannot convert negative value to unsigned value at or near opcode_name Facility: DEBUG, VMS DebuggerD Explanation: The command is attempting to assign a negative value, to an unsigned type. This is not allowed.> User Action: Do not attempt to put a negative value into an unsigned variable. 3 DBGERRinternal debugger coding error. Facility: DEBUG, VMS Debugger@ Explanation: An internal debugger error has been encountered.? User Action: If the error is reproducible, submit a Software> Performance Report and, if possible, enclose both a copy ofA the program being debugged and a logged debugging session that reproduces the error.  3 DBGSTOPPED=a debugger process from a previous debugging session has been terminated Facility: DEBUG, VMS Debugger? Explanation: While attempting to create a process to run theB debugger, a debug process from a previous debugging session was found and terminated.@ User Action: Under normal circumstances, the debugger process? will exit when a debugging session ends via the EXIT or QUITB commands. If the previous debugging session was terminated with? an EXIT  or QUIT command and this error is reproducable, then- submit a Software Performance Report (SPR) 3 DECLARERR-too many declarations, parameter_name ignored Facility: DEBUG, VMS Debugger9 Explanation: There is a mismatch between the number ofC declarations in a command procedure and the number of parameters$ passed to that command procedure.; User Action: Check the command procedure and the DECLARE< statements within to see if they agree with the number of"   parameters on the command line. 3 DECOVF'decimal overflow at or near opcode_name Facility: DEBUG, VMS Debugger? Explanation: The value being deposited does not fit into the specified address.D User Action: Specify either a smaller value or a different target address. 3 DECROPRAND>illegal packed or decimal string value (Reserved Operand faultoccurred during conversion) Facility: DEBUG, VMS DebuggerA Explanation: The debugger encountered a R eserved Operand FaultA when attempting to convert the specified value. This indicatesB that the packed or decimal string value did not contain a valid number.@ User Action: Ensure that the string value contains only valid digits. 3 DEFKEY(state_name key key_name has been defined Facility: DEBUG, VMS Debugger< Explanation: The defining of functions keys has just been? performed using the DEFINE/KEY command. This command assigns@ a string to function key.  This is the logging message for the DEFINE/KEY command. User Action: None 3 DEFKEYERR'error in processing DEFINE/KEY command: Facility: DEBUG, VMS Debugger? Explanation: There was an error in defining the given key in= the display system. The key may not be redefinable, eitherD because the display system will not allow it or because there areB protections that prevent it. The key definition may be invalid.8 User Action: Correct the error in the key defin ition. 3 DEFTOOREC2Command defined with too many levels of recursion. Facility: DEBUG, VMS DebuggerD Explanation: Commands may only be defined to a specified depth of recursion (now set at 100).C User Action: Redefine your command such that it uses less levels of recursion. 3 DELKEY(state_name key key_name has been deleted Facility: DEBUG, VMS Debugger> Explanation: The undefining of functions keys has just beenC performed using the DELETE/KEY command. This command deletes theB key definitions that were established by the DEFINE/KEY commandA or, by default by the debugger.This is the logging message for the DELETE/KEY command. User Action: None 3 DELKEYERR'error in processing DELETE/KEY command: Facility: DEBUG, VMS Debugger< Explanation: There was an error in deleting the given key> definition from the display mechanism. The key may not be aB defined key. The key definition might also be protected against deletions.? User Action: Correct the error in the command or correct the> protections of the key in the display mechanism being used. 3 DELTIMTOOdelta time too large Facility: DEBUG, VMS DebuggerD Explanation: The debugger encountered an error when attempting to7 convert the string form of the delta time to binary.@ User Action: Enter the delta time specifying a smaller value. 3 DESCNOTSETdescriptor not set up yet Facility: DEBUG, VMS DebuggerA Explanation: A descriptor used in an expression in the commandB is not yet fully initialized. Some of the fields are not valid,? which means that the Debugger cannot completely evaluate the expression.B User Action: Examine the descriptor that caused the problem andD determine which fields are not correct. Fill in these fields with the correct values. 3 DISABLEAST#ASTs were enabled, are now disabled Facility: DEBUG, VMS Debugger@ Explanation: Delivery of asynchronous system traps (ASTs) has< been turned off in your program by a DISABLE AST command. User Action: None 3 DISNAMREQ'display name required with this command Facility: DEBUG, VMS Debugger= Explanation: user did not specify a display name with this command6 User Action: enter a display name with this command 3 DISNOTSEL0display not selected because removed from screen Facility: DEBUG, VMS DebuggerA Explanation: You specified a display which is removed from the screen.B User Action: Either specify a display which is not removed fromA the screen, or place the specified display onto the screen and attempt the operation again. 3 DISPEXISTSAdisplay_name display already exists; cannot be set until canceled Facility: DEBUG, VMS Debugger? Explanation: You attempted to create a display which alreadyD exists, either by explicitly creating the display or by trying toB save the contents of a display into currently existing display.7 User Action: Specify a display which does not exist. 3 DISPKINDINV.the display kind display_name is not available Facility: DEBUG, VMS DebuggerA Explanation: The specified display kind, although available in< some debug implementations, is not available in this one./ User Action: Do not select the display kind. 3 DISPRLENSIZBlength of display_name display cannot exceed maximum size increase)size usi ng /SIZE=n or specify fewer lines Facility: DEBUG, VMS Debugger? Explanation: You attempted to resize the display so that theC number of visible lines in the display is larger than the numberA of lines which are saved for the display. The debugger has setB the number of visible lines of the display to the SIZE value of the display.B User Action: Either decrease the number of visible lines in theD display, or increase the number of lines which are saved for this(  display by the use of the SIZE value. 3 DIVBYZEROattempted to divide by zero Facility: DEBUG, VMS DebuggerD Explanation: During the evaluation of an expression, the debugger( noticed an attempt to divide by zero.D User Action: Correct the expression so that it does not divide by zero. 3 DSTERRG8error in DST (compiler error). GOTO DST has been ignored Facility: DEBUG, VMS Debugger? Explanation: This represents an internal compiler, linker or= debugger error. If this can be reproduced please submit an% Software Performance Report (SPR).C User Action: If this can be reproduced please submit an Software Performance Report (SPR). 3 DSTNESDEP.DST nesting depth too deep in module path_name Facility: DEBUG, VMS Debugger= Explanation: Symbol table nesting depth is too deep in theB specified module. This occurs if routine nesting or data record, nesting is very deep in the user program.8 User Action: Simplify the user program and run again. 3 DUPLVQUAL@Duplicate or conflicting vector qualifier specified at 'command_line' Facility: DEBUG, VMS DebuggerA Explanation: The qualifier indicated in the shown command lineA fragment has already been specified, or is conflicting with an earlier specified qualifier.. User Action: Delete the qualifier in error. 3 DUPSTATLINK@more than one static link DST encountered in path_name, compilererror Facility: DEBUG, VMS Debugger@ Explanation: Only one static link DST record is permitted forB a given module, Ada package, or routine. This message indicatesC that this constraint was violated somewhere within the specified; module. This message usually indicates a compiler error.5 User Action: Submit a Software Performance Report. 3 DWERRAa DECwindows toolkit error has occurred the message text is '!AS' Facility: DEBUG, VMS Debugger< Explanation: An error has been reported by the DECwindowsB toolkit. This indicates that either the toolkit or the X serverC has detected a problem with the debuggers DECwindows display(s).D User Action: Try to correct the problem specified in the message.A For further information or assistance on this problem, contact your System Manager. 3 DWNOT1PROC7the 1 process debugger cannot be run in DECwindows mode Facility: DEBUG, VMS Debugger@ Explanation: The debugger must have ASTs enabled at all times@ in order to properly run as a DECwindows program. This is not@ possible for a 1 process debugger. Therefore, the debugger is2 defaulting to not run as a DECwindows debugger.C User Action: Correct the logical name assignment for DBG$PROCESS; to be either "MULTIPROCESS" or "DEFAULT", and try again. 3 DYNIMGSETsetting image image_name Facility: DEBUG, VMS DebuggerB Explanation: The debugger is automatically setting to the imageD containing the current PC. This is only an informational message. User Action: None 3 DYNMODSETsetting module path_name Facility: DEBUG, VMS DebuggerC Explanation: The debugger is automatically setting to the moduleD containing the current PC. This is only an informational message. User Action: None 3 EDITDISVER*the original version is file_specification Facility: DEBUG, VMS DebuggerB Explanation: The original file has been revised since the startA of the debug session. This message indicates that source lines= may not correspond to the ones used to compile this module? User Action: Use SET SOURCE command to point to the original4 source file if possible and re-attempt operation. 3 EDITERRORerror while trying to EDIT Facility: DEBUG, VMS Debugger= Explanation: An error occurred because of specifying a bad= command line or because of choosing an editor which is not installed on this system.D User Action: Check command line syntax and re-enter, or select anC editor which is installed on the system. For further information8 on the installed editors contact your system manager. 3 EDITFILEediting file file_specification Facility: DEBUG, VMS DebuggerC Explanation: The debugger is currently setup to edit the file asC specified in the message. This is only an informational message. User Action: None 3 EDITNOFILE!no source file to use for editing Facility: DEBUG, VMS DebuggerC Explanation: This messages indicates that the debugger could not5 find the specified source file to use for editing.? User Action: Use SET SOURCE command to point to the original3 source file if possible and reattempt operation. 3 EDITREVVER5editing a revised version of the original source file Facility: DEBUG, VMS DebuggerC Explanation: The original source file has been revised since theA start of the debug session. This message indicates that futureB source line may not correspond to the ones used to compile this module.? User Action: Use SET SOURCE command to point to the original3 source file if possible and reattempt operation. 3 EMPTFIELDVIEW?the debugger detected an error when retrieving information on aparticular window view. Facility: DEBUG, VMS Debugger= Explanation: The debugger could not retrieve the necessary? information for a particular view display. This inhibits the@ debugge r from manipulating the contents of the window at this time.$ User Action: No action necessary. 3 ENABLEAST#ASTs were disabled, are now enabled Facility: DEBUG, VMS Debugger@ Explanation: Delivery of asynchronous system traps (ASTs) has< been turned off in your program by a DISABLE AST command. User Action: None 3 ENTRYMASK+entry mask has non-zero value in bits 12:13 Facility: DEBUG, VMS DebuggerB Explanation: This is an internal status signa!l, it should neverB be seen by the user. If this message does occur please submit a% Software Performance Report (SPR).; User Action: Submit a Software Performance Report (SPR). 3 ENTRYNOTFNDBthe debugger detected an error when searching for a window object. Facility: DEBUG, VMS Debugger> Explanation: When looking for a window object, the debugger detected an error.A User Action: Try the debugger again, if the same results exist. submit a Software Perform"ance Report (SPR). 3 ENUMRANGEenumeration value out of range Facility: DEBUG, VMS DebuggerD Explanation: An error in your program indicates that the value of$ this enumeration is out of range.A User Action: Examine this field in numeric format to determine; its value. Determine the error in your code and make the appropriate corrections. 3 ERRACTIMGunable to activate image Facility: DEBUG, VMS Debugger> Explanation: A bad status was returned #from LIB$FIND_IMAGE_B SYMBOL. This message should be issued in the $DBG_INFO context.C User Action: The image the debugger was trying to activate couldC not be activated. The following error should help to resolve the problem. 3 ERRASSIGN=the attempt to acquire an I/O channel for the debugger failed Facility: DEBUG, VMS Debugger@ Explanation: A bad status was returned from a $ASSIGN type of@ call. This message should be issued in the $DBG_INFO context.@ U$ser Action: The debugger needs to acquire I/O channels to doC I/O. In this case the debugger failed to acquire such a channel. Check your process quotas. 3 ERRCLSFILEunable to close file Facility: DEBUG, VMS Debugger@ Explanation: A bad status was returned from a call to close a@ file. This message should be issued in the $DBG_INFO context.? User Action: The debugger failed to close a file. Unless theD reason for this is apparent, submit a Software Performanc%e Report (SPR). 3 ERRCREATPB=the debugger detected an error when trying to create the userdefined push button. Facility: DEBUG, VMS Debugger> Explanation: The debugger detected and error when trying to' create the user defined push button.A User Action: Try the debugger again, if the same results exist. submit a Software Performance Report (SPR). 3 ERRCREATWIND@the debugger detected an error when trying to create a window inroutine function_name.& Facility: DEBUG, VMS DebuggerD Explanation: The debugger detected an error when trying to create a window.A User Action: Try the debugger again, if the same results exist. submit a Software Performance Report (SPR). 3 ERRCRELNMunable to create a logical name Facility: DEBUG, VMS Debugger@ Explanation: The debugger creates logical names for input andA output redirection. This message should be issued in the $DBG_ INFO context.; User Action: Subm'it a Software Performance Report (SPR). 3 ERRDEASSIGNBattempt to deassign an I/O channel acquired by the debugger failed Facility: DEBUG, VMS DebuggerC Explanation: The debugger wanted to deassign an I/O channel thatB is acquired for internal purposes. This error notes the failure? of the SYS$DASSGN system service, probably due to an invalid channel.; User Action: Submit a Software Performance Report (SPR). 3 ERRFAOunable to format output string ( Facility: DEBUG, VMS Debugger: Explanation: An error was returned from a call to $FAO.; User Action: Submit a Software Performance Report (SPR). 3 ERRFETCHWIDBthe debugger detected an error while fetching objects from the the6Motif Resource Manager (MRM) in routine function_name. Facility: DEBUG, VMS Debugger@ Explanation: The debugger could not find one of the necessaryA objects in the Motif Resource Manager (MRM). This prevents the) debugger from continuing th)is session.A User Action: Try the debugger again, if the same results exist. submit a Software Performance Report (SPR). 3 ERRGETDVI unable to get device information Facility: DEBUG, VMS DebuggerA Explanation: The debugger needed some information from $GETDVID and the call failed. This indicates a programming error. No doubt! bad parameters were passed in.; User Action: Submit a Software Performance Report (SPR). 3 ERRGETEF(attempt to allocate an e*vent flag failed Facility: DEBUG, VMS DebuggerB Explanation: The debugger wanted to allocate a local event flagC for it's own use. For some reason the routine called to allocate? the event flag failed. This message is usually issued in the $DBG_INFO context.D User Action: The debugger needs event flags to operate. Check theB program being debugged for excessive allocation of event flags. 3 ERRINSDEC7error occurred while decoding instruction at current PC + Facility: DEBUG, VMS Debugger< Explanation: The debugger has encountered an error during, decoding an instruction at the current PC= User Action: The address may be an entry mask, examine the4 instruction 2 bytes beyond the specified address. 3 ERRINSIGNAL9signal arguments were incorrect, signal cannot be decoded Facility: DEBUG, VMS Debugger> Explanation: The arguments which were passed as part of theB signal in your program were incorrect. The debugger encou,nteredC an error in trying to analyze the signal arguments. The error is/ shown in the message following this message.B User Action: Analyze the arguments passed to LIB$SIGNAL by your" program, and correct the error. 3 ERRINVEDITerror invoking editor Facility: DEBUG, VMS DebuggerA Explanation: While trying to invoke an editor a bad status was returned.= User Action: Is the requested editor available and working? properly. If so, submit a Software Pe-rformance Report (SPR). 3 ERROPENHIER?the debugger detected an error while opening the Motif resource%(UID) file, in routine function_name. Facility: DEBUG, VMS DebuggerA User Action: Please make sure that resource (UID) file for theD debugger is in appropriate directory (Usually SYS$SYSTEM). Please consult your system manager. 3 ERROR internal debugger error detected Facility: DEBUG, VMS DebuggerB Explanation: This message indicates an internal deb.ugger error.C User Action: Correct the problem given by the messages followingC this message. If the problem cannot be solved, submit a Software Performance Report. 3 ERRORLIMIT-Error limit = error-limit, dumping terminated Facility: DEBUG, VMS Debugger> Explanation: The error limit specified for the DST dump wasC exceeded; the dumper was unable to continue processing the inputA file. By default, the error limit is set at 5. Use the /ERROR_' LIMIT qualifi/er to change the value. 3 ERROR_BLOCK)error handle signalled, address = address Facility: DEBUG, VMS DebuggerC Explanation: The debugger signalled an error handle. This shouldB never happen. The error handles are an internal construct whichB are used to obtain information within the debugger. They should) never appear in user-visible messages.: User Action: Submit a Software Performance Report (SPR) 3 ERRQIOWerror from $QIOW Facility: DEBUG, VMS De0bugger? Explanation: A bad status was returned from a call to $QIOW.; User Action: Submit a Software Performance Report (SPR). 3 ERRSMGBerror returned from a call to the Screen Management Facility (SMG) Facility: DEBUG, VMS DebuggerB Explanation: A bad status was returned from a call to SMG. ThisD could be a result of any number of things which may or may not be a debugger problem.A User Action: Check the user program for potential interactions@ between1 it and the debugger; pasteboard sharing and the like.D Also, check the set up of the terminal which might cause SMG someC problem. If the error still can't be explained submit a Software Performance Report (SPR). 3 ERRSYSSERV<error returned from an internal debugger system service call Facility: DEBUG, VMS DebuggerA Explanation: A bad status was returned from a call to a systemA service. This message is to be in the context of the $DBG_INFO7 macro which will li2st the particular system service.; User Action: Submit a Software Performance Report (SPR). 3 ERRTARGOP5unable to perform operation for current target system Facility: DEBUG, VMS Debugger3 Explanation: This is an internal debugger error.? User Action: If the error is reproducible, submit a Software> Performance Report and, if possible, enclose both a copy ofA the program being debugged and a logged debugging session that reproduces the error. 3 ERR3USREVNTerror in user-specified event Facility: DEBUG, VMS DebuggerC Explanation: When attempting to process the specified event, the@ debugger called the Run Time Library, which returned an errorD status. The error status returned by the Run Time Library follows this message.C User Action: Correct the problem based on the associated message, which follows the debugger error message. 3 EXABEYREG9Attempt to examine beyond the end of a register detected. 4 Facility: DEBUG, VMS Debugger; Explanation: A ranged examine command was specified that= attempted to examine beyond the end of a bounded register.A User Action: Respecify the command so that it does not go past the end of the register. 3 EXARANGEinvalid range of addresses Facility: DEBUG, VMS DebuggerD Explanation: The first address of a range to examine must be less) than the second address in this range.C User Action: Enter the address range spec5ifying the addresses in increasing order. 3 EXAMEXPANDUse examine/expand with caution Facility: DEBUG, VMS Debugger> Explanation: The examine/expand command has to be used with@ caution. In case of an actual circular loop in the structure,> the examine/expand can cause undefined behaviour. In such a# case, do not use examine/expand. User Action: None. 3 EXCBREREPexception breakpoint replaced Facility: DEBUG, VMS DebuggerD Explanation: A 6SET BREAK/EXCEPTION was done when exception breaksD were already in effect. The old exception break was replaced with the new one.B User Action: Submit an SPR. This message is handled internally,, and should never be signaled to the user. 3 EXCDURCALBerror occurred while executing routine called from exception break Facility: DEBUG, VMS DebuggerB Explanation: While executing a routine called from an exception; break using the CALL command, an exception occurred. 7Any@ exceptions from routines called from an exception break cause; this message to be displayed followed by the text of theA exception. Execution of the called routine is then terminated.C User Action: Either correct the CALL command if it was in error,? or correct the routine that caused the exception. To use theD debugger to help find the cause of the exception, try calling the+ routine while not at an exception break. 3 EXITARG)exitloop argument num_levels is 8too large Facility: DEBUG, VMS DebuggerB Explanation: The parameter specified on the EXITLOOP command isC greater than the number of loops nested at this time. It is alsoD possible that you have specified an EXITLOOP command when you are not inside of a loop.B User Action: Reduce the parameter on the EXITLOOP command to no@ more than the number of loops nested at the time the EXITLOOPC command is to be executed. If there are no loops currently being4 executed, the9n the EXITLOOP command is redundant. 3 EXITERR2an error occurred while trying to exit the program Facility: DEBUG, VMS DebuggerA Explanation: An error status was returned from the call to the= debugger-kernel service that terminates program execution.A Depending on the severity of the error, the program may or may not have terminated.< User Action: Examine the error message after this message< and consider if the problem is related to a lack of quota? or ot:herwise related to your program's behavior. If so, thenA take corrective action. If, after this evaluation, you believe@ that the problem lies in the debugger, then submit a Software Performance Report. 3 EXITSTATUSis 'status_value' Facility: DEBUG, VMS DebuggerD Explanation: The program has exited with the status status_value. User Action: None. 3 EXPMEMPOOLexpanding debugger memory pool Facility: DEBUG, VMS Debugger@ Explanation: The de ;bugger kernel maintains a memory pool fromC which it allocates data structures to keep track of breakpoints,; tracepoints, watchpoints, and so on. The initial size of< the memory pool is 256 pages. The memory pool is expanded@ automatically when needed, and this informational is signaledD when memory pool expansion occurs. If you have set a large numberB of breakpoints, tracepoints, or watchpoints, this message is to be expected.D User Action: If this message appears for <no evident reason (i.e.,B you have not set a large number of breakpoints, tracepoints, orC watchpoints), there may be something wrong with the debugger. In this case, submit an SPR. 3 FAILFINDIMGCthe debugger could not find the DECwindows image to be initialized. Facility: DEBUG, VMS Debugger@ Explanation: The debugger could not find the DECwindows image$ that it was trying to initialize.A User Action: Try the debugger again, if the same results exist. submi=t a Software Performance Report (SPR). 3 FAILHEIRKY?the debugger could not open the user interface definition file,SYS$LIBRARY:DEBUGUIL.UID. Facility: DEBUG, VMS Debugger@ Explanation: The debugger could not find one of the necessaryD file to support the DECWindows interface, preventing the debugger from continuing this session.= User Action: Check for the exsistance and accessability ofC SYS$LIBRARY:DEBUGUIL.UID. For further assistance and information2 on >this probelm check with your system manager. 3 FAILXTINIT<the debugger detected an error when trying to connect to theDECWindow software. Facility: DEBUG, VMS DebuggerD Explanation: The debugger failed to establish a connection to theA X server preventing the debugger from continuing this session.A User Action: Try the debugger again, if the same results exist. submit a Software Performance Report (SPR). 3 FATALSTATUS/a fatal condition was detected by the ?debugger. Facility: DEBUG, VMS Debugger> Explanation: The debugger got an unexpected status from theA system service or RTL routine routine-name which prevents this! DEBUG session from continuing.= User Action: Examine the error message and consider if the@ problem is related to a lack of quota or otherwise related toC your program's behavior. If so, then take corrective action. If,B after this evaluation, you believe that the problem lies in the7 debugger, then @submit a Software Performance Report. 3 FETCHLITERALCthe debugger detected an error while fetching literals from the theMotif Resource Manager (MRM). Facility: DEBUG, VMS Debugger@ Explanation: The debugger could not find one of the necessaryB literals in the Motif Resource Manager (MRM). This prevents the) debugger from continuing this session.A User Action: Try the debugger again, if the same results exist. submit a Software Performance Report (SPR). A3 FILENAMETOOLONG=File name longer than 251 characters is not supported in thiscontext. Facility: DEBUG, VMS DebuggerA Explanation: The name of the file specified by the user is too# large for the debugger to handle@ User Action: Try to redo the operation with a shorter string. 3 FILEUNALfile not available Facility: DEBUG, VMS Debugger? Explanation: The source file for the given program cannot be read.A User Action: Change the protections on thBe source file, or use? SET SOURCE to tell the Debugger where the source file really exists. 3 FLTOVF(floating overflow at or near opcode_name Facility: DEBUG, VMS Debugger? Explanation: The value being deposited does not fit into the specified address.D User Action: Specify either a smaller value or a different target address. 3 FPCSCP0@floating point control registers can be accessed only in scope 0 Facility: DEBUG, VMS DebuggerA ExplaCnation: An attempt was made to reference a floating pointC control register from a scope other than scope 0. DEBUG will notB accept a command which specifies any other scope for a floating point control register.B User Action: If the current scope has been set to a scope other> than scope 0 (using the SET SCOPE command), use an explicit< 0\pathname to access the floating point control register. 3 FRAMENOREAD7stack frame at frame address frame-addr is not readable D Facility: DEBUG, VMS DebuggerA Explanation: The debugger is attempting to chain down the call? stack, following frame pointers. The debugger has determinedD that part or all of the frame at frame-addr is not accessible forB reading. This usually indicates a corrupt frame list, but couldA also indicate that the program has protected part of memory in: which the frame lies. In either case, this is an error.D User Action: Determine what part of your code is writing into theAE FP register or overwriting the saved frame pointer on the callC stack (or a preceding saved frame pointer) and correct it. SinceC the debugger looks at the call stack to symbolize addresses, youA may suppress some of these messages by typing the command "SET MODE NOSYMBOLIC". 3 HEIGHTDIFFCdesired height of specified_height is not allowed, height is set to actual_height Facility: DEBUG, VMS Debugger? Explanation: The device specified by DBG$OUTPUT had a screeFn- height that wasn't in the range of 18-100.= User Action: Use SHOW TERMINAL command and verify that the@ terminal height is correct, it is in the range 18-100, and is% pointing to a valid terminal type. 3 IDENTLONG#identifier too long, please shorten Facility: DEBUG, VMS DebuggerB Explanation: Identifiers in address expressions must be shorter than 256 characters.+ User Action: Enter a shorter identifier. 3 IEEEDEN"computation produces IEEE GDenormal Facility: DEBUG, VMS DebuggerC Explanation: The expression evaluated by the debugger results inB an IEEE Denormal value being produced. IEEE Denormal values are9 values between zero and the smallest normalized value.D User Action: In general, this is acceptable. If, however, you areB debugging high-performance code and have just deposited an IEEEB Denormal value, then you must correct the value before resumingD your program, or the program will fail. Replace tHhe IEEE Denormal value with a zero. 3 IEEEINF"computation produces IEEE Infinity Facility: DEBUG, VMS DebuggerC Explanation: The expression evaluated by the debugger results inC an IEEE Infinity value being produced. This is caused by an IEEED floating point operation which overflows, for example, a multiply7 involving two very large IEEE floating point values.C User Action: In general, this is acceptable. No action required. 3 IEEENANcomputation prIoduces IEEE NaN Facility: DEBUG, VMS Debugger@ Explanation: The expression evaluated by the debugger results> in an IEEE NaN (not a number) value being produced. This isC caused by an illegal IEEE floating point operation, for example, a divide by zero.C User Action: In general, this is acceptable. No action required. 3 IFIXUND+precision lost during fixed point operation Facility: DEBUG, VMS DebuggerA Explanation: While doing operations on fixed point Jdata items,8 the debugger recognized that some precision was lost.< User Action: You should understand that the result of theA operation is imprecise and may not be exactly what you expect. 3 IFLTUND)floating underflow at or near opcode_name Facility: DEBUG, VMS Debugger< Explanation: While performing the arithmetic operation, aC floating-point value became less than the smallest representable value for that data type.< User Action: You should understand Kthat the result of theA operation is imprecise and may not be exactly what you expect. 3 IINTOVF'integer overflow at or near opcode_name Facility: DEBUG, VMS Debugger< Explanation: While performing the arithmetic operation, a@ floating-point value exceeded the largest representable value for that data type.< User Action: You should understand that the result of theA operation is imprecise and may not be exactly what you expect. 3 ILLADDCON4illegal consLtant constant_name in address expression Facility: DEBUG, VMS Debugger? Explanation: The constant in the message evaluates to a non-= integer type. Only integer types can be used in an address expression.> User Action: Change the constant to the appropriate integer value. 3 ILLASTERDsubscript range ('*') not permitted here (must be at lowest level ofdata structure) Facility: DEBUG, VMS DebuggerB Explanation: The debugger does not allow an asterisk Mas a rangeD in an EXAMINE except as the last index in the array. That is, theD memory to examine must be a contiguous region. Unconnected slices of arrays are not allowed.C User Action: Remove the asterisk from the expression to examine.C Placing the corrected EXAMINE inside a Debugger FOR loop command> could provide the functionality needed to do the command as originally desired. 3 ILLDEFNAM%illegal name for DEFINE: defined_name Facility: DEBUG, VMS DebuggNer0 Explanation: A defined name must be non-null.0 User Action: Enter a non-null name to DEFINE. 3 ILLENUMVAL$enumeration value out of legal range Facility: DEBUG, VMS Debugger@ Explanation: The predecessor (or successor) function has been@ used on the first (or last) component of the enumeration. The8 result would not be a valid value of the enumeration.B User Action: Do not use the predecessor (or successor) function7 on the first (or last) component of tOhe enumeration. 3 ILLEVNSTRAAttempt to pass an illegal event structure, name = structure-name Facility: DEBUG, VMS DebuggerB Explanation: This message indicates an internal debugger error. User Action: Submit an SPR. 3 ILLFILPTR/file variable points to invalid file descriptor Facility: DEBUG, VMS DebuggerC Explanation: The file variable references a file descriptor thatA cannot be read, is incomplete, or points to a file that is not open., P User Action: Correct the file descriptor. 3 ILLFLOAT.float_value is an illegal floating point value Facility: DEBUG, VMS DebuggerB Explanation: The Debugger attempted to parse the given floating5 point number and encountered an illegal character.2 User Action: Correct the floating point number. 3 ILLINVNUM&invalid invocation number at invoc_num Facility: DEBUG, VMS DebuggerC Explanation: An illegal invocation number was specified (must be in deciQmal radix).: User Action: Specify a legal decimal invocation number. 3 ILLLENGTH8illegal length field length_value in structure reference Facility: DEBUG, VMS DebuggerD Explanation: A negative value was given for the length of a field in a structure reference.@ User Action: Change the field length to a non-negative value. 3 ILLNUMPATH%illegal numeric pathname at path_name Facility: DEBUG, VMS DebuggerB Explanation: An illegal numeric pathname waRs specified (must be in decimal radix).9 User Action: Specify a legal decimal numeric pathname. 3 ILLPACSIZ-illegal packed size size_value; must be 0..31 Facility: DEBUG, VMS Debugger< Explanation: The specified size on a /PACKED qualifier is0 illegal. It must be a value between 0 and 31.A User Action: Specify a legal value with the /PACKED qualifier. 3 ILLPATH1Billegal use of %SOURCE_SCOPE (must not be combined with invocationnumbers)C FacilitSy: DEBUG, VMS Debugger %SOURCE_SCOPE has been used in the& same path with other scope numbers.C User Action: Remove all but one of the references to the desired scope. 3 ILLPATH2=illegal use of %SOURCE_SCOPE (must appear at the start of the pathname)A Facility: DEBUG, VMS Debugger %SOURCE_SCOPE has been used in aC path name in an illegal position. The %SOURCE_SCOPE lexical must& be the first item in the path list.D User Action: Move the %SOURCE_SCOPE lexicTal to the first position in the pathname. 3 ILLPATHELEM%illegal pathname element at path_name Facility: DEBUG, VMS Debugger< Explanation: Invocation numbers cannot be used with other pathnames.D User Action: Eliminate the continuation of the pathname after the invocation number. 3 ILLPATHIDENT+Unknown identifier in pathname at path_name Facility: DEBUG, VMS DebuggerD Explanation: An illegal identifier was specified in the pathname.+ UUser Action: Specify a legal identifier. 3 ILLPOSFLD0position field value position_value is too large Facility: DEBUG, VMS Debugger@ Explanation: The value of the position specifier in the BLISSA field reference is an incredibly large number, larger than the@ Debugger can handle. The value may be negative, which is also illegal.A User Action: Change the value of the position specifier in the: BLISS field reference to a smaller (or positive) value. 3 ILLVQUALIF1illegal or unsupported qualifier on SPAWN command Facility: DEBUG, VMS Debugger= Explanation: One of the qualifiers to the SPAWN command is incorrect.D User Action: Remove the incorrect qualifier to the SPAWN command. 3 ILLRANGECsubscript range not permitted here (must be at lowest level of data structure) Facility: DEBUG, VMS DebuggerA Explanation: The Debugger does not allow a range in an EXAMINE@ except as the last index in the array. That iWs, the memory toD examine must be a contiguous region. Unconnected slices of arrays are not allowed.@ User Action: Remove the range from the expression to examine.C Placing the corrected EXAMINE inside a Debugger FOR loop command> could provide the functionality needed to do the command as originally desired. 3 ILLSETCON"illegal set constant in expression Facility: DEBUG, VMS Debugger? Explanation: One of the constants specified in the given set@ expressXion has a type that is inconsistent with the set type.< User Action: Change the erroneous set constant value to a6 constant with a type that agrees with the set type. 3 ILLSIGEXT2illegal sign extension field value extension_value Facility: DEBUG, VMS Debugger> Explanation: An illegal value has been entered for the sign( extension field in a field reference.A User Action: Re-enter the command using a valid sign extension field value. 3 ILLSIZFLD,illegaYl size field size_value; must be 0..32 Facility: DEBUG, VMS DebuggerC Explanation: The size value for a BLISS field reference contains an illegal value.B User Action: Change the size value of the field reference to an' integer between 0 and 32, inclusive. 3 ILLSUBLEN.substring length larger than 32K not supported Facility: DEBUG, VMS Debugger; Explanation: The calculated length of a substring in the< expression is larger than can be handled by the DebugZger.A User Action: Do not use a substring with a length greater than8 32K in an expression to be evaluated by the Debugger. 3 ILLSUBSTR7can only apply substring operation to string data types Facility: DEBUG, VMS DebuggerA Explanation: The Debugger has found a substring operation, but5 the data type of the operand is not a string type.B User Action: Correct the data type of the string operand in the substring expression. 3 ILLTHUNKADDRillegal thun[k call address Facility: DEBUG, VMS Debugger= Explanation: The debugger detected a 0 addressed compiler-1 supplied routine during Value Spec evaluation.A User Action: Submit a Software Performance Report (SPR) to the appropriate compiler. 3 ILLTYPEillegal type of operand(s) Facility: DEBUG, VMS DebuggerC Explanation: The type of the operand is illegal for the operator specified.# User Action: Change the operand. 3 ILLVQUAL@Illegal ve\ctor instruction qualifier specified at 'command_line' Facility: DEBUG, VMS Debugger6 Explanation: A vector instruction qualifier that is= illegal for this vector instruction was specified during a DEPOSIT/INSTRUCTION command.= User Action: Do not specify that illegal qualifier on that instruction. 3 IMAGENF@target system image file_specification not found on host system. Facility: DEBUG, VMS DebuggerA Explanation: An image that is loaded on the targe]t system doesD not have a matching copy on the host system. The debugger can notC load any information about this image, therefore, debugging code in the image is impossible.B User Action: Check the the image search path on the host system@ for this image. Either fix the search path or place a copy of9 this image in that path and restart the debug session. 3 IMGMISMATCH@target system image file_specification does not match host copy. Facility: DEBUG, VMS Debugger^A Explanation: An image that is loaded on the target system doesC not match the host copy of that image. This occurs when the linkD time in the image header for the DSF or EXE file on the host does8 not match the link time of the target system's image.B User Action: Verify that the image path is set up correctly and@ that it points to the same images as are loaded on the target system. 3 INCDSTNES9incorrect DST nesting in module path_name, compiler error Fac_ility: DEBUG, VMS Debugger@ Explanation: Incorrect symbol table nesting occurred, such asC improper routine or data record nesting in the specified module.4 This message normally indicates a compiler error.5 User Action: Submit a Software Performance Report. 3 INCOMPOPR(operand number operand_number incomplete Facility: DEBUG, VMS DebuggerB Explanation: When parsing an instruction, the debugger found an incomplete operand.? User Action: Specify complete o`perands when entering machine instructions. 3 INCOMPPTR6pointers of different size, cannot perform subtraction Facility: DEBUG, VMS DebuggerC Explanation: The two pointers point to objects with incompatible@ types. A computation involving these pointers does not have a meaningful result.D User Action: Do not attempt to mix pointers of different types in arithmetic computations. 3 INCOMQUALAqualifier qualifier_name is not compatible with qualifier_naame(s) Facility: DEBUG, VMS DebuggerA Explanation: Qualifiers specified with the command conflict in their operations.3 User Action: Specify non-conflicting qualifiers. 3 INCOMTARGETDa debugger_type kernel debugger is incompatible with a debugger_type main debugger Facility: DEBUG, VMS Debugger@ Explanation: A kernel debugger attempted to connect to a main, debugger with which it is not compatible.A User Action: Make sure that the logical names used bto point at? the sharable and non_sharable debugger images are defined to' point to the same type of debuggers. 3 INCOMVERSIONBthe RPC versions of the main and kernel debuggers are incompatible Facility: DEBUG, VMS Debugger@ Explanation: A kernel debugger attempted to connect to a main, debugger with which it is not compatible.A User Action: Make sure that the logical names used to point at? the sharable and non_sharable debugger images are defined to' poicnt to the same type of debuggers. 3 INDBASEQLDindex and base registers are equal for operand number operand_number Facility: DEBUG, VMS DebuggerB Explanation: When parsing an instruction, the debugger found anA operand whose base register and index registers were the same.> The VAX instruction architecture forbids this construction.B User Action: Specify different registers for the base and index registers. 3 INIBRKtarget system interrupted. Facildity: DEBUG, VMS Debugger> Explanation: The target system has hit a break point in the@ INI$BRK system routine. The system code calls this routine inB order to return control to the debugger either because the callB is compiled into the code or an IPL 14 interrupt was generated. User Action: None. 3 INITERR?an error has occurred during debugger initialization, unable tocontinue this session. Facility: DEBUG, VMS Debugger8 Explanation: The debugger encounterede an error during@ initialization which does not allow this debugging session to proceed.> User Action: Use the message which preceded this message to0 analyze and correct the error, and try again. 3 INITIAL2language is language_name, module set to path_name Facility: DEBUG, VMS Debugger> Explanation: This message is displayed when the debugger isC invoked by the image activator. The language is set to language_C name, and the module to path_name. Module path_fname is the firstC module specified in the LINK command, and language language_name' is the language used in that module. User Action: None. 3 INPREADERRerror reading input line: Facility: DEBUG, VMS DebuggerB Explanation: There was an error from the system while trying to read the input line.@ User Action: Re-enter the command line. Check to see that the? Debugger has read access to the input source. If the problem8 persists, submit a Software Pgerformance Report (SPR). 3 INSNOTCURAVAno instructions for address address_value for display in display_name Facility: DEBUG, VMS DebuggerB Explanation: No instructions correspond to the address address_ value.4 User Action: None. This message is informational. 3 INSVIRMEM8insufficient virtual memory for the debugger memory pool Facility: DEBUG, VMS DebuggerD Explanation: An attempt to allocate additional memory for working storage failed.; h User Action: Cancel set modules to free space in memory. 3 INTERR0internal debugger error in debugger_routine_name Facility: DEBUG, VMS Debugger@ Explanation: An internal debugger error has been encountered.? User Action: If the error is reproducible, submit a Software> Performance Report and, if possible, enclose both a copy ofA the program being debugged and a logged debugging session that reproduces the error. 3 INTERRUPTED,process interrupted via crioss-process signal Facility: DEBUG, VMS DebuggerC Explanation: This signal is delivered asyncronously to a process7 to cause the debugger to be invoked in that process.B User Action: Submit an SPR. This message is handled internally,, and should never be signaled to the user. 3 INTMEMERRinternal memory-pool error Facility: DEBUG, VMS Debugger< Explanation: The debugger's internal memory area has beenB corrupted or is inconsistent. This can be caused by ajn internal: debugger error or by random stores by the user program.= User Action: Correct the user program or submit a Software Performance Report. 3 INTOVF'integer overflow at or near opcode_name Facility: DEBUG, VMS Debugger? Explanation: The value being deposited does not fit into the specified address.D User Action: Specify either a smaller value or a different target address. 3 INTVECERR=internal debugger coding error in using vector insktruction(s) Facility: DEBUG, VMS DebuggerD Explanation: An internal debugger error has been encountered whenC attempting to execute a vector instruction. Messages will follow5 this text which will more fully explain the error.? User Action: If the error is reproducible, submit a Software> Performance Report and, if possible, enclose both a copy ofA the program being debugged and a logged debugging session that reproduces the error. 3 INUMTRUNC'number trunclated at or near opcode_name Facility: DEBUG, VMS Debugger= Explanation: On some conversions packed numbers need to beC truncated to fit into their destination. Truncation is done from= the least significant digit to the most significant digit.< User Action: You should understand that the result of theA operation is imprecise and may not be exactly what you expect. 3 INVALTEXTRANGDthe debugger detected a error when retrieving text from a particularobject. m Facility: DEBUG, VMS DebuggerA Explanation: The debugger found a discrepancy in the ranges of& the text string that was retrieved.$ User Action: No action necessary. 3 INVARGLIS8invalid argument list for 'the debugger_command_segment' Facility: DEBUG, VMS Debugger= Explanation: There is an error with the argument list. The; Debugger may be expecting an argument list when none was? supplied. The Debugger may have found an argument list where@ one was not enxpected. The Debugger may have found an argumentA list that was too long or too short. Finally, the Debugger may4 have found an inconsistency in the argument list.@ User Action: Correct the command. Supply the correct argument@ list if one was missing or in error. Delete the inappropriate% argument list, if one was present. 3 INVARRDIMarray dimension is out of range Facility: DEBUG, VMS Debugger> Explanation: The array dimension is out of the range of the= doeclared size and shape of the array. Either the dimension@ requested is less than zero, or it is greater than the number- of dimensions the array was declared with.4 User Action: Correct the invalid array dimension. 3 INVARRDSCinvalid array descriptor Facility: DEBUG, VMS DebuggerB Explanation: An array descriptor in the image does not have theC correct format. This can be caused by a reference to a VAX BASICB array when the first line of the program has not be pen executed.< The array is not set up correctly until the BASIC program? initialization is done. This message can also be caused by aA user program or DEPOSIT commands altering a compiler generated array descriptor.9 User Action: If the reference is to a VAX BASIC array,> enter a STEP or GO command to ensure that the BASIC programC initialization is done and then repeat the reference. Otherwise,A if an array descriptor has not been altered, submit a Software Performqance Report. 3 INVCHARinvalid character Facility: DEBUG, VMS DebuggerB Explanation: When parsing the command, an invalid character was detected.C User Action: Enter the command specifying only valid characters. 3 INVCHRCON(invalid character constant in expression Facility: DEBUG, VMS DebuggerC Explanation: When evaluating a language expression, the debuggerB expected to find a closing single quote mark, or the end of the@ command. Some other crharacter was found, which resulted in an illegal language expression.2 User Action: Enter a valid language expression. 3 INVCMD5this command is not available for this configuration. Facility: DEBUG, VMS DebuggerD Explanation: This command is not available for this configuration< of the debugger. It may be available in a future version. User Action: None. 3 INVDEPTH(unable to access stack to depth of depth Facility: DEBUG, VMS DebuggerD Expslanation: The debugger is trying to access the register set of* a frame depth frames down on the stack.@ User Action: If you explictly requested for information aboutC that frame, (e.g. via a previous SET SCOPE command), modify your? command such that it is requesting information about a valid frame. 3 INVDESCinvalid string descriptor Facility: DEBUG, VMS DebuggerB Explanation: This message indicates an internal debugger error.5 User Action: Submit a Softtware Performance Report. 3 INVDIGBIN,invalid digit in binary number: number_value Facility: DEBUG, VMS DebuggerC Explanation: A numeric value other than '0' and '1' was found in a binary number.C User Action: Enter binary numbers specifying only digits '0' and '1'. 3 INVDIGDEC-invalid digit in decimal number: number_value Facility: DEBUG, VMS DebuggerC Explanation: A numeric value other than in the range '0' through% '9' was found in a deucimal number.@ User Action: Enter decimal numbers specifying only digits '0' through '9'. 3 INVDIGHEX1invalid digit in hexadecimal number: number_value Facility: DEBUG, VMS DebuggerC Explanation: A numeric value other than in the range '0' throughA '9' or an alphabetic value other than in the range 'A' throughB 'F' was found in a hexadecimal number. Hexadecimal numbers must9 also start with a numeric character, for example '0F'.D User Action: Enter hexavdecimal numbers specifying only digits '0'5 through '9' and alphabetic values 'A' through 'F'. 3 INVDIGOCT+invalid digit in octal number: number_value Facility: DEBUG, VMS DebuggerC Explanation: A numeric value other than in the range '0' through% '7' was found in a decimal number.@ User Action: Enter decimal numbers specifying only digits '0' through '7'. 3 INVDIRNAM*invalid directory name: file_specification Facility: DEBUG, VMS DebuggerB Ewxplanation: The directory name 'file_specification' given in aA DEBUGGER command SET SOURCE is not valid. Either the directory7 syntax is incorrect or the directory does not exist.D User Action: Ensure that the directory exists and that the syntax is correct. 3 INVDMTPTR6invalid DMT pointer; internal linker or debugger error Facility: DEBUG, VMS Debugger@ Explanation: The debugger found that the pointer in the imageC header to the Debug Module Table (DMT) was inxvalid. The debuggerB will continue from this error trying to initialize based on the Debug Symbol Table (DST).A User Action: Check that the image file hasn't been modified or? corrupted in some way. If not, submit a Software Performance Report (SPR). 3 INVDSPSIZ"invalid display size: display_size Facility: DEBUG, VMS DebuggerB Explanation: The SIZE value for a display must be between 1 and 1000.: User Action: Specify the SIZE value between 1 and 1000.y 3 INVDSTRECinvalid DST record Facility: DEBUG, VMS Debugger? Explanation: The debugger has detected an error in the DebugD Symbol Table of your program. This indicates an internal error in6 either the debugger or the compiler of this module.< User Action: Please submit a Software Performance Report. 3 INVEXPR4invalid expression for operand number operand_number Facility: DEBUG, VMS Debugger> Explanation: The specified operand was not correct for thzis instruction.> User Action: Please check the documentation for the correctC operands for this instruction, and re-enter the instruction with the correct operands. 3 INVFILHNDLinvalid file handle Facility: DEBUG, VMS DebuggerD Explanation: The debugger has detected an invalid file handle forD the given context connection. This indicates an internal error in' either the debugger or the compiler.< User Action: Please submit a Software Performance Rep{ort. 3 INVFIXDSTCinvalid DST fixup records in image image_name, symbol references to!shareable images may be erroneous Facility: DEBUG, VMS Debugger9 Explanation: While attempting to read the symbol table@ information in the specified image, the debugger found errorsD in the symbol table address fixup records. These records are usedC to adjust for the base addresses of shareable images. This meansC that any symbols in this image which point to addresses in otherB| (shareable) images will most likely be incorrect. Symbols whichB refer to addresses in this image will be correct unless this is also a shareable image.C User Action: Relink the image and, if the error is reproducible,@ submit a Software Performance Report explaining how the image file was created. 3 INVFLDREF3invalid field reference; too many or few parameters Facility: DEBUG, VMS Debugger@ Explanation: The Debugger could not complete the parse of the@ B}LISS field reference specification. Either the closing angleB bracket terminator was found too soon, or it was not found when it was expected., User Action: Correct the field reference. 3 INVGSTRECinvalid GST record Facility: DEBUG, VMS Debugger@ Explanation: The debugger has detected an error in the GlobalD Symbol Table of your program. This indicates an internal error in6 either the debugger or the compiler of this module.< User Action: Please submit a So~ftware Performance Report. 3 INVGSTTYP*invalid GST record; GST is partially built Facility: DEBUG, VMS DebuggerA Explanation: The debugger found an invalid Global Symbol Table; (GST) record in the image. The debugger will discontinueA initializing the GST at this point. The debugger will continue@ from this error, however global symbol information may not be complete.A User Action: Check that the image file hasn't been modified or? corrupted in some way. If not, submit a Software Performance Report (SPR). 3 INVMAR&right margin must be greater than left Facility: DEBUG, VMS DebuggerC Explanation: You specified a right margin that was less than theC left margin in the debugger command SET MARGIN. The right margin( must be greater than the left margin.> User Action: Re-enter the command specifying a valid margin range. 3 INVNUMBER%invalid numeric string 'number_value' Facility: DEBUG, VMS Debugger€D Explanation: A numeric value which was not in the specified radix( was found in the language expression.C User Action: Enter numbers specifying only valid digits for that radix. 3 INVNUMSRCinvalid number of source files Facility: DEBUG, VMS DebuggerB Explanation: An invalid number of source files was specified onA the SET MAX_SOURCE_FILES command. The maximum number of sourceC files that the debugger will keep open simultaneously must be in the range of 1 through 20.> User Action: Re-enter the command specifying a valid number within the range. 3 INVNUMSTR0invalid numeric string at or near 'number_value' Facility: DEBUG, VMS DebuggerD Explanation: The debugger encountered an error when attempting toD convert the specified value. This indicates that the string value" did not contain a valid number.@ User Action: Ensure that the string value contains only valid digits. 3 INVOPADDR8invalid oper‚ator 'operator_symbol' in address expression Facility: DEBUG, VMS Debugger= Explanation: Address expressions cannot contain operators.? User Action: Enter the address expression without operators. 3 INVOPSYM7invalid operator symbol 'operator_symbol' in expression Facility: DEBUG, VMS DebuggerB Explanation: Identifiers in address expressions must be shorter than 256 characters.+ User Action: Enter a shorter identifier. 3 INVPAGE?invalid screenƒ height, value must be between minimum_height andmaximum_height Facility: DEBUG, VMS DebuggerB Explanation: The height of the terminal which the debugger uses> to place it's windows must be between the values specified.A User Action: Specify the page size of the screen to be between the values specified. 3 INVPASS7the password does not match the target system password. Facility: DEBUG, VMS DebuggerB Explanation: The password specified in the connect comm„and doesB not match the password in the target systems password file. Or,@ no password was specified and the target system requires one.< User Action: Check to make sure the correct node name and@ password were specified. Check the target system to make sure both were set up correctly. 3 INVPD)procedure descriptor at !XL is not valid. Facility: DEBUG, VMS DebuggerD Explanation: The debugger could not read the procedure descriptorC at the given address. Therefo…re this procedure descriptor is not valid.@ User Action: Procedure descriptors are generated by compilersD (or MACRO64 programmers). Verify that the procedure descriptor is2 invalid or submit an SPR to the compiler group. 3 INVPRCSYN"process specification syntax error Facility: DEBUG, VMS DebuggerD Explanation: The specified process specification is syntactically invalidA User Action: Re-enter the command specifying a correct process specification † 3 INVPRIOR%invalid task priority value specified Facility: DEBUG, VMS DebuggerA Explanation: The priority of an Ada task must be between 0 and 15.6 User Action: Specify a valid priority for the task. 3 INVRANSPEC.invalid range specification in array subscript Facility: DEBUG, VMS Debugger> Explanation: A range specification in an array reference is= illegal. The Debugger may have found a range where none isA allowed. An asterisk may have been us‡ed as a range where it is? not allowed. The array subscripts may have more than one setB of ranges, which is not allowed. The range may be invalid, withA bounds greater than the declared bounds of the array. Finally,C the lower bound of the range may be greater than the upper bound of the array.< User Action: Correct the range specification in the array subscript. 3 INVSELDIS=invalid selection of display_name display; wrong display kind Facility: DEBUG, VMˆS DebuggerC Explanation: Some attributes can only be placed on certain typesD of displays. For example, the SOURCE attribute can only be placedC on source displays. The attribute you specified cannot be placed on the display you specified.D User Action: See the debugger documentation of the SELECT commandC for details on which attributes can be placed on which displays.A Specify attributes which are compatible with the display kind. 3 INVSRCLINinvalid source lin‰e range Facility: DEBUG, VMS Debugger? Explanation: An invalid source line range was entered in theD debugger TYPE command. The first line number of the range must beB non-negative and less than or equal to the second number in the range.C User Action: Re-enter the command specifying a valid line number range. 3 INVTIMSLI=time slice was not set, parameter is out of range of Ada typeDURATION Facility: DEBUG, VMS DebuggerA Explanation: The value Šspecified for the time slice was out of" range of the Ada type DURATION.> User Action: See the Ada documentation for the range of theA DURATION type. Specify time slice values which are in range of type DURATION. 3 INVWIDTH=invalid screen width, value must be between minimum_width and maximum_width Facility: DEBUG, VMS DebuggerD Explanation: The width of the terminal which the debugger uses to: place its windows must be between the values specified.A U‹ser Action: Specify the width of the screen to be between the values specified. 3 INVWINPAR&invalid window parameter: number_value Facility: DEBUG, VMS DebuggerB Explanation: The value specified was out of range of the screenA on which the window will be placed. If the debugger is placingA its windows on a terminal screen, the beginning row and columnD numbers must be between 1 and the height and width of the screen,A and the beginning value plus the height or wiŒdth of the window> must not exceed the height or width of the terminal screen.@ If the debugger is running with the DECwindows interface, the; beginning row and column numbers must be greater than 0.? User Action: Specify valid parameters for the window row and= column values, and for the height and width of the window. 3 IRFAOVF3record file address overflow at or near opcode_name Facility: DEBUG, VMS DebuggerC Explanation: The conversion of the ASCII string to a record fileD address caused an overflow. The conversion was performed however.; User Action: Check the value to make sure the conversion performed as expected. 3 ISTRTRU'string truncated at or near opcode_name Facility: DEBUG, VMS Debugger9 Explanation: The string did not fit into the specifiedD destination resulting in lost trailing characters. The conversion was performed however.; User Action: Check the value to make sure the conversion perŽformed as expected. 3 ITMNOTAVAitem not available Facility: DEBUG, VMS DebuggerD Explanation: The user should never see this message. The debugger> uses an item list construct for passing information between@ its parts. This message indicates that the requesting routine= requested data which the target routine was not capable of> providing. Appearance of this message indicates an internal problem in the debugger.: User Action: Submit a Software Performance Report (SPR) 3 ITMTRUNC,item truncated - buffer of insufficient size Facility: DEBUG, VMS DebuggerD Explanation: The user should never see this message. The debugger> uses an item list construct for passing information between@ its parts. This message indicates that the requesting routineA allocated a buffer which was too small for the requested data.B Appearance of this message indicates an internal problem in the debugger.: User Action: Submit a Software Performance Report (SPR) 3 IVALNOFIT>value does not fit into target location at or near opcode_name Facility: DEBUG, VMS Debugger> Explanation: The value can not be represented in the targetC location and may be truncated. The bit field is not large enough to hold the value.7 User Action: Check the value in the target location. 3 IVALOUTBNDS6value assigned is out of bounds at or near opcode_name Facility: DEBUG, VMS DebuggerD Explanation: The value ‘is out of the bounds defined for the data.' The operation was performed however.D User Action: Check the results of the operation to make sure they are as you expected. 3 IVPRCLOG?logical name DBG$PROCESS must be either MULTIPROCESS or DEFAULT Facility: DEBUG, VMS DebuggerD Explanation: The logical name DBG$PROCESS translates to something* other than "MULTIPROCESS" or "DEFAULT".C User Action: Correct the logical name assignment for DBG$PROCESS and try a’gain. 3 KEPTNOT1PROC9the kept debugger must be run as a multi-process debugger Facility: DEBUG, VMS DebuggerB Explanation: The kept debugger must be a master process runningC and rerunning programs as subprocesses. This is not possible forC a one process debugger. The kept debugger must be run using more than one process.C User Action: Correct the logical name assignment for DBG$PROCESS; to be either "MULTIPROCESS" or "DEFAULT", and try again. 3 KER“FUNCNYI9Kernel Function function_name not yet implemented on this architecture Facility: DEBUG, VMS DebuggerB Explanation: This message indicates an internal debugger error.5 User Action: Submit a Software Performance Report. 3 KERNOTAVAILChost kernel of the VMS system debugger not available on this system Facility: DEBUG, VMS DebuggerB Explanation: The host kernel for the VMS system debugger is not> available on this system so a connection could not be mad”e.4 User Action: Contact VMS Software, Inc. regarding availability of this feature. 3 KEYNAMERRunrecognized key name: key_name Facility: DEBUG, VMS DebuggerD Explanation: This keyname is in error. It can not be defined by the user./ User Action: Check spelling of the key name. 3 KEYSTATERR#unrecognized state name: state_name Facility: DEBUG, VMS DebuggerD Explanation: This key state is in error. It has • not been defined by the user.> User Action: Check spelling of the state name or define the state. 3 LASTCHANCE4stack exception handlers lost, re-initializing stack Facility: DEBUG, VMS DebuggerA Explanation: The user's program contained an error that caused> the exception handling mechanism to fail. This error occursB when the stack is overwritten by the user program or by deposit commands.C User Action: Identify and correct the error in the user program–. 3 LINEINFOline-description Facility: DEBUG, VMS DebuggerB Explanation: This is either 'No line information available', orD 'No line , previous line is ,# next line is ' 3 LOGFILEIS+the error log is in file file_specification Facility: DEBUG, VMS Debugger< Explanation: An internal debugger error has occurred, andB information which will be useful in locating the error has been! written to fi—le_specification.? User Action: If the error is reproducible, submit a Software> Performance Report and, if possible, enclose both a copy ofA the program being debugged and a logged debugging session that reproduces the error. 3 LONGSTRING2strings longer than 2**16 characters not supported Facility: DEBUG, VMS Debugger@ Explanation: The length of a string or the range of one arrayD bound is greater than 2**16. The string or array is too large for the Debug˜ger.D User Action: Do not use strings of this length with the Debugger. 3 LOOPINCRloop increment cannot be zero Facility: DEBUG, VMS DebuggerB Explanation: The loop increment specified on the FOR command is zero.A User Action: Change the loop increment to be a non-zero value. 3 LOOPVAR;loop var loop_variable has been redefined; exiting for loop Facility: DEBUG, VMS Debugger? Explanation: Since the loop variable has been redefined, theB deb™ugger will exit the loop. No further comparison is possible. User Action: None. 3 LOWBNDOPT*lower bound of subrange was optimized away Facility: DEBUG, VMS DebuggerC Explanation: The lower bound of the subrange was optimized away.B The largest negative number on the machine is being used as the lower bound.= User Action: You may wish to recompile the program without optimizations. 3 MAINFUNCNYIDMain Function function_name not yet implemented on tšhis architecture Facility: DEBUG, VMS DebuggerB Explanation: This message indicates an internal debugger error.5 User Action: Submit a Software Performance Report. 3 MASKMISMATCH4mask/target subscripts do not match, displaying mask Facility: DEBUG, VMS Debugger@ Explanation: The subscript values for the supplied mask valueC are different then the subscript values for the target value. ToB minimize confusion, Debug is showing the mask values as well as t›he target values.4 User Action: None, this message is informational. 3 MASKNOTUSED;mask operations not allowed on record and SCAN tree objects Facility: DEBUG, VMS Debugger? Explanation: A mask operation (as specified by the /TMASK orB /FMASK qualifiers) cannot be performed on a record or SCAN tree object.@ User Action: Specify an array or address range to perform the mask operation on. 3 MASKNOTVMR0mask used is not %VMR, displaying specified maskœ Facility: DEBUG, VMS Debugger: Explanation: The supplied mask is not %VMR. To minimizeD confusion, Debug is showing the mask values as well as the target values.4 User Action: None, this message is informational. 3 MASKPARNREQ+parenthesis required in 'EXAMINE/xMASK=(x)' Facility: DEBUG, VMS DebuggerC Explanation: Parentheses are required around the mask expression@ specified with the /TMASK or /FMASK qualifiers on the Examine command.: User Action: Include parantheses when specifying a mask expression. 3 MATQUOMISmatching quote is missing Facility: DEBUG, VMS DebuggerC Explanation: The matching quote at the end of a quoted string is missing.; User Action: Correct the error and re-enter the command. 3 MCHVECNOREADDmechanism array for exception frame frame-addr at mchvec-addr is notreadable Facility: DEBUG, VMS DebuggerA Explanation: The debugger is attempting to chain down the cal žlD stack, following frame pointers. The debugger has determined that@ part or all of the mechanism array for the exception frame at@ frame-addr is not accessible for reading. This vector lies at@ mchvec-addr. This usually indicates a corrupt frame list, butD could also indicate that the program has protected part of memory= in which the frame lies. In either case, this is an error.D User Action: Determine what part of your code is writing into theA FP register or overwritinŸg the saved frame pointer on the callC stack (or a preceding saved frame pointer) and correct it. SinceC the debugger looks at the call stack to symbolize addresses, youA may suppress some of these messages by typing the command "SET MODE NOSYMBOLIC". 3 MISCLOSUB%missing closing subscript parenthesis Facility: DEBUG, VMS Debugger9 Explanation: This is a syntax error in a Debug command; User Action: Reinvoke the command with the proper syntax 3 MISIN VNUM(misplaced invocation number in path_name Facility: DEBUG, VMS Debugger> Explanation: The invocation number was not placed after the@ innermost (rightmost) routine name in the specified pathname.> User Action: Correct the pathname and re-enter the command. 3 MISINVOPER0missing or invalid operator at 'operator_symbol' Facility: DEBUG, VMS DebuggerC Explanation: An operand was encountered in a language expression= when an operator was expected. For exampl¡e, 'EVALUATE A B' instead of 'EVALUATE A + B'.9 User Action: Specify valid operators between operands. 3 MISMODBEG3missing Module-Begin record in DST (compiler error) Facility: DEBUG, VMS Debugger@ Explanation: An expected Module-Begin record was not found inD the debugger Symbol Table. This indicates a probable error in the compiler output.5 User Action: Submit a Software Performance Report. 3 MISMODEND8missing Module-End in DST for path_name (c¢ompiler error) Facility: DEBUG, VMS DebuggerB Explanation: An expected Module-End record was not found in the@ debugger Symbol Table. This indicates a probable error in the compiler output.5 User Action: Submit a Software Performance Report. 3 MISOPEMIS:misplaced operator or missing operand at 'operator_symbol' Facility: DEBUG, VMS DebuggerC Explanation: An operand was encountered in a language expressionA when an operator was expected, or an operand di£d not follow anC operator. For example, 'EVALUATE A B' or 'EVALUATE A + ' instead of 'EVALUATE A + B'.9 User Action: Specify valid operators between operands. 3 MODUSCOPE/a module name was expected; path_name not valid Facility: DEBUG, VMS Debugger9 Explanation: This is a syntax error in a Debug command; User Action: Reinvoke the command with the proper syntax 3 MONITMNOTFNDBthe debugger detected an error when searching for information on a monito¤r item. Facility: DEBUG, VMS Debugger@ Explanation: When looking for up information for a particular0 monitor item, the debugger detected an error.A User Action: Try the debugger again, if the same results exist. submit a Software Performance Report (SPR). 3 MPARENREQ9parenthesis required around process list in debug_command Facility: DEBUG, VMS Debugger= Explanation: Parentheses must be placed around the process; list for debugger commands SET/PROCESS=¥(process-list) or DO/PROCESS=(process-list).@ User Action: Place parentheses around the process list in the command. 3 MPCOMMAND:command is only valid when multiprocess support is enabled Facility: DEBUG, VMS Debugger@ Explanation: The debugger was unable to execute the specifiedB command since it is only valid when the debugger's multiprocess support is enabled.? User Action: Restart the debugging session with multiprocessC support enabled. Multipro¦cess support is enabled by defining theA logical name DBG$PROCESS as follows: ($ DEFINE/JOB DBG$PROCESS MULTIPROCESS) 3 NAMSTRMIS1name string missing or invalid in %NAME construct Facility: DEBUG, VMS DebuggerC Explanation: The %NAME construct requires either a quoted string or a name to be supplied.? User Action: Specify a valid name after the %NAME construct. 3 NAMTOOLONGname is too long: 'symbol_name' Facility: DEBUG, VMS Debugger= Exp§lanation: Display and window names must be less than 80 characters in length.D User Action: Shorten the name to be less than 80 characters long. 3 NEEDMOREunexpected end of command line Facility: DEBUG, VMS Debugger@ Explanation: The command entered was not complete. A required# part of the command was omitted.. User Action: Re-enter the complete command. 3 NEEDPAREN2parenthesis required in THEN, ELSE, and DO clauses Facility: DEBUG, VMS Debugger¨> Explanation: Parenthesis are required in THEN, ELSE, and DO5 clauses to group the containing debugger commands.A User Action: Correct the THEN, ELSE, or DO clause by including parenthesis. 3 NETFAIL0network connection failed, reason = reason_code. Facility: DEBUG, VMS Debugger@ Explanation: The network connection between the host debuggerB and target system can fail for a variaty of reasons. The target@ system may have stopped responding or crashed. Or t©here could0 have been too many collisions on the network.; User Action: Check the reason code in the documentation. 3 NETRETRY-connection to target system failed, retrying. Facility: DEBUG, VMS DebuggerA Explanation: Either the connection could not be started or wasB interrupted due to a failure. The host debugger will try to re- connect to the target system.? User Action: If no connection is re-made after many retries,? check the target system's consoleª for errors. Also check the network. 3 NOACCESSR'no read access to address address_value Facility: DEBUG, VMS Debugger? Explanation: The address you specified cannot be read by the< debugger. Therefore the operation you requested cannot be performed.> User Action: Verify that the address being read is correct.? One way to do this is to use EVALUATE to find the address ofB the specified symbol, or to EXAMINE the descriptor to see if it specifies a val«id address. 3 NOACCESSW(no write access to address address_value Facility: DEBUG, VMS DebuggerD Explanation: A DEPOSIT, SET BREAK, or SET TRACE command specified> the address address_value. The debugger does not have writeC access to that page. The debugger requires write access in order4 to be able to set up breakpoints and tracepoints.C User Action: None. You cannot do the requested operation without proper access. 3 NOADDRREGBregister register_name¬ does not have an address use @register_name0to obtain the contents of register register_name Facility: DEBUG, VMS DebuggerD Explanation: The user has requested the address of a register but" registers do not have addresses- User Action: Examine the register directly 3 NOALOCERRLIST'Debug could not allocate an error list. Facility: DEBUG, VMS DebuggerB Explanation: A problem was detected in the processing of an ACAA Services message and Debug could not allo­cate an error list so5 that this error could be reported to ACA Services.5 User Action: Submit a Software Performance Report. 3 NOALTERSP4deposit into register 14 (stack pointer) not allowed Facility: DEBUG, VMS DebuggerC Explanation: You can not deposit into the stack pointer register@ because the debugger is on the stack and it would corrupt the$ debugger or program stack frames. User Action: None. 3 NOATTACHattach command failed Facilit®y: DEBUG, VMS DebuggerD Explanation: The ATTACH command could be not performed because ofB an error which was returned by the system service called by theD debugger. The error status returned by the system service routine follows this message.C User Action: Correct the problem based on the associated message, which follows the debugger error message. 3 NOBKPTEXTAthe debugger detected a error when retrieving the text associatedwith a breakpoint. Facility: DEBUG¯, VMS DebuggerC Explanation: The debugger could not retrieve the associated text! which belongs to a breakpoint.A User Action: Try the debugger again, if the same results exist. submit a Software Performance Report (SPR). 3 NOBKPTVIEW=the breakpoint view has not been created. Breakpoints are notCactivated/deactivated/deleted in the breakpoint view until the view is created. Facility: DEBUG, VMS Debugger@ User Action: Create the breakpoint view from the "VIE°W" menu. 3 NOBREAGGRBbreakpoints or tracepoints on registers, records or arrays are notallowed Facility: DEBUG, VMS DebuggerB Explanation: Only watchpoints are allowed on registers, records or arrays.> User Action: Either change the address of the breakpoint or6 tracepoint, or specify a watchpoint on the address. 3 NOBREAKAT<cannot set breakpoint or tracepoint at address address_value Facility: DEBUG, VMS DebuggerB Explanation: The user has reque±sted that a breakpoint be set atB an address that is either non-writable, in Debug, or invalid in some other way.; User Action: Correct the address and reissue the command 3 NOBREAKSno breakpoints are set Facility: DEBUG, VMS Debugger9 Explanation: The SHOW BREAK command was entered and no breakpoints were set. User Action: None. 3 NOCALLSno active call frames Facility: DEBUG, VMS Debugger? Explanation: The call stack cannot be displ²ayed because yourA program has run to completion, and there are no call frames on the stack. User Action: None. 3 NOCANMAINcannot cancel main image Facility: DEBUG, VMS DebuggerB Explanation: The user has requested that the main image symbols- be canceled. This is an invalid operation.7 User Action: No action required - operation invalid. 3 NOCLI"no CLI present to perform function Facility: DEBUG, VMS DebuggerB Explanation: There is n³o command line interpreter in the target/ process from which to perform the operation.A User Action: None. You cannot perform the attempted operation. 3 NOCONNECTCONNECT command failed Facility: DEBUG, VMS Debugger> Explanation: The debugger was unable to execute the connect= command. The reason is given in the message following this message.C User Action: Correct the problem given by the messages following? this message. Most often, the problem is due ´to specifying a@ process that does not exist. If the problem cannot be solved,( submit a Software Performance Report. 3 NOCONNECTCONFIG:command is only valid in multiprocess and/or kept debugger configuration Facility: DEBUG, VMS Debugger@ Explanation: The debugger was unable to execute the specifiedA command because the current configuration of the debugger doesB not allow connection or disconnection. The specified command isB only valid when the debugger's mult µiprocess support is enabled,? or when the debugger is running in the "kept" configuration.? User Action: Restart the debugging session with multiprocess@ support enabled in the kept debugger. Multiprocess support isB enabled by defining the logical name DBG$PROCESS as follows: ($D DEFINE/JOB DBG$PROCESS MULTIPROCESS) The kept debugger is usually? invoked with the following command: $ RUN SYS$SHARE:DEBUGSHRD Your system may be different; consult your release notes and your ¶ system management. 3 NOCORRFAC9cannot perform operation without the Correlation Facility Facility: DEBUG, VMS Debugger< Explanation: The given operation requires the Correlation> Facility and the appropriate correlation data. Without thisA information, the debugger cannot determine how to complete the operation.: User Action: Make sure that the Correlation Facility is? appropriately set up and in use when compiling and debugging the given program. ·3 NOCROSSPROC4cross-process signal system service is not available Facility: DEBUG, VMS Debugger@ Explanation: The debugger was unable to execute the specifiedA command because the cross-process signal system service is not$ available in this version of VMS.? User Action: Upgrade to a version of VMS that has the cross-! process signal system service. 3 NOCROSSUICGRP6cannot connect to a process with a different UIC group Facility: DEBUG, VMS Debugger; ¸ Explanation: The given operation is not supported by the@ Debugger. You can only connect to processes with the same UIC- group as the process running the Debugger.D User Action: Make sure that the process you want to connect to is= in the same UIC group as the process running the Debugger. 3 NOCURLOCcurrent location not defined> Facility: DEBUG, VMS Debugger '.' is not currently defined.8 User Action: Do not reference '.' until an EXAMINE or/ EVALUATE/ADDRESS ¹command has been performed. 3 NODEFSCPE+No default scope list: error performing !AC Facility: DEBUG, VMS DebuggerA Explanation: The specified command or built-in symbol requires. that the default scope list be established.> User Action: To establish the default scope list, perform a CANCEL SCOPE command. 3 NODELIMTR0missing or invalid instruction operand delimiter Facility: DEBUG, VMS DebuggerB Explanation: A DEPOSIT command specified an invalid iºnstruction operand format.9 User Action: Re-enter the command with valid operands. 3 NODEPDEBUG8DEPOSIT into the debugger's address space is not allowed Facility: DEBUG, VMS Debugger< Explanation: The user has tried to deposit into addresses1 occupied by the Debugger. This is not allowed.< User Action: Correct the address and reissue the command. 3 NODEPR31F31 deposits to R31/F31 not allowed. Facility: DEBUG, VMS DebuggerC Explanation: On Alp»ha, registers R31 and F31 are permanently set@ to zero. Users, therefore, may not deposit to either of these registers.? User Action: Do not attempt to deposit to either R31 or F31. 3 NODIRLISM0no source directory list in effect for path_name Facility: DEBUG, VMS DebuggerC Explanation: The debugger command CANCEL SOURCE/MODULE=path_nameD failed because there is no source directory search list in effect for module path_name.A User Action: This is an infor¼mational message. However, if theD wrong module was specified, the command should be re-entered with the correct name. 3 NODIRLIST"no source directory list in effect Facility: DEBUG, VMS Debugger@ Explanation: The debugger command CANCEL SOURCE had no effectB because no source directory search list is currently in effect.4 User Action: None. This message is informational. 3 NODIRNAMESELECTEDNo directory is selected. Facility: DEBUG, VMS Debugger ½3 NODISCONNECTDISCONNECT command failed Facility: DEBUG, VMS DebuggerA Explanation: The debugger was unable to execute the disconnect= command. The reason is given in the message following this message.C User Action: Correct the problem given by the messages following? this message. Most often, the problem is due to specifying a@ process that does not exist. If the problem cannot be solved,( submit a Software Performance Report. 3 NODSTVER6versio ¾n info missing for module !AC (generated by !AC) Facility: DEBUG, VMS Debugger= Explanation: The compiler-generated Debug Symbol Table for? the specified module does not contain a valid version number? identifier. The debugger is unable to determine if the Debug Symbol Table is valid.C User Action: Submit an SPR to the compiler or assembler that wasB used to compile the module. Include the compiler version number: and a sample source program which reproduces the er¿ror. 3 NOELABBODY-package body path_name has no executable code Facility: DEBUG, VMS Debugger 3 NOELABSPEC-package spec path_name has no executable code Facility: DEBUG, VMS Debugger 3 NOEND=string beginning with 'string_value' is missing end delimiterdelimiter_character Facility: DEBUG, VMS Debugger> Explanation: A DEPOSIT command specified an ASCII string orA INSTRUCTION string beginning with characters string_value that( do not have aÀ terminating apostrophe.A User Action: Re-enter the command with characters containing a terminating apostrophe. 3 NOEPTSPEC<no eventpoints were specified with a SHOW or CANCEL command. Facility: DEBUG, VMS Debugger@ Explanation: Eventpoints were not given with a SHOW or CANCEL command.@ User Action: Try the command again, specifying eventpoints to operate on. 3 NOEVALEXPR2unable to evaluate expression for following reason Facility: DEBUG, VMÁS DebuggerD Explanation: The expression could not be evaluated. The following message indicates why.* User Action: See the following message. 3 NOEVENTFACDthe /EVENT qualifier is not allowed: first type 'SET EVENT facility'to specify an event facility Facility: DEBUG, VMS Debugger@ Explanation: No event facility has been set up yet, thereforeA no events which use an event facility can be set, canceled, or displayed.C User Action: Set an event facilitÂy, and try the operation again. 3 NOEXCBREno exception breaks were set Facility: DEBUG, VMS DebuggerA Explanation: A CANCEL BREAK/EXCEPTION command was entered whenB exception breaks were not in effect. The CANCEL BREAK/EXCEPTION command had no effect.4 User Action: None. This message is informational. 3 NOEXHNDno exit handlers are declared Facility: DEBUG, VMS Debugger> Explanation: There are no user-mode exit handlers currently declared.Ã4 User Action: None. This message is informational. 3 NOFIELD*'field_name' is not a field in this record Facility: DEBUG, VMS DebuggerD Explanation: An attempt was made to reference a field that is not defined in the record.> User Action: Check the field specified to ensure that it is defined in the record. 3 NOFREEno free storage available Facility: DEBUG, VMS Debugger; Explanation: The debugger has used all memory available.A User ÄAction: Memory must be made available before the debugger@ can continue executing. SET modules could be canceled, or the= debugging session can be stopped and system management can. increase the virtual memory on your system. 3 NOGLOBALS)some or all global symbols not accessible Facility: DEBUG, VMS DebuggerA Explanation: The image was linked with the /NODEBUG qualifier,7 and there are no global symbols in the symbol table.; User Action: Relink the image with Åthe /DEBUG qualifier. 3 NOHEAP%the Heap Analyzer will not be invoked Facility: DEBUG, VMS DebuggerC Explanation: The debugger encountered a problem trying to define; the librtl logical required to invoke the Heap Analyzer.B User Action: Insure there is enough room in the process logicalC name table for the debugger to define the librtl logical. If so,@ and the command still fails, define the librtl logical at theA DCL level, restart the debugger and reexecuteÆ the RUN or RERUN command. 3 NOHIDDENDEBUG;The Debug message cannot be executed when the UI is hidden. Facility: DEBUG, VMS DebuggerB Explanation: The Debug message cannot be executed when a HideUI message is in effect.? User Action: Send the ShowUI message and then re-execute the Debug message. 3 NOHLPLIB1the debugger could not open the help library file Facility: DEBUG, VMS DebuggerA Explanation: The debugger could not open the help libÇrary file4 because there was some low level file open error.A User Action: Check for user quotas being exceeded. For furtherD assistance and information on this problem check with your system manager. 3 NOINPAVAILinput objects not available Facility: DEBUG, VMS DebuggerC Explanation: The debugger was unable to open either DBG$INPUT or SYS$INPUT.C User Action: Check that logicals used to point at input files or devices are properly defined. È 3 NOINPFOC8debugger must have input focus to accept paste operation Facility: DEBUG, VMS DebuggerA Explanation: A writeable debugger window and, if applicable, aC text-entry field in that window must have the input focus before8 the selection can be pasted to it from the clipboard.D User Action: Assign the input focus to a writeable window and, if3 applicable, to the appropriate text-entry field. 3 NOINSTRAN1cannot translate opcode at location address_valueÉ Facility: DEBUG, VMS Debugger? Explanation: The address specified in the EXAMINE command isB not the beginning of a valid instruction. This can be caused byC specifying an address that is in the middle of an instruction or( by an address that is in a data area.8 User Action: Specify an address that contains a valid instruction. 3 NOINVCTXINSTHAN=Debug cannot retrieve the invocation context instance handle. Facility: DEBUG, VMS DebuggerB Explanation: ÊIn the course of trying to execute an ACA ServicesA message, Debug has tried and failed to retrieve the invocation- context instance handle from ACA Services.5 User Action: Submit a Software Performance Report. 3 NOKERNEL3this kernel debugger does not exist in this context Facility: DEBUG, VMS DebuggerC Explanation: Debug main is trying to communicate with the kernelB debugger in a context where the kernel debugger does not exist.; User Action: Submit a SofËtware Performance Report (SPR). 3 NOKEYDEF/cannot do keypad input, mode is set to NOKEYPAD Facility: DEBUG, VMS Debugger< Explanation: The user is trying to define or set a keypad; definition which can not be performed due to the current operating mode.? User Action: Use a terminal that supports keypad operations. 3 NOKEYPAD#unable to set up keypad definitions Facility: DEBUG, VMS Debugger< Explanation: An error status was returned from the ScÌreen> Management Facility that indicates that the debugger keypad definitions are corrupted.B User Action: Try to set keypad mode again (SET MODE KEYPAD). IfB this fails to correct the problem submit a Software Performance Report (SPR). 3 NOLASTVALlast value is not defined> Facility: DEBUG, VMS Debugger '\' is not currently defined.@ User Action: Do not reference '\' until a DEPOSIT or EVALUATE command has been performed. 3 NOLINXXXline_descriptoÍr Facility: DEBUG, VMS Debugger= Explanation: The line number range CZ:yyy specified on the? DEBUGGER command TYPE does not exist. There are no such line; numbers in the specified module (or the default module).D User Action: Re-enter the command specifying line numbers that do exist. 3 NOLIST=list of parameter values not allowed - check use of comma (,) Facility: DEBUG, VMS DebuggerD Explanation: A command that only accepts a single input value forÎ@ a parameter contains multiple values separated by commas (,).; User Action: Re-enter the command; specify one value. If4 necessary, issue the command once for each value. 3 NOLOCALS$image does not contain local symbols Facility: DEBUG, VMS Debugger= Explanation: All the modules in the image were compiled orD assembled without traceback information. There is no local symbol information in the image.D User Action: Recompile or reassemble the modules using Ïthe /DEBUG" qualifier and then relink them. 3 NOMAINCthe debugger detected an error when trying to fetch the main window(from the Digital Resource Manager (DRM). Facility: DEBUG, VMS DebuggerC Explanation: The debugger detected an error when trying to fetchA debuggers main window from the Digital Resource Manager (DRM).; This prevents the debugger from continuing this session.A User Action: Try the debugger again, if the same results exist. submit a SoftwareÐ Performance Report (SPR). 3 NOMARKCHNG@[NO]MARK_CHANGE qualifier not applicable to display_name display Facility: DEBUG, VMS DebuggerB Explanation: The /MARK_CHANGE and /NOMARK_CHANGE qualifiers can3 not be applied to the indicated kind of display. User Action: None. 3 NOMATCH no matches Facility: DEBUG, VMS DebuggerC Explanation: A SEARCH command was being used and no matches were found" User Action: No action required 3 NOMONEXPRÑ0no monitor entry was found matching "expression" Facility: DEBUG, VMS Debugger? Explanation: The input "monitor /delete" expression does not* match with any currenly monitored item.B User Action: Retry "monitor /delete" with corrected expression. 3 NOMOREwildcard request complete Facility: DEBUG, VMS Debugger7 Explanation: This is a debugger internal error code.B User Action: If the debugger reports this error please submit a Software Performance ÒReport. 3 NOMOTIF=motif images not found; defaulting to not run as a DECwindowsdebugger Facility: DEBUG, VMS Debugger; Explanation: The images of the Motif layered product areD optionally installed. If the Motif user interface to the debuggerC is desired, then Motif must be properly installed, otherwise the( default character cell mode will run.@ User Action: If desiring the Motif user interface, check that Motif is installed correctly. 3 NONAMEDWIDGÓET-Widget by name !AC not found in the UID file. Facility: DEBUG, VMS Debugger 3 NONAMEMATCHCThe specified name does not match any of the names in the selectionbox. Facility: DEBUG, VMS DebuggerB Explanation: A name was entered as the selection that is not in the selection box.+ User Action: Select a name from the box. 3 NONEXPRnonexistent process Facility: DEBUG, VMS DebuggerB Explanation: A process name or process identification specifiÔed in a command is not valid.A User Action: Verify that the process name or identification isD correct and that the process was not already deleted. Also verify> that you have the required privilege to access the process. 3 NONEXPRC,process process-specification does not exist Facility: DEBUG, VMS Debugger> Explanation: The process-specification was not valid or the# specified process did not exist.D User Action: Verify that the process specification is cÕorrect and? that the process still exists and then re-enter the command. 3 NONUMSCOPE:scope does not exist or is not in set module: scope_number Facility: DEBUG, VMS DebuggerB Explanation: The debugger could not find the scope indicated by( the numbered scope in the scope list.8 User Action: Set the module that contains that scope. 3 NONXTLIN(next line for source display not defined Facility: DEBUG, VMS Debugger? Explanation: The debugger command TÖYPE or SEARCH was entered? without specifying a line number (for example, the next lineB after the last source line printed should be used). But no next$ source line is currently defined.> User Action: Re-enter the command explicitly specifying the desired line number. 3 NOOCCLDISP(display_name display may not be occluded Facility: DEBUG, VMS DebuggerC Explanation: A display was positioned over the indicated display@ that is not allowed to be occluded. The× indicated display was popped to the front.= User Action: You may wish to move the display so it is not0 occluded by the display named in the message. 3 NOOUTAVAIL output objects are not available Facility: DEBUG, VMS DebuggerD Explanation: The debugger was unable to open either DBG$OUTPUT or SYS$OUTPUT.D User Action: Check that logicals used to point at output files or devices are properly defined. 3 NOOUTVIEW/the debugger can not write to the ØMessage view. Facility: DEBUG, VMS DebuggerA Explanation: The debugger got an unexpected status when tryingA to write to the Message view . This prevents the debugger from continuing this session.A User Action: Try the debugger again, if the same results exist. submit a Software Performance Report (SPR). 3 NOPACKMEMBODY7'symbol_name' is not a member of package body path_name Facility: DEBUG, VMS Debugger 3 NOPACKMEMSPEC7'symbol_name' is not a memÙber of package spec path_name Facility: DEBUG, VMS Debugger 3 NOPARSEINSTHAND:Debug cannot parse the invocation context instance handle. Facility: DEBUG, VMS DebuggerB Explanation: Debug cannot parse the invocation context instance& handle retrieved from ACA Services.5 User Action: Submit a Software Performance Report. 3 NOPREDlogical predecessor not defined Facility: DEBUG, VMS Debugger< Explanation: The logical predecessor of the identifier Úor) instruction referenced is not defined.4 User Action: None. This message is informational. 3 NOPROGRAMAThis operation cannot be done without a running program. Functionfunction_name. Facility: DEBUG, VMS Debugger= Explanation: There is no program currently being debugged.D User Action: Start a program using RUN or RERUN, then reenter the command. 3 NOPROMPTCcannot delete, remove, unselect, or change kind of the display_namedisplay FacilÛity: DEBUG, VMS Debugger9 Explanation: This display can not be deleted, removed,) unselected, or have it's kind changed. User Action: None. 3 NORADBLIFLD,radix override not allowed with BLISS fields Facility: DEBUG, VMS Debugger< Explanation: The use of a radix override qualifier is notA supported when evaluating a BLISS field reference. BLISS fieldC references are always displayed using a decimal notation. It is,D however, possible to use a radix overriÜde qualifier when refering$ to the contents of a BLISS field.< User Action: Don't use a radix switch with a BLISS field. 3 NORECSYM>recursive symbol_type symbol definition encountered at or near'debugger_command_segment' Facility: DEBUG, VMS Debugger> Explanation: While attempting to expand a defined symbol, a/ recursive symbol definition was encountered.B User Action: Redefine the symbol specified in the error messageA so that it does not contain any circulaÝr dependencies and then re-enter the command. 3 NORERUNPGMThere is no program to RERUN. Facility: DEBUG, VMS DebuggerA Explanation: You must RUN a program first before you can RERUN it.: User Action: Use the RUN command and specify a program. 3 NORETBRKAunable to set return break; breakpoint set on caller's return PC. Facility: DEBUG, VMS Debugger7 Explanation: This is a debugger internal error code.B User Action: If the debugger reportÞs this error please submit a Software Performance Report. 3 NORMALsuccessful debugger statusA Success: This is an internal status signal, it should never be? seen by the user. If this message does occur please submit a% Software Performance Report (SPR).; User Action: Submit a Software Performance Report (SPR). 3 NORSTBLDcannot build symbol table Facility: DEBUG, VMS Debugger> Explanation: The debugger is unable to build a symbol table5 becßause of errors in the format of the image file.C User Action: Relink the image and, if the error is reproducible,@ submit a Software Performance Report explaining how the image file was created. 3 NOSAVEDREGSDcan't find the saved registers for the CALL command for frame frame-addr Facility: DEBUG, VMS DebuggerA Explanation: The debugger is attempting to chain down the call? stack, following frame pointers. The debugger has determinedA that the frame at frame à-addr was caused by a CALL command fromC the debugger. The debugger is unable to find the register set it1 saved for the context before the CALL command.D User Action: Determine what part of your code is writing into theA FP register or overwriting the saved frame pointer on the callC stack (or a preceding saved frame pointer) and correct it. SinceC the debugger looks at the call stack to symbolize addresses, youA may suppress some of these messages by typing the command "áSET MODE NOSYMBOLIC". 3 NOSAVPROG!cannot save a program I/O display Facility: DEBUG, VMS Debugger@ Explanation: The SAVE command is not allowed on a program I/O? display since the debugger does not know the contents of the display. User Action: None. 3 NOSCOPE+no scope exists to look up line line_number Facility: DEBUG, VMS DebuggerA Explanation: The specified line_number cannot be found because. there is no current scope to look it upâ in.; User Action: Specify the module explicitly and retry the operation. 3 NOSCOPELIST2a list of scopes is not allowed with this command. Facility: DEBUG, VMS Debugger: Explanation: You cannot enter a list of scopes with the previously executed command.; User Action: Enter the command with only one scope item. 3 NOSCRATCHSPACE/the target system has run out of scratch space. Facility: DEBUG, VMS DebuggerB Explanation: Scratch space is allãocated on the target system toC implement single stepping. The target system has run out of this% space so no more work can be done.D User Action: Reboot the target system with more scratch space andB try the debugger again. See the documentation for more details. 3 NOSCRDEVAscreen mode is not supported on this device screen mode output is being lost Facility: DEBUG, VMS DebuggerB Explanation: The debugger output is being sent to a device that> the Screen Manaägement Facility does can not write to. WhileB the debugger will continue to process commands, the screen mode output will be lost.@ User Action: Make sure the logical DBG$OUTPUT is pointed to a; device that the Screen Management Facility can write to. 3 NOSCRMODEDscreen mode is not supported on this terminal screen mode is not set Facility: DEBUG, VMS DebuggerD Explanation: Screen mode is not allowed on the terminal type used by the current session.> User åAction: Use another terminal if screen mode is desired 3 NOSCROLL5no scrolling display selected or missing display name Facility: DEBUG, VMS Debugger> Explanation: The user did not enter a display name with theB command, and the debugger attempted to use the display with theA SCROLL attribute. However, no display currently has the SCROLL attribute.@ User Action: Either reenter the command, specifying a display= name, or SELECT a display to have the SCROLL attræibute and reenter the command. 3 NOSCROLLDISP(display_name display may not be scrolled Facility: DEBUG, VMS Debugger1 Explanation: This display can not be scrolled. User Action: None. 3 NOSEGLIST=the debugger detected an error when trying to access a source)display segment in routine function_name. Facility: DEBUG, VMS DebuggerD Explanation: The debugger got an unexpected status when trying toC access a source display segment. This prevents çthe debugger from continuing this session.A User Action: Try the debugger again, if the same results exist. submit a Software Performance Report (SPR). 3 NOSETTERM:the SET TERMINAL command is not supported on this terminal Facility: DEBUG, VMS Debugger> Explanation: The SET TERMINAL command is not allowed on the. terminal being used for the current session, User Action: Use another type of terminal 3 NOSPAWNspawn command failed Facility: DEBUGè, VMS DebuggerA Explanation: The debugger failed to perform a SPAWN command orD SPAWN an editor. The error status returned from the SPAWN command% is appended to this error message.> User Action: If the SPAWN error is correctable, correct the@ problem and reenter the command. If not, the SPAWN command is unavailable. 3 NOSRCHSTRsearch string not set Facility: DEBUG, VMS DebuggerD Explanation: No current search string is defined for the debuggerB commaénd SEARCH. The SEARCH command was entered without a searchC string indicating that the current search string should be used.> But no previous SEARCH command has been entered to define a current search string.C User Action: Explicitly specify the desired search string on the command. 3 NOSRCLIN(no source line for address address_value Facility: DEBUG, VMS DebuggerB Explanation: No source line corresponds to the address address_: value specified on the debuêgger command EXAMINE/SOURCE.4 User Action: None. This message is informational. 3 NOSTEPGOCno STEP, GO, SET PROCESS/VISIBLE or CALL commands allowed in screendisplays Facility: DEBUG, VMS Debugger? Explanation: A STEP, GO, SET PROCESS/VISIBLE or CALL commandC was used in a screen display command list. The debugger does not; allow the use of such commands in display command lists.B User Action: Re-specify the screen display command list without( using any oëf the disallowed commands. 3 NOSTEPMEMLK<should not stop inside critical sections delimited by memorylocking/unlocking instructions. Facility: DEBUG, VMS DebuggerA Explanation: The debugger has limited support for debugging of@ critical sections delimited by memory locking/unlocking (e.g.@ LDx_L/STx_C (load-locked/store-conditional) instructions. TheA exception mechanisms used by the debugger causes the lock-flagD set by the locking instruction to be cleared. This ìaction affectsD the behavior of subsequent instructions that rely on memory being locked.B User Action: Cancel or deactivate all eventpoints (watchpoints,D breakpoints, etc.) that might trigger while the application beingA debugged is executing the critical section; a STEP issued from> the load_lock instruction should now step over the critical1 section. Eventpoints then may be safely reset. 3 NOSUCClogical successor not defined Facility: DEBUG, VMS DebuggeríC Explanation: The logical successor of the referenced instruction or identifier is not defined.4 User Action: None. This message is informational. 3 NOSUCHBPTno such breakpoint Facility: DEBUG, VMS DebuggerB Explanation: The CANCEL BREAK command specified an address that& is not the address of a breakpoint.B User Action: Use the SHOW BREAK command to find the location ofD the current breakpoints, and then cancel any of these breakpoints that you wantî to cancel. 3 NOSUCHDISP%no such display defined: display_name Facility: DEBUG, VMS DebuggerB Explanation: The specified display does not exist.< User Action: Re-enter the command, specifying an existing display. 3 NOSUCHELP*no such help topic or invalid HELP command Facility: DEBUG, VMS DebuggerA Explanation: The user has requested help for a topic for which> there is no help or the syntax used to request the help was ï invalidD User Action: Try another topic or just type HELP for a topic list 3 NOSUCHIMGimage image_name not found Facility: DEBUG, VMS Debugger> Explanation: The specified image does not exist.C User Action: Re-enter the command, specifying an existing image. 3 NOSUCHMODU'module path_name is not in module chain Facility: DEBUG, VMS DebuggerA Explanation: The module path_name, specified in the SET MODULEC command, does nðot exist in the image. This message can be caused@ when: (1) a module name has been entered incorrectly or (2) a/ module is compiled with the /NOTRACE switch.6 User Action: Specify a module that is in the image. 3 NOSUCHPACK4library package path_name is not in the symbol table Facility: DEBUG, VMS Debugger 3 NOSUCHSCOPE8scope does not exist or is not in set module: scope_name Facility: DEBUG, VMS DebuggerD Explanation: The user has requested that the cuñrrent scope be set4 to a scope that is invalid for the current module? User Action: Correct the scope specification and reissue the command 3 NOSUCHTASK1no such task exists or no task satisfies criteria Facility: DEBUG, VMS Debugger@ Explanation: The user entered a task expression that does notD correspond to an existing task, or no existing task satisfies the task expression.? User Action: Reenter the command with a task expression that specifies aòn existing task. 3 NOSUCHTPTno such tracepoint Facility: DEBUG, VMS DebuggerB Explanation: The CANCEL TRACE command specified an address that' was not the address of a tracepoint.A User Action: Use the SHOW TRACE command to display the current; tracepoints and then cancel any that you want to cancel. 3 NOSUCHWIND$no such window defined: display_name Facility: DEBUG, VMS Debugger@ Explanation: The specified, or defaulted window does not exist.B User Action: Reenter the command, specifying an existing window name. 3 NOSUCHWPTno such watchpoint Facility: DEBUG, VMS DebuggerB Explanation: The CANCEL WATCH command specified an address that' was not the address of a watchpoint.A User Action: Use the SHOW WATCH command to display the current; watchpoints and then cancel any that you want to cancel. 3 NOSYMBOL/symbol 'symbol_name' is not in the symbol table Facility:ô DEBUG, VMS Debugger@ Explanation: The debugger could not find the symbol '' in its symbol table.@ User Action: The symbol may have been entered incorrectly, inA which case the fix is to enter the symbol correctly. The other> possibility is that the module the symbol is defined in hasB not been loaded into the debugger's symbol table; perform a SET$ MODULE of the appropriate module. 3 NOSYMBOLR9no symbol 'symbol_name' was declared in routine pathõ_name Facility: DEBUG, VMS Debugger 3 NOTADAPROG.program is not an ADA program; command ignored Facility: DEBUG, VMS DebuggerB Explanation: The entered command applies only to Ada programs ;D since this is not an Ada program, the command cannot be executed.( User Action: No user action required. 3 NOTARRAYtype of variable is not array Facility: DEBUG, VMS DebuggerC Explanation: The variable being treated as an array has not been defined aös one.B User Action: Check that the correct variable reference is being made. 3 NOTASTRUCT-'symbol_name' was not declared as a structure Facility: DEBUG, VMS Debugger> Explanation: A VAX BLISS-32 structure reference specified a8 symbol symbol_name that was not declared a structure.C User Action: Re-enter the command with a valid symbol reference. 3 NOTATMAIN'type GO to get to start of main program Facility: DEBUG, VMS Debugger< Explanation: ÷The debugger has started at the beginning of LIB$INITIALIZE code.B User Action: If you want to get to the actual start of the main? program you should type GO at the debug prompt. The debugger@ will allow the program to execute the LIB$INITIALIZE code and@ then break at the start of the main program. If you'd like toD debug the LIB$INITIALIZE code you are positioned to do so at this point. 3 NOTCURPC?target of EXAMINE/OPERANDS is not the current PC results may beø unexpected Facility: DEBUG, VMS Debugger> Explanation: The operands being examined will probably give= incorrect results, because the context for the instruction? is probably not set up properly. Specifically, the values of@ registers used in address computations depend on the previousD series of instructions being executed, which was not done in this case.5 User Action: Only use EXAMINE/OPERANDS with .0\%PC 3 NOTDECTHREADS)Program does not use DECthreads ùservices. Facility: DEBUG, VMS DebuggerB Explanation: The entered command applies only to programs using DECthreads services.( User Action: No user action required. 3 NOTDEFINEdefined_symbol was not defined Facility: DEBUG, VMS Debugger> Explanation: The symbol was not found in the defined symbol table.B User Action: Check your spelling or use SHOW DEFINE to see what symbols have been defined. 3 NOTEDITABLEAthis text can not be edited úthus Motif CUT,PASTE,CLEAR operationscan not be performed. Facility: DEBUG, VMS Debugger 3 NOTEXTSELECTEDBthat operation can not be performed without selecting text. Select'some text and try that operation again. Facility: DEBUG, VMS Debugger 3 NOTIMPLAN3expression_type is not implemented at command level Facility: DEBUG, VMS DebuggerB Explanation: The expression_type is not supported at this type.> User Action: Specify a type of expression that thûe debugger supports. 3 NOTINLOOP'exitloop encountered when not in a loop Facility: DEBUG, VMS DebuggerB Explanation: An incorrect nesting of loops exist in the command# stream currently being executed.* User Action: Correct the command stream 3 NOTINSCOPE9specified scope cannot be found in the default scope list Facility: DEBUG, VMS DebuggerB Explanation: The specified scope was not in the current default scope list.= User Action: Enter üthe command with a scope that is in the default scope list. 3 NOTINST3examined address is not the start of an instruction Facility: DEBUG, VMS DebuggerD Explanation: The examined address does not denote the start of an instruction.C User Action: Specify an address that does denote the start of an instruction. 3 NOTKEPT9this operation can only be performed in the Kept Debugger&configuration. Function function_name. Facility: DEBUG, VMS DebuggerýD Explanation: This command only makes sense when executed from the+ Kept Debugger configuration of DECdebug.8 User Action: Restart DECdebug using the Kept Debugger* configuration and re-enter the command. 3 NOTNUMSCOPE(specified scope is not a numbered scope. Facility: DEBUG, VMS DebuggerA Explanation: The SET SCOPE/CURRENT command requires a numbered scope.8 User Action: Enter the command with a numbered scope. 3 NOTORIGSRC<original version o þf source file not found file used is file_ specification Facility: DEBUG, VMS Debugger@ Explanation: A source file was found for some module. But theB revision date and time or the file size indicates that this mayD not be the same version of the file that was used in the original< compilation of the module. This warning message indicatesA that future source line displays from this source file may not> correspond to the actual source used to compile the module.> User ÿAction: None, unless the original source is available.? Then you can use the debugger command SET SOURCE to indicate. the location of the source to the debugger. 3 NOTPTR(variable must be of pointer or file type Facility: DEBUG, VMS Debugger@ Explanation: The variable should be a pointer or a file type.; User Action: Specify a variable of pointer or file type. 3 NOTRACES)no tracepoints are set, no opcode tracing Facility: DEBUG, VMS Debugger? Explanation: There are no tracepoints or opcode tracing set.4 User Action: None. This message is informational. 3 NOTRAZEROCUnable to find a trailing zero for ASCIZ object at address address_value Facility: DEBUG, VMS DebuggerC Explanation: The debugger was unable to find a trailing zero for the specified ASCIZ string.C User Action: The ASCIZ string is missing a trailing zero, or the* object examined is not an ASCIZ string. 3 NOTRECORD>variable is not record; cannot select component component_name Facility: DEBUG, VMS Debugger> Explanation: The user has requested a record operation on a" variable which is not a record.2 User Action: Correct the command and reissue it 3 NOTREE1SCAN tree or subtree not found SCAN error message Facility: DEBUG, VMS Debugger 3 NOTRUNCONFIG>You must be running the kept debugger to use the RUN and RERUNcommands Facility: DEBUG, VMS DebuggerC Explanation: The RUN and RERUN commands are not available if you) start up the debugger using RUN/DEBUG.A User Action: To use this command, exit the debugger and invoke# the kept debugger configuration. 3 NOTRUNDW<the debugger is uncertain about the DECWindow configuration. Facility: DEBUG, VMS Debugger; Explanation: The debugger is uncertain about the systems DECWindow configurationA User Action: Try the debugger again, if the same results exist. submit a Software Performance Report (SPR). 3 NOTTASKVAL.expression does not specify a valid task value Facility: DEBUG, VMS DebuggerD Explanation: The expression entered does not specify a valid taskD value. Only Ada task values are known as such in the symbol table1 - Thread values are considered to be pointers.= User Action: Unless you are debugging threads, reenter the. command, correctly specifying a task value. 3 NOTUISOSC@the debugger will be unable to create a separate window; OSC notenabled. Facility: DEBUG, VMS DebuggerC Explanation: The debugger requires OSC support enabled to create- a separate window (see SET MODE SEPARATE).B User Action: To allow the debugger to create a separate window,A type at DCL: DEFINE/SYSTEM UIS$VT_ENABLE_OSC_STRINGS TRUE. You: may wish to put this line in your private startup file. 3 NOTUISV30@the debugger will be unable to create a separate window; UIS tooold. Facility: DEBUG, VMS DebuggerC Explanation: The debugger requires VWS V3.0 or later to create a+ separate window (see SET MODE SEPERATE).B User Action: To allow the debugger to create a separate window,B install VWS V3.0 or later, and in your private startup file (or9 at DCL), DEFINE/SYSTEM UIS$VT_ENABLE_OSC_STRINGS TRUE. 3 NOTUNQOVR>symbol 'symbol_name' is overloaded use SHOW SYMBOL to find theunique symbol names Facility: DEBUG, VMS Debugger> Explanation: More than one instance of the specified symbolC '' exists in the user program. Without furtherB information, the debugger cannot determine which symbol to use.D User Action: Re-enter the command, uniquely specifying the symbol> to be used. The SHOW SYMBOL command can be used to find the unique symbol names. 3 NOTUPDATE&instruction screen display not updated Facility: DEBUG, VMS Debugger> Explanation: The instruction screen display was not updated* because of the preceding error message.0 User Action: See the preceding error message. 3 NOTYPEINFO@symbol type information not available please SET the module thatdescribes this type Facility: DEBUG, VMS DebuggerA Explanation: The user has requested information about a symbol3 which cannot be provided in the current context.= User Action: SET the module containing the information and reissue the command 3 NOTYPELEN@'symbol_name' has no type or length information, cannot proceed. Facility: DEBUG, VMS DebuggerD Explanation: The requested information cannot be obtained becauseC the entity in question doesn't have all the attributes necessary& to follow through with the request.4 User Action: None. This message is informational. 3 NOUICdebugger user interface image not found; defaulting to not run as aDECwindows debugger Facility: DEBUG, VMS Debugger? Explanation: The user interface portion of the debugger is a* separat e image which cannot be located.A User Action: Check that the debugger is properly installed. If3 so, please submit a Software Performance Report. 3 NOUNIQUE"symbol 'symbol_name' is not unique Facility: DEBUG, VMS DebuggerB Explanation: The symbol specified was not in a default scope or& was defined in more than one scope.@ User Action: Specify the scope of the symbol in a pathname or change the default scope. 3 NOUNIVERSALS-shareable image contains  no universal symbols Facility: DEBUG, VMS Debugger= Explanation: No universal symbols were found in the image. User Action: None. 3 NOUSREVNT7no user-specified events are allowed; none are declared Facility: DEBUG, VMS DebuggerD Explanation: A reference was made to an event, when no such event( had been defined (language not SCAN).@ User Action: Reenter the last command, without specifying any events. 3 NOVALATPCAentity 'symbol_name' does  not have a value at the current PC (wasoptimized away) Facility: DEBUG, VMS DebuggerB Explanation: The value of the specified variable does not exist= at this point in the program's execution. For example, theC variable might be assigned to a register that is currently being used for some other purpose.? User Action: Retry the operation at a point in the program's3 execution when the variable is being referenced. 3 NOVALTYP='symbol_name' does not have a  value because it is a type name Facility: DEBUG, VMS Debugger 3 NOVALUEreference does not have a value Facility: DEBUG, VMS DebuggerD Explanation: The command specified a reference that has no value.% User Action: Change the reference. 3 NOVECT/no vector support - command cannot be performed Facility: DEBUG, VMS Debugger? Explanation: An attempt was made to modify vector state on a@ system which has neither hardware vector capabilities nor t heD VVIEF. This includes the EXAMINE vector-register, DEPOSIT vector-* register, and SET VECTOR_MODE commands.A User Action: Do not attempt to modify vector state on a system+ which does not have vector capabilities. 3 NOVIEWQUAL*no qualifier specified on the VIEW command Facility: DEBUG, VMS Debugger> Explanation: There were no qualifiers specified on the VIEW command.C User Action: Reenter the command, specifying a qualifier for the VIEW command. 3 NOWATCHESno watchpoints are set Facility: DEBUG, VMS Debugger' Explanation: No watchpoints are set.4 User Action: None. This message is informational. 3 NOWATONOPTDYou cannot watch that entity, because it was not allocated in memory(was optimized away) Facility: DEBUG, VMS Debugger@ Explanation: A watchpoint cannot be set on that entity due to* optimizations performed by the compiler> User Action: Recompile the program with no optimizations in effect 3 NOWATTARcannot watch-protect target Facility: DEBUG, VMS DebuggerA Explanation: You are attempting to set a /STATIC watchpoint onC a location that is either a register, is not in your program, orA is on the stack (P1 space). These kinds of locations cannot be+ watchpointed with the /STATIC qualifier.D User Action: Either use the /NOSTATIC qualifier, or do not watch- point this location. 3 NOWATVARIA)cannot set watchpoints on variant records Facility: DEBUG, VMS DebuggerD Explanation: The user has requested that a watchpoint be set on a< variant record. This operation is not currently supported' User Action: No user action required 3 NOWATVARSTG=watchpoints not allowed after SET TYPE ASCIC, ASCIW, or ASCIZ Facility: DEBUG, VMS Debugger 3 NOWBPTcannot insert breakpoint Facility: DEBUG, VMS DebuggerB Explanation: This message indicates an internal debugger error.5 User Action: Submit a Software Performance Report. 3 NOWILDno wildcard permitted Facility: DEBUG, VMS Debugger; Explanation: Wildcards are not permitted in this context< User Action: Re-enter the command without using wildcards 3 NOWILDFIL1file name, type, and version cannot be wildcarded Facility: DEBUG, VMS DebuggerC Explanation: The components of a file specification entered in a, SET SOURCE command may not be wildcarded.@ User Action: Reenter the command without wildcarding any file specification components. 3 NOWOPCO%cannot replace breakpoint with opcode Facility: DEBUG, VMS DebuggerB Explanation: This message indicates an internal debugger error.5 User Action: Submit a Software Performance Report. 3 NOWPROTcannot set protection Facility: DEBUG, VMS DebuggerB Explanation: This message indicates an internal debugger error.5 User Action: Submit a Software Performance Report. 3 NOWRITEACCESS=Unable to set breakpoint at break-addr, no write access. YourAprogram cannot be debugged unless you can change the write access of your code. Facility: DEBUG, VMS DebuggerC Explanation: Most debugger startups set a breakpoint in the user@ program and then return control to that program. The debuggerC regains control when that breakpoint is hit. It is necessary forD the debugger to have write access to the user program in order to set breakpoints.A User Action: Change/allow write access to your program's code. 3 NO_SYNC_FROM_EXC_BRE4Synchronize can not be done from an exception break. Facility: DEBUG, VMS Debugger= Explanation: A synchronize command can not be done from an exception break.C User Action: Do not perform a synchronization command when at an exception break. 3 NPROMPT@the debugger could not properly setup the state to accept input. Facility: DEBUG, VMS DebuggerB Explanation: The debugger it could not properly setup the stateC to accept input. This prevents the debugger from continuing this session.A User Action: Try the debugger again, if the same results exist. submit a Software Performance Report (SPR). 3 NULLPTRcannot dereference null pointer Facility: DEBUG, VMS Debugger 3 NULWIDGETBthe debugger encountered an error when retrieving information on a5particular graphical object in routine function_name. Facility: DEBUG, VMS Debugger> Explanation: The debugger detected an error when retrieving@ information on a particular widget in the MOTIF toolkit. This6 prevents the debugger from continuing this session.A User Action: Try the debugger again, if the same results exist. submit a Software Performance Report (SPR). 3 NUMCONLONG)numeric constant too long, please shorten Facility: DEBUG, VMS DebuggerA Explanation: A number entered in the command line is too long.@ User Action: Reenter the command, shortening the long number. 3 NUMTRUNCnumber truncated Facility: DEBUG, VMS Debugger> Explanation: The number entered is greater than the largest? signed longword integer. The value has been truncated to the the largest signed integer. User Action: None. 3 NYICthe function is not yet implemented. Coming soon to a debugger nearyou. Facility: DEBUG, VMS Debugger 3 OBJECTINVrequested object is invalid Facility: DEBUG, VMS DebuggerB Explanation: This message indicates an internal debugger error. User Action: Submit an SPR. 3 OBJPTRINV;the pointer associated with the requested object is invalid Facility: DEBUG, VMS DebuggerB Explanation: This message indicates an internal debugger error. User Action: Submit an SPR. 3 OBJTYPMIS:the type associated with the requested object is incorrect Facility: DEBUG, VMS DebuggerB Explanation: This message indicates an internal debugger error. User Action: Submit an SPR. 3 OBSOLETE_13#this message is available for reuse Facility: DEBUG, VMS DebuggerC Explanation: This message is obsolete, and should never be seen.< User Action: Please submit a Software Performance Report. 3 OBSOLETE_14#this message is available for reuse Facility: DEBUG, VMS DebuggerC Explanation: This message is obsolete, and should never be seen.< User Action: Please submit a Software Performance Report. 3 OBSOLETE_15#this message is available for reuse Facility: DEBUG, VMS DebuggerC Explanation: This message is obsolete, and should never be seen.< User Action: Please submit a Software Performance Report. 3 OBSOLETE_16#this message is available for reuse Facility: DEBUG, VMS DebuggerC Explanation: This message is obsolete, and should never be seen.< User Action: Please submit a Software Performance Report. 3 OBSOLETE_17#this message is available for reuse Facility: DEBUG, VMS DebuggerC Explanation: This message is obsolete, and should never be seen.< User Action: Please submit a Software Performance Report. 3 OBSOLETE_18#this message is available for reuse Facility: DEBUG, VMS DebuggerC Explanation: This message is obsolete, and should never be seen.< User Action: Please submit a Software Performance Report. 3 OBSOLETE_19#this message is available for reuse Facility: DEBUG, VMS DebuggerC Explanation: This message is obsolete, and should never be seen.< User Action: Please submit a Software Performance Report. 3 OBSOLETE_20#this message is available for reuse Facility: DEBUG, VMS DebuggerC Explanation: This message is obsolete, and should never be seen.< User Action: Please submit a Software Performance Report. 3 OBSOLETE_21#this message is available for reuse Facility: DEBUG, VMS DebuggerC Explanation: This message is obsolete, and should never be seen.< User Action: Please submit a Software Performance Report. 3 OBSOLETE_22#this message is available for reuse Facility: DEBUG, VMS DebuggerC Explanation: This message is obsolete, and should never be seen.< User Action: Please submit a Software Performance Report. 3 OBSOLETE_23#this message is available for reuse Facility: DEBUG, VMS DebuggerC Explanation: This message is obsolete, and should never be seen.< User Action: Please submit a Software Performance Report. 3 OBSOLETE_24#this message is available for reuse Facility: DEBUG, VMS DebuggerC Explanation: This message is obsolete, and should never be seen.< User Action: Please submit a Software Performance Report. 3 OBSOLETE_25#this message is available for reuse Facility: DEBUG, VMS DebuggerC Explanation: This message is obsolete, and should never be seen.< User Action: Please submit a Software Performance Report. 3 OBSOLETE_26#this message is available for reuse Facility: DEBUG, VMS DebuggerC Explanation: This message is obsolete, and should never be seen.< User Action: Please submit a Software Performance Report. 3 OPCDEC6no support for G/H instructions at or near opcode_name Facility: DEBUG, VMS Debugger 3 OPNOTALLOW:operator 'operator_symbol' not allowed on given data types Facility: DEBUG, VMS Debugg erB Explanation: The debugger encountered a problem when performingD the operation '' on the specified operands., This may be a data type conversion error.D User Action: Reenter the command, specifying compatible operands. 3 OPSYNTAXBinstruction operand syntax error for operand number operand_number Facility: DEBUG, VMS Debugger? Explanation: The debugger encountered an error in one of the! operands of a VAX instruction.C User Action!: If the instruction was entered by the user, reenterD the instruction, correcting the operand error. If not, then there4 may be an error in the user program instructions. 3 OUTPUTLOST:output being lost, both NOTERMINAL and NOLOG are in effect Facility: DEBUG, VMS DebuggerD Explanation: The SET OUTPUT command has set the output conditions; to NOTERMINAL and NOLOG; consequently, the output is notA displayed on the terminal or written to a log file. The output< nor"mally displayed by the debugger will not be available.@ User Action: Use the SET OUTPUT command to send output to the terminal or to a log file. 3 OVRWIDGETFAILCthe debugger detected an error when trying to fetch and override anAobject from the Motif Resource Manager (MRM) in routine function_name. Facility: DEBUG, VMS Debugger? Explanation: The debugger detected an error when fetching anB object from the Motif Resource Manager (MRM) for the purpose ofB overr#iding behavior. This prevents the debugger from continuing this session.A User Action: Try the debugger again, if the same results exist. submit a Software Performance Report (SPR). 3 PACSIZREQpacked size required Facility: DEBUG, VMS Debugger, Explanation: A size parameter is required? User Action: Supply a size parameter and reissue the command 3 PARENREQDparentheses required around type specification in 'debugger_command_segment /TYPE=(X)' F$acility: DEBUG, VMS Debugger@ Explanation: The debugger_command_segment is either SET TYPE, DEPOSIT, or EXAMINE.? User Action: Place parentheses around the type of expression specified 3 PARSTKOVR)parse stack overflow, simplify expression Facility: DEBUG, VMS DebuggerB Explanation: The expression was too complex for the debugger to evaluate.( User Action: Simplify the expression. 3 PARTIALINFOAThere was an error in DEBUG's RPC. The information % DEBUG has justDgiven you about the state of your program may be incomplete. Use the:one process configuration of the debugger as a workaround. Facility: DEBUG, VMS DebuggerC Explanation: There is a limit to the amount of information DEBUGC can pass through its RPC. That limit was reached, so DEBUG could@ only give you the information that would fit through its RPC.D User Action: Use the one process configuration of the debugger asC a workaround (i.e. $ DEFINE DBG$PROCESS& NONE). Submit a Software Performance Report (SPR) 3 PASTHRU-The primary handler should ignore this signalA Success: This is an internal status signal, it should never be? seen by the user. If this message does occur please submit a% Software Performance Report (SPR).; User Action: Submit a Software Performance Report (SPR). 3 PATHNOTACPDpathname qualifiers (path_name) not allowed in SHOW SYMBOL data name Facility: DEBUG, VMS DebuggerA Explanati'on: The user has issued a command with invalid syntax' User Action: No user action required 3 PATHTLONGtoo many qualifiers on name Facility: DEBUG, VMS DebuggerC Explanation: There are too many pathname elements in the entered' pathname for the debugger to handle.D User Action: Shorten the pathname entered, either by abbreviatingA the pathname, defining a symbol for the pathname, or setting a7 search scope so that you can use a shorter pathname. 3 ( PATHTOOLONGpathname too long at path_name Facility: DEBUG, VMS DebuggerD Explanation: The entered pathname is too long for the debugger to handle.D User Action: Shorten the pathname entered, either by abbreviatingA the pathname, defining a symbol for the pathname, or setting a7 search scope so that you can use a shorter pathname. 3 PCLINLOOKUPBthe debugger detected a error when trying to associate the PC to a line number. Facility: DEBUG, VMS DebuggerB) Explanation: The debugger detected an error when looking up the! PC to line number correlation.A User Action: Try the debugger again, if the same results exist. submit a Software Performance Report (SPR). 3 PCNOTALL;PC not allowed in context for operand number operand_number Facility: DEBUG, VMS Debugger9 Explanation: Using the PC as an operand in the entered instruction is not allowed.C User Action: If the instruction was entered by the user, reenter@* the instruction, without using the PC in the operand. If not,? then there may be an error in the user program instructions. 3 PLICVTERR+PLI conversion error at or near opcode_name Facility: DEBUG, VMS DebuggerC Explanation: An error occurred in the PL/I RTL performing a data6 type conversion, for the object .C User Action: Reenter the command, specifying a legitimate object for the operation desired. 3 PREDEPTNOT%predefined eventpo+int(s) not canceled Facility: DEBUG, VMS DebuggerA Explanation: Any existing predefined eventpoints have not been. canceled as the result of a CANCEL command.A User Action: Specify the /PREDEFINED qualifier with the CANCEL, command to cancel predefined eventpoints. 3 PRMNOTAVAIL5the command parameter parameter_name is not available Facility: DEBUG, VMS DebuggerC Explanation: The specified command parameter, although available? in some debug implementat,ions, is not available in this one.? One reason why is that the parameter just doesn't make sense@ on the platform. For example, the JSB parameter on a SET STEPD command doesn't make sense on Alpha VMS because there is no "JSB"( instruction like there is on VAX VMS.: User Action: Reissue the command without the parameter. 3 PROFRANOT2proper frame not found on call stack for path_name Facility: DEBUG, VMS Debugger@ Explanation: You attempted to look at a variable -in a routine" invocation that does not exist.? User Action: Specify a routine or routine invocation that is currently active. 3 PROMPTCLENDdisplay_name display width not changed, must be full width of screen Facility: DEBUG, VMS DebuggerC Explanation: This display's width can not be changed. It must be the full width of the screen. User Action: None. 3 PROMPTOCCL=display_name display now occludes some or all of display_namedisplay's text . Facility: DEBUG, VMS Debugger< Explanation: This display now occludes some or all of the specified display. User Action: None. 3 PROMPTRLENAdisplay_name display length not changed, must be at least 2 lineslong Facility: DEBUG, VMS Debugger@ Explanation: This display's length can not be changed to less$ than the minimum value specified. User Action: None. 3 PROVRFLOW&too many levels of @ procedure nesting Facility: DEBUG, VMS Debugger/C Explanation: The user has nested indirect command processing too deeplyB User Action: Try to eliminate some of the levels of indirection% or look for a recursive invocation 3 PSHINARYNYICPUSH_INNER_ARRAY DST stack machine operator for array 'symbol_name'is not yet implemented Facility: DEBUG, VMS DebuggerC Explanation: The named array is unconstrained, and its subscript= bounds live in different places at different points in theA program's execution. 0This cannot be denoted using DEBUG SymbolD Table (DST) features which this version of the debugger supports.@ User Action: Verify that you are using the latest releases ofC the compiler and debugger. Examine the nearest object code which? references the variable and simulate the access algorithm by hand. 3 PSHVALNYIBPUSH_VALSPEC DST stack machine operator for variable 'symbol_name'is not yet implemented Facility: DEBUG, VMS Debugger@ Explanation: The named va 1riable's address is complex, and its> computation uses operands which live in different places at> different points in the program's execution. This cannot be= denoted using DEBUG Symbol Table (DST) features which this$ version of the debugger supports.D User Action: Verify that you are using the latest releases of theA compiler and debugger. Try recompiling the application withoutA optimization. Examine the nearest object code which references: the variable and simulate t2he access algorithm by hand. 3 PXCNArecord object or record formal parameter must prefix 'CONSTRAINED Facility: DEBUG, VMS Debugger 3 QUALNOTAVAIL5the command qualifier qualifier_name is not available Facility: DEBUG, VMS DebuggerC Explanation: The specified command qualifier, although available? in some debug implementations, is not available in this one.? One reason why is that the qualifier just doesn't make sense= on the platform. For example, the3 /JSB qualifier on a STEPD command doesn't make sense on Alpha VMS because there is no "JSB"( instruction like there is on VAX VMS.: User Action: Reissue the command without the qualifier. 3 QUALREQ@A direction qualifier must be specified with the EXPAND and MOVE commands. Facility: DEBUG, VMS DebuggerB Explanation: Direction ( UP, DOWN, LEFT, RIGHT ) information is missing from the command.C User Action: Provide a direction with the command and try again.4 3 QUOSTRLONG&quoted string too long, please shorten Facility: DEBUG, VMS DebuggerA Explanation: A quoted string was entered in a debugger command1 that was too large for the debugger to handle.C User Action: Reenter the command, shortening the string entered. 3 READERR(debugger input read error, force to exit Facility: DEBUG, VMS DebuggerA Explanation: Too many read errors have occurred from the input= command stream. The Debugger will exit after 5printing this message: User Action: Check the physical integrity of the device containing the input stream. 3 REFUSEDattach request refused Facility: DEBUG, VMS Debugger@ Explanation: Either you have attempted to attach to a process? that is your own process or that is not part of your process tree.A User Action: None. You cannot perform the attempted operation. 3 REGMASKHIDDEN6register save mask hidden for stack frame frame_number Facil 6ity: DEBUG, VMS Debugger; Explanation: Information on where the designated routine? invocation might save registers is in a module which has notC been set. Symbolic references to non-static variables of callersB of this routine may not be resolved correction by the debugger.= User Action: Set the module by using the SET MODULE or SETC MODULE/CALLS commands, or enable dynamic module setting with theA SET MODE DYNAMIC command. Then retry the action which produced this 7message. 3 REGMASKMISSING7register save mask missing for stack frame frame_number Facility: DEBUG, VMS Debugger; Explanation: Information on where the designated routine= invocation might save registers is not available. Symbolic@ references to non-static variables of callers of this routine2 may not be resolved correction by the debugger.D User Action: Recompile or reassemble the modules using the /DEBUG" qualifier and then relink them. 3 REGNAMEFAILB8the debugger detected an error when registering resources with theMotif Resource Manager (MRM). Facility: DEBUG, VMS Debugger? Explanation: The debugger detected an error when registeringA resources with the Motif Resource Manager (MRM). This prevents- the debugger from continuing this session.A User Action: Try the debugger again, if the same results exist. submit a Software Performance Report (SPR). 3 REGREQ>register required in context for operand number op9erand_number Facility: DEBUG, VMS DebuggerC Explanation: A register is required to establish context for the specified operand.C User Action: If the instruction was entered by the user, reenterC the instruction, using a register with the specified operand. IfD not, then there may be an error in the user program instructions. 3 REGWRERRBunable to write/update the current invocation context register set Facility: DEBUG, VMS Debugger? Explanation: Debug :kernel failed to write/update the currentA context register set. Any pending deposits or steps will fail.6 This could consequently result in stack corruption.B User Action: Please submit a Software Performance Report (SPR). 3 RENAMENOTBUnable to look up 'symbol_name', object being renamed not found in symbol table Facility: DEBUG, VMS Debugger@ Explanation: The user has requested an operation on an object* that was not found in the symbol table./ User Action: ;Correct and reissue the command 3 RESUMERRAan error occurred while trying to resume execution of the program Facility: DEBUG, VMS DebuggerA Explanation: An error status was returned from the call to theD debugger-kernel service that resumes program execution. Depending@ on the severity of the error, the program may or may not have resumed execution.< User Action: Examine the error message after this message< and consider if the problem is related to a lack of< quota? or otherwise related to your program's behavior. If so, thenA take corrective action. If, after this evaluation, you believe@ that the problem lies in the debugger, then submit a Software Performance Report. 3 RETURNED(control returned to process process_name Facility: DEBUG, VMS Debugger; Explanation: Control has returned to the parent process. User Action: None. 3 RNDFCTROUTround factor out of range Facility: DEBUG, VMS Debugger=? Explanation: The DIBOL scale factor is out of the acceptable range 3 ROPRANDF-reserved operand fault at or near opcode_name Facility: DEBUG, VMS DebuggerC Explanation: The debugger encountered an opcode that is reserved to VSI.C User Action: If the instruction was entered by the user, reenter? the instruction, without using an opcode reserved to VSI. IfD not, then there may be an error in the user program instructions. 3 ROUTNOTAVAIL*the sour>ce to routine !AC is not available Facility: DEBUG, VMS Debugger> Explanation: There is no source available for this routine. 3 RPCDBBDT Bad DTYPE for RPC Data Blocking. Facility: DEBUG, VMS DebuggerB Explanation: This message indicates an internal debugger error.5 User Action: Submit a Software Performance Report. 3 RPCERR;an internal inter-process communications error has occurred Facility: DEBUG, VMS DebuggerB Explanation: An internal comm?unications error has occurred. The9 reason is given in the message following this message.? User Action: If the error is reproducible, submit a Software> Performance Report and, if possible, enclose both a copy ofA the program being debugged and a logged debugging session that reproduces the error. 3 RPCINVDSCinvalid RPC descriptor Facility: DEBUG, VMS DebuggerB Explanation: This message indicates an internal debugger error.5 User Action: Submit a Softwar@e Performance Report. 3 RPCOVFRPC packet overflow Facility: DEBUG, VMS DebuggerB Explanation: This message indicates an internal debugger error.5 User Action: Submit a Software Performance Report. 3 RPCUNF"undefined RPC function encountered Facility: DEBUG, VMS DebuggerB Explanation: This message indicates an internal debugger error.5 User Action: Submit a Software Performance Report. 3 RPCUNKARG"undefined RPC argument encountered A Facility: DEBUG, VMS DebuggerB Explanation: This message indicates an internal debugger error.5 User Action: Submit a Software Performance Report. 3 RSTERRerror in symbol table Facility: DEBUG, VMS Debugger< Explanation: There is a format error in the symbol table.C User Action: If the format error is not caused by a user programD error or a DEPOSIT command, submit a Software Performance Report. 3 SCALEADDDpointer addition: scale factor of scale_faBctor applied to right/leftargument Facility: DEBUG, VMS DebuggerC Explanation: Indicates the scale factor applied in computing the address. User Action: None. 3 SCALESUBBpointer subtraction: a scale factor of scale_factor applied to the right/left Facility: DEBUG, VMS DebuggerC Explanation: Indicates the scale factor applied in computing the address. User Action: None. 3 SCRNOACCESSRCno read access to address address_value for dispClay in display_name Facility: DEBUG, VMS Debugger 3 SCRNOSRCLINDno source line for address address_value for display in display_name Facility: DEBUG, VMS DebuggerB Explanation: No source line corresponds to the address address_: value specified on the debugger command EXAMINE/SOURCE.4 User Action: None. This message is informational. 3 SCRNOTORIGSRCAoriginal version of source file not found for display in display_$name file used is file_specification D Facility: DEBUG, VMS Debugger@ Explanation: A source file was found for some module. But theB revision date and time or the file size indicates that this mayD not be the same version of the file that was used in the original< compilation of the module. This warning message indicatesA that future source line displays from this source file may not> correspond to the actual source used to compile the module.> User Action: None, unless the original source is available.? Then Eyou can use the debugger command SET SOURCE to indicate. the location of the source to the debugger. 3 SCRTOBIG?screen too big for Screen Mode width must be less than maximum_&width, height less than maximum_height Facility: DEBUG, VMS Debugger? Explanation: The current screen dimensions are too large for debugger screen mode.C User Action: Change the screen dimensions to be small enough for debugger screen mode. 3 SCRTOSMALL@screen too small for ScrFeen Mode width must be at least minimum_-width, height must be at least minimum_height Facility: DEBUG, VMS Debugger? Explanation: The current screen dimensions are too small for debugger screen mode.C User Action: Change the screen dimensions to be large enough for debugger screen mode. 3 SCRUNAOPNSRC<unable to open source file file_specification for display in display_name Facility: DEBUG, VMS DebuggerD Explanation: Source lines from the file file_sp Gecification cannotB be displayed because the debugger was unable to open the sourceA file (represented as file_specification). The accompanying VAXB RMS status message gives more information about the reasons for$ the source file not being opened.? User Action: Examine the VAX RMS status message to determineA the reasons for the source file not being opened, and take the0 appropriate action based on that information. 3 SCRUNAREASRC<unable to read source file file_sp Hecification for display in display_name Facility: DEBUG, VMS DebuggerD Explanation: Source lines from the file file_specification cannotB be displayed because the debugger was unable to read the sourceA file (represented as file_specification). The accompanying VAXB RMS status message gives more information about the reasons for$ the source file not being opened.? User Action: Examine the VAX RMS status message to determine? the reasons for the source file not being rIead, and take the0 appropriate action based on that information. 3 SELECTFAILDthe debugger detected an error when processing the user's selection. Facility: DEBUG, VMS Debugger> Explanation: The debugger detected an error when processing? the user's selection. The selection did not match any of theC specified selections in the list box. This prevents the debugger from continuing this session.A User Action: Try the debugger again, if the same results exist. J submit a Software Performance Report (SPR). 3 SENDRETRY0network failure occured during a send, retrying. Facility: DEBUG, VMS Debugger@ Explanation: A network failure occured during a send. This isB most likely due to excessive network traffic. The debugger willD retry the send until it sees a network time-out. Then it will try" to re-establish the connection.5 User Action: Wait for progress or network failure. 3 SETKEY'keypad state has been set to state_nKame Facility: DEBUG, VMS Debugger8 Explanation: The specified keypad state has been set. User Action: None. 3 SETKEYERR$error in processing SET KEY command: Facility: DEBUG, VMS Debugger> Explanation: An error has occurred during a SET KEY command 3 SFCNTNEGshift count is negative Facility: DEBUG, VMS Debugger 3 SHOKEYERR%error in processing SHOW KEY command: Facility: DEBUG, VMS Debugger@ Explanation: An error has occurred Lduring the processing of a SHOW KEY command 3 SHRPRC debugger will share user process Facility: DEBUG, VMS DebuggerD Explanation: An error occured while trying to create a subprocessB to run the main debugger image. This message indicates that theC debugger is reverting back to the old behavior of running in the user process.= User Action: Correct the problem specified in the messagesD preceding this message. If the problem cannot be solved, submit a% SMoftware Performance Report (SPR). 3 SIDEFFECT1operators with side effects not supported (++, -) Facility: DEBUG, VMS DebuggerB Explanation: The user has requested the use of an operator thatA has side effects. This operation is not currently supported by the Debugger.; User Action: Issue the operation and the side effects as individual commands 3 SIGVECNOREADBsignal vector for exception frame frame-addr at sigvec-addr is notreadable Facility: D NEBUG, VMS DebuggerA Explanation: The debugger is attempting to chain down the call? stack, following frame pointers. The debugger has determined@ that part or all of the signal vector for the exception frame@ at frame-addr is not accessible for reading. This vector liesC at sigvec-addr. This usually indicates a corrupt frame list, butD could also indicate that the program has protected part of memory= in which the frame lies. In either case, this is an error.D User ActiOon: Determine what part of your code is writing into theA FP register or overwriting the saved frame pointer on the callC stack (or a preceding saved frame pointer) and correct it. SinceC the debugger looks at the call stack to symbolize addresses, youA may suppress some of these messages by typing the command "SET MODE NOSYMBOLIC". 3 SIGVECTRUNCsignal vector was truncated Facility: DEBUG, VMS DebuggerD Explanation: The signal vector on this stack frame was toPo big to fit into the DEBUG buffer.B User Action: Submit an SPR. This message is handled internally,, and should never be signaled to the user. 3 SIZEATOMIC/only atomic data types are supported with 'SIZE Facility: DEBUG, VMS Debugger; Explanation: SIZE is not supported on the item requested' User Action: No user action required 3 SIZETRUNCsize field truncated to 32 bits Facility: DEBUG, VMS Debugger= Explanation: The size of the entry inQ a VAX BLISS-32 field? specification was larger then 32. The debugger set the entry' size to 32 and executed the command.4 User Action: None. This message is informational. 3 SOURCESCOPE!Source lines not available for .0 Facility: DEBUG, VMS DebuggerD Explanation: There were no source lines available for the currentA PC, so the debugger displayed the source lines for the calling@ routine. The source lines may be unavailable because the code> associated withR the current PC is not available (e.g. is in< a VSI-supplied shareable image) or was compiled or linked /NODEBUG.B User Action: If source modules is available, then recompile and5 relink the application using the /DEBUG qualifier. 3 SPAWNEDsubprocess spawned Facility: DEBUG, VMS DebuggerA Explanation: This message is output by the DEBUG command SPAWN when it spawns a subprocess.4 User Action: None. This message is informational. 3 SRCLINNOT/sour Sce lines not available for module path_name Facility: DEBUG, VMS DebuggerC Explanation: The source lines from module CZ cannot be displayedA or searched because there is no source line information in theC symbol table for that module. Either the compiler is not able toD generate such information or the /DEBUG qualifier was not used on# the compilation or link command.@ User Action: If the language in question supports source lineB display, recompile and relink with Tthe /DEBUG qualifier. If theC language does not support source line display, source lines will? not be available to the debugger for modules written in that language. 3 SRCNOTCURAV?source code for line !UL in module !AC not currently available. Facility: DEBUG, VMS Debugger 3 SS_INTsystem service intercepted Facility: DEBUG, VMS DebuggerC Explanation: This error code is used by the debugger to indicate. that a system service has been intercepted.UB User Action: Submit an SPR. This message is handled internally,, and should never be signaled to the user. 3 SS_INT_END"system service intercept cycle end Facility: DEBUG, VMS DebuggerC Explanation: This error code is used by the debugger to indicate. that a system service has been intercepted.B User Action: Submit an SPR. This message is handled internally,, and should never be signaled to the user. 3 SS_INT_START$system service intercept cycle startV Facility: DEBUG, VMS DebuggerC Explanation: This error code is used by the debugger to indicate. that a system service has been intercepted.B User Action: Submit an SPR. This message is handled internally,, and should never be signaled to the user. 3 STEPFAILEDBemulation of a single instruction failed; execution continued pastlocation of failureC Facility: DEBUG, VMS Debugger The debugger emulates instructionsD as part of the stepping mechanism used in sevWeral commands (e.g.,C STEP, SET TRACE, SET WATCH/NOSTATIC). The debugger failed to setC up the emulation so that the debugger could regain control after+ the instruction(s) in question executed.: User Action: Submit a Software Performance Report (SPR) 3 STEPINTO#cannot step over PC = address_value Facility: DEBUG, VMS DebuggerD Explanation: The debugger was unable to step over the routine and, executed a step into the routine instead.4 User Action: None. XThis message is informational. 3 STGTRUNCstring truncated Facility: DEBUG, VMS DebuggerD Explanation: While processing the command, the debugger truncated a text string.> User Action: The debugger failed to allocate a large enoughA buffer to store the command output. Unless the reason for this; is apparent, submit a Software Performance Report (SPR). 3 STRNGPADAstring operand lengths don't match, shorter padded with blanks on the right FacilitYy: DEBUG, VMS DebuggerD Explanation: The operands of a string comparison ( 'ABC' < 'AB' )B did not have the same length. The shorter one is blank extended on the right./ User Action: Use strings of the same length. 3 STRTOOLONG0strings longer than 255 characters not supported Facility: DEBUG, VMS Debugger@ Explanation: The string that was specified by the user is too# large for the debugger to handle? User Action: Try to redo the operation with a shorterZ string 3 STRUCSIZEDstructure size declared as num_units allocation units, num_units wasgiven Facility: DEBUG, VMS DebuggerB Explanation: The VAX BLISS-32 structure size was declared to be; num_units units but was referenced with num_units units.4 User Action: None. This message is informational. 3 SUBOUTBND+subscript subscript_number is out of bounds Facility: DEBUG, VMS Debugger? Explanation: An attempt to subscript out of the bounds of an a[rray was made.2 User Action: Change the value of the subscript. 3 SUBSCRNG?subscript out of range, low/high bound for dimension subscript_number is subscript_bound Facility: DEBUG, VMS DebuggerD Explanation: The subscript specification is not within the bounds of the array.; User Action: Reenter the command, specifying a subscriptA specification that is within the bounds defined for the array. 3 SUBSTRINGAinvalid substring (start: low_bound, end: hi\gh_bound), object haslength string_size Facility: DEBUG, VMS DebuggerC Explanation: The substring specification (start: low_bound, end:C high_bound ) is not within the bounds defined for the data type.C User Action: Specify a substring specification within the bounds defined for the data type. 3 SUPERDEBUGSUPERDEBUG not available Facility: DEBUG, VMS DebuggerA Explanation: This is a Debug internal message. The user should never see this message.]= User Action: If you see this message, please submit an SPR describing the circumstances. 3 SYMNOTACT/non-static variable 'symbol_name' is not active Facility: DEBUG, VMS DebuggerB Explanation: The symbol symbol_name is not defined in an active call frame.C User Action: Check the symbol specified; if correct, ensure that( you have defined the scope correctly. 3 SYMNOTFND.no symbols matching defined_symbol are defined Facility: DEBUG, VMS Debu^ggerD Explanation: You attempted to use the SHOW SYMBOL command to show a symbol that is not defined.A User Action: Verify that the symbol is defined and reenter the command. 3 SYNCDONEvector synchronization complete Facility: DEBUG, VMS Debugger? Explanation: This signal is generated by the debugger kernel; after it has executed the synchronization instruction(s); necessary to insure that all vector exceptions have been reported.B User Acti_on: Submit an SPR. This message is handled internally,, and should never be signaled to the user. 3 SYNCREPCOMSynchronize reporting complete Facility: DEBUG, VMS DebuggerA Explanation: All current vector exceptions have been reported.4 User Action: None, this message is informational. 3 SYNC_ALREADY_IN_PROGRESS Synchronize already in progress. Facility: DEBUG, VMS DebuggerB Explanation: Only one synchronize command is allowed at a time.B User Ac`tion: Do not perform a synchronization command until the" previous command has completed. 3 SYNERREXPR@syntax error in expression at or near 'debugger_command_segment' Facility: DEBUG, VMS DebuggerD Explanation: The debugger encountered text it does not understand* near ''.A User Action: Reenter the command, correcting the syntax error. 3 SYNERRLABELBsyntax error in %LABEL construct, see HELP Built_in_Symbols %LABEL Facilitay: DEBUG, VMS DebuggerC Explanation: The debugger encountered an error in the use of the %LABEL built-in symbol.A User Action: Reenter the command line, correcting the error in the %LABEL construct. 3 SYNERRLINE@syntax error in %LINE construct, see HELP Built_in_Symbols %LINE Facility: DEBUG, VMS DebuggerC Explanation: The debugger encountered an error in the use of the %LINE built-in symbol.A User Action: Reenter the command line, correcting the errbor in the %LINE construct. 3 SYNTAX:command syntax error at or near 'debugger_command_segment' Facility: DEBUG, VMS DebuggerD Explanation: The debugger encountered a command syntax error near( the element debugger_command_segment.% User Action: Re-enter the command. 3 TARGREJ-target system rejected the connection request Facility: DEBUG, VMS DebuggerC Explanation: The target system rejected. This can be because theA target system is not in ac debuggable state, you have specified@ the password incorrectly, or a system with this name does not exist on the network.A User Action: Check spelling of the node name or password. AlsoC verify that the system is in a debuggable state (booted with the correct flags). 3 TASKERROR&error error_code from ADA multitasking Facility: DEBUG, VMS Debugger@ Explanation: An unexpected error was returned to the debugger? from the Ada RTL. Additional information from tdhe Ada RTL is" appended to this error message.D User Action: User action is dependent on the information returnedB from the Ada RTL. If the error is not recoverable, the user may, wish to enter an SPR on the Ada compiler. 3 TASKNONULL(Null task cannot be selected or modified Facility: DEBUG, VMS Debugger 3 TASKNOREGS+Task has no registers (it is the Null task) Facility: DEBUG, VMS Debugger 3 TASKNOTABORT@task not aborted; ADA multitasking is exeecuting critical section Facility: DEBUG, VMS DebuggerC Explanation: The task specified may not be aborted at this time.0 User Action: Retry the abort at a later time. 3 TASKNOTACTAtask cannot be made the active task; task is not ready or running Facility: DEBUG, VMS DebuggerD Explanation: The task specified to made the active task is not inD either the READY nor the RUNNING state. Tasks not in those states@ cannot be made the active task. To determine the fstate of the% task, perform a SHOW TASK command.A User Action: If the task is in the TERMINATED state, no actionA is possible. If the task is in the SUSPENDED state, the actionD required to get the task in the READY or RUNNING state depends on; the user program and the state of the debugging session. 3 TASKNULL0task is null; cannot set attributes of null task Facility: DEBUG, VMS Debugger 3 TERMINATINGprogram is terminating Facility: DEBUG, VMS DebugggerC Explanation: The process process-specification has just finishedA execution. All exit handlers in your program have run. Any SETB BREAK/TERMINATING or SET TRACE/TERMINATING events will now take effect.B User Action: Submit an SPR. This message is handled internally,, and should never be signaled to the user. 3 TIMESLICE3time slice interval has been slowed to 10.0 seconds Facility: DEBUG, VMS Debugger@ Explanation: DEBUG has changed the ADA time sliceh interval to> 10.0 seconds. When you set watchpoints, DEBUG automaticallyD increases the value of pragma TIME_SLICE to 10.0. This is because? of interaction between the watchpoint implementation and VAX@ Ada's time slicing. Slowing down the time-slice rate prevents problems from occurring.C User Action: If the change in time-slice setting is undesirable,% then avoid the use of watchpoints. 3 TOOFEWSUB7too few subscripts, array has num_dimensions dimensions Fiacility: DEBUG, VMS DebuggerB Explanation: The user has specified a symbol reference with too few subscripts/ User Action: Correct and reissue the command 3 TOOMANDIMtoo many dimensions in array Facility: DEBUG, VMS Debugger 3 TOOMANERR)too many errors, some errors not reported Facility: DEBUG, VMS DebuggerD Explanation: Too many MISMODBEG or certain other errors occurred.) Other similar errors are not reported.4 User Action: None. This mesjsage is informational. 3 TOOMANINV.too many invocation numbers in symbol pathname Facility: DEBUG, VMS Debugger 3 TOOMANPARMtoo many parameters on command Facility: DEBUG, VMS Debugger 3 TOOMANSUB8too many subscripts, array has num_dimensions dimensions Facility: DEBUG, VMS DebuggerB Explanation: The user has specified a symbol reference with too many subscripts/ User Action: Correct and reissue the command 3 UIISHIDDENThe UI is kcurrently hidden. Facility: DEBUG, VMS Debugger? Explanation: Debug did not hide the UI because it is already hidden.$ User Action: No action necessary. 3 UIISSHOWNThe UI is currently displayed. Facility: DEBUG, VMS DebuggerA Explanation: Debug did not show the UI because it is currently displayed.$ User Action: No action necessary. 3 UNAACCREG+unable to access beyond end of register set Facility: DEBUG, VMS Debugger> Explanatilon: The command entered attempted to read or write0 beyond the end of a register or register set.> User Action: Re-enter the command, insuring that you do not8 attempt to access beyond the end of the register set. 3 UNACREDBGO,unable to create DBG$OUTPUT, SYS$OUTPUT used Facility: DEBUG, VMS Debugger 3 UNACVT-unable to convert radixvalue to datatype_name Facility: DEBUG, VMS DebuggerD Explanation: Debug was unable to perform the requested conversion'm User Action: No user action required 3 UNACVTBYTTAU9error converting byte count into target addressable units Facility: DEBUG, VMS Debugger3 Explanation: This is an internal debugger error.? User Action: If the error is reproducible, submit a Software> Performance Report and, if possible, enclose both a copy ofA the program being debugged and a logged debugging session that reproduces the error. 3 UNALIGNED&data is not aligned on a byte boundary n Facility: DEBUG, VMS DebuggerC Explanation: The user has requested a type override that can not be performed' User Action: No user action required 3 UNALLOCATED?entity 'symbol_name' was not allocated in memory (was optimizedaway) Facility: DEBUG, VMS DebuggerD Explanation: The requested entity is not available for use due to* optimizations performed by the compiler> User Action: Recompile the program with no optimizations in effect 3 UNAoOPEDBGI(unable to open DBG$INPUT, SYS$INPUT used Facility: DEBUG, VMS Debugger 3 UNAOPESCR+unable to open DBG$OUTPUT for screen output Facility: DEBUG, VMS Debugger 3 UNAOPNHLP.unable to open help library file_specification Facility: DEBUG, VMS DebuggerD Explanation: The help library file_specification cannot be opened? to look for the help you requested. The accompanying VAX RMSB status message gives you more information about the reasons for thep library not being opened.? User Action: Examine the VAX RMS status message to determineB the reasons for the help library not being opened, and take theB appropriate action based on that information. Also, verify thatD the logical name DBG$HELP is either not defined, or is defined to indicate the proper file. 3 UNAOPNINI5unable to open initialization file file_specification Facility: DEBUG, VMS Debugger= Explanation: The initialization file cannot be opened. ThqeA accompanying VMS RMS status message gives you more information3 about the reasons for the file not being opened.C User Action: Examine the VMS RMS status message to determine theA reasons for the initialization file not being opened, and takeB action based on that information. Also, verify that the logical8 name DBG$INIT is defined to indicate the proper file. 3 UNAOPNSRC-unable to open source file file_specification Facility: DEBUG, VMS DebuggerD Expla rnation: Source lines from the file file_specification cannotB be displayed because the debugger was unable to open the sourceA file (represented as file_specification). The accompanying VAXB RMS status message gives more information about the reasons for$ the source file not being opened.? User Action: Examine the VAX RMS status message to determineA the reasons for the source file not being opened, and take the0 appropriate action based on that information. 3 UNAORIGsSRC:unable to open the original source file file specification Facility: DEBUG, VMS Debugger6 Explanation: Source lines from the original (before= preprocessing) source file cannot be displayed because the< debugger could not get the necessary information from the Correlation Facility.D User Action: Check your Correlation Facility logicals and library5 to see that they are referencing the proper files. 3 UNAREASRC-unable to read source file file_specification t Facility: DEBUG, VMS DebuggerD Explanation: Source lines from the file file_specification cannotB be displayed because the debugger was unable to read the sourceA file (represented as file_specification). The accompanying VAXB RMS status message gives more information about the reasons for$ the source file not being opened.? User Action: Examine the VAX RMS status message to determine? the reasons for the source file not being read, and take the0 appropriate actioun based on that information. 3 UNASAVVAL;unable to save value for defined_symbol, definition ignored Facility: DEBUG, VMS Debugger 3 UNASETIMG=unable to set image image_name because it has no symbol table Facility: DEBUG, VMS DebuggerC Explanation: The image is linked with the /NODEBUG qualifier, so there is no symbol table.; User Action: Relink the image with the /DEBUG qualifier. 3 UNASETTAS3unable to set visible task: registers not availablev Facility: DEBUG, VMS Debugger 3 UNASWISTA4Unable to create debugger stack, using program stack Facility: DEBUG, VMS DebuggerC Explanation: DEBUG failed to set the protection ($SETPRT) on the@ DEBUG stack's guard pages. This message indicates an internal debugger error. User Action: Submit an SPR. 3 UNBPAREN$unbalanced parentheses in expression Facility: DEBUG, VMS Debugger 3 UNDEXPN/undefined exponentiation at or near opcode_name w Facility: DEBUG, VMS Debugger 3 UNDKEY$state_name key key_name is undefined Facility: DEBUG, VMS DebuggerC Explanation: You attempted to use the SHOW/KEY or the DELETE/KEY@ command to show or delete the definition of a key that is not defined.> User Action: Verify that the key is defined and reenter the command. 3 UNHANDLED>The primary handler should now handle this unhandled exceptionA Success: This is an internal status signal, it should never bxe? seen by the user. If this message does occur please submit a% Software Performance Report (SPR).; User Action: Submit a Software Performance Report (SPR). 3 UNIMPLENT7attempt to evaluate unimplemented type, cannot proceed. Facility: DEBUG, VMS DebuggerD Explanation: The data type of the entity in question has not beenD implemented in the debugger. The debugger doesn't have the neededC information on the entity's type to follow through with request. y3 UNKNOWNCODEAthe debugger does not known how to process the function code !UL. Facility: DEBUG, VMS DebuggerB User Action: Make sure that none of the user definable function3 codes reference numbers that are not documented. 3 UNMTCHPARN unmatched left parenthesis found Facility: DEBUG, VMS DebuggerB Explanation: A left parenthesis (() was found, but the matching$ right parenthesis ()) is missing.2 User Action: Include the right parenthesis ()). 3 z UNREQVQUALAUnreqcognized vector instruction qualifier specified at 'command_line' Facility: DEBUG, VMS DebuggerA Explanation: The qualifier indicated in the shown command line fragment is unreqcognized.= User Action: Specify a legal vector instruction qualifier. 3 UPBNDOPT*upper bound of subrange was optimized away Facility: DEBUG, VMS Debugger= Explanation: The upper bound of the specified subrange was? optimized away by the compiler. In place of{ the actual upper, bound, DEBUG used the hex value 7FFFFFFF.4 User Action: None. This message is informational. 3 USREVNIGN5DEBUG detected a bad RTL EVCB sentinel-Event ignored. Facility: DEBUG, VMS DebuggerB Explanation: While process a pseudo-go operation, the EVCB sentD to the debugger by the RTL had a bogus sentinel field. Therefore," the debugger ignored the event. User Action: None. 3 USREVNTERR?user-specified event error code error_code retur|ned by user RTL Facility: DEBUG, VMS Debugger 3 VALNOTADDR5value of variable 'symbol_name' not usable as address Facility: DEBUG, VMS DebuggerD Explanation: The value of the specified variable is not usable as. an address. The address must be a longword.; User Action: Modify the address and retry the operation. 3 VALRNG:value is subscript_value, bounds are low_bound..high_bound Facility: DEBUG, VMS Debugger? Explanation: An attempt to subscrip}t out of the bounds of an array was made.2 User Action: Change the value of the subscript. 3 VARNESDEP@variant nesting depth exceeds 20, cannot access record component Facility: DEBUG, VMS Debugger 3 VECDIS(debugger-generated vector disabled fault Facility: DEBUG, VMS Debugger? Explanation: This signal is generated by the debugger kernel= while it is processing a vector disabled fault that it has caused.B User Action: Submit an SPR. This mess~age is handled internally,, and should never be signaled to the user. 3 VECREASON9the reason values for this vector error are reason_values Facility: DEBUG, VMS DebuggerA Explanation: An internal error has occurred with the debuggers@ use of vector instructions. The particular error code has two@ values which are associated with it, which more fully explain what went wrong. User Action: None. 3 VECSCP00vector registers can be accessed only in scope 0 Facility: DEBUG, VMS DebuggerB Explanation: An attempt was made to reference a vector registerC from a scope other than scope 0. DEBUG will not accept a command9 which specifies any other scope for a vector register.B User Action: If the current scope has been set to a scope otherA than scope 0 (using the SET SCOPE command), use an explicit 0\* pathname to access the vector register. 3 VECTSUBRNGDvector register subscript out of bounds, bounds are low_bound..h€igh_bound Facility: DEBUG, VMS Debugger? Explanation: An attempt to subscript out of the bounds of an array was made.2 User Action: Change the value of the subscript. 3 VERIFYICF4opening/closing command procedure file_specification Facility: DEBUG, VMS DebuggerC Explanation: The debugger is verifying a command procedure. ThisD message is displayed before the command procedure is executed and. after all the commands have been displayed.4 User Action: None. This message is informational. 3 VERSIONNUM@the debugger_type debugger has the following RPC version: major_version/minor_version Facility: DEBUG, VMS Debugger< Explanation: This message is to inform you of the versionB number(s) of the main and kernel debuggers. It will only appear4 as part of another message, such as INCOMVERSION.B User Action: Submit an SPR. This message is handled internally,, and should never be signaled to the user. 3 VFLTD‚IV4Reserved operand, encoded as floating divide by zero Facility: DEBUG, VMS DebuggerA Explanation: During a floating-point operation, an attempt was made to divide by zero.C User Action: Examine the code that caused the fault. Verify thatA the operands or variables are specified correctly. Verify thatD the encoded reserved operand was not deposited by a non-floating- point operation. 3 VFLTOVF.Reserved operand, encoded as floating overflow Facility: DƒEBUG, VMS DebuggerC Explanation: During a floating-point operation, a floating point? value exceeded the largest representable value for that data type.C User Action: Examine the code that caused the fault. Verify thatA the operands or variables are specified correctly. Verify thatD the encoded reserved operand was not deposited by a non-floating- point operation. 3 VFLTROP6Reserved operand, encoded as floating reserved operand Facility: DEBUG, VMS Debugg„er@ Explanation: During a floating-point operation, an attempt is made to divide by zero.C User Action: Examine the code that caused the fault. Verify thatA the operands or variables are specified correctly. Verify thatD the encoded reserved operand was not deposited by a non-floating- point operation. 3 VFLTUND/Reserved operand, encoded as floating underflow Facility: DEBUG, VMS Debugger? Explanation: An arithmetic exception condition occurred as a& … result of floating-point underflow.C User Action: Examine the code that caused the fault. Verify thatA the operands or variables are specified correctly. Verify thatD the encoded reserved operand was not deposited by a non-floating- point operation. 3 WATCHSETUP2instruction at current PC may trigger a watchpoint Facility: DEBUG, VMS Debugger? Explanation: This signal is generated by the debugger kernel@ when it is about to execute an instruction that may tri†gger a watchpoint.B User Action: Submit an SPR. This message is handled internally,, and should never be signaled to the user. 3 WATCHSIZE,cannot WATCH variables longer than 512 bytes Facility: DEBUG, VMS Debugger 3 WATNOWCANwatchpoint now cancelled Facility: DEBUG, VMS Debugger; Explanation: This message is a sub-message to WATVARSCP,= WATVARPTR, and WATVARPROT. This message indicates that the@ original watchpoint has been cancelled (is no longe‡r active).4 User Action: None. This message is informational. 3 WATNOWWATnow watching variable name Facility: DEBUG, VMS Debugger> Explanation: This message is a sub-message to WATVARSCP and? WATVARPTR. This message indicates the new name under which a> variable which either went out of scope or whose pointer(s)A changed is addressed by the debugger. If this message appears,6 the watchpoint is still active under this new name.4 User Action: None. This messaˆge is informational. 3 WATVARGSGONEAglobal section associated with watched variable variable name has been unmapped Facility: DEBUG, VMS Debugger< Explanation: The global-section which contained a global-@ section watchpoint is no longer mapped by any process that isA under debugger control. This message is always followed by theD WATNOWCAN message, since the debugger must delete the watchpoint.$ User Action: No action necessary. 3 WATVARGSOVR/watched va‰riable overlaps into a global section Facility: DEBUG, VMS Debugger? Explanation: The specified variable spans a range of virtualB memory which includes a global-section and a private-section. AB watched variable must either be entirely in a global-section or! entirely in a private-section.6 User Action: Do not use watchpoint on this address. 3 WATVARNOWGBL=watched variable variable name has been re-mapped to a globalsection Facility: DEBUG, VMS DebuggerŠB Explanation: The program mapped a global-section over a watched> variable. This message indicates that the debugger made the@ watchpoint a global-section watchpoint. If the global-section@ is mapped by more than one process that is under the debugger@ control, the watched variable will be watched in each process( that is mapped to the global section.$ User Action: No action necessary. 3 WATVARPROT6watched variable variable name is no longer accessible Facilit ‹y: DEBUG, VMS Debugger> Explanation: Some action by the program has made the target@ variable inaccessible to the debugger. The program might have= deleted the virtual memory which contains some part of the> variable or one of the pointers in the pointer chain to theA variable, or the program might have set the protection of such> virtual memory such that the debugger can not read it. ThisA message is always followed by the WATNOWCAN message, since the' debugger must deletŒe the watchpoint.4 User Action: None. This message is informational. 3 WATVARPTR@watched variable variable name now points to a different address Facility: DEBUG, VMS DebuggerB Explanation: Some pointer in the variable reference has changed: value. This message is accompanied by a further message? indicating whether the debugger has cancelled the watchpointA or re-defined the watchpoint to address the original data by a different name.4 User Action: None. This message is informational. 3 WATVARREMAP@watched variable variable name touches a page which has been re-mapped by the user program Facility: DEBUG, VMS Debugger; Explanation: Some action by the user program has made itC impossible for the debugger to set the protection on part or allB of the variable. The debugger will therefore not detect changesD to the variable. This message is always followed by the WATNOWCAN: message, since the debugger must delete the watŽchpoint.4 User Action: None. This message is informational. 3 WATVARSCP4watched variable variable name has gone out of scope Facility: DEBUG, VMS Debugger? Explanation: The identified variable is no longer accessible? by its original name. The program may have returned from theC routine in which the variable was defined, or it may have calledD another routine. This message is accompanied by a further message? indicating whether the debugger has cancelled the watchpointB (in the case that the variable is truly gone) or re-defined the; watchpoint to address the same data by a different name.4 User Action: None. This message is informational. 3 WIDTHDIFF>desired width of display_width is not allowed, width is set to display_width Facility: DEBUG, VMS DebuggerC Explanation: After creating the display pasteboard using the SMGD routine SMG$CREATE_PASTEBOARD, DEBUG found that the display width was not in the range 20-255.C User Action: Issue the DCL command SHOW TERMINAL and verify that9 the terminal width is correct and in the range 20-255. 3 WORKSTACMDBthe command debugger-command is only supported on VWS workstations Facility: DEBUG, VMS Debugger@ Explanation: The debugger only supports the command debugger-' command on workstations running VWS.D User Action: None. This capability of the debugger does not exist for your terminal or machine. 3 WPTTRACE0non-static‘ watchpoint, tracing every instruction Facility: DEBUG, VMS DebuggerB Explanation: Setting a watchpoint on a non-static location suchC as the stack or on a register forces the debugger to trace everyA instruction that is executed. This will slow down execution of) your program by a considerable amount.C User Action: If you do not want execution of your program slowed- down, then you must cancel the watchpoint. 3 WRITE_FAILED1an attempt to write into a memory ’location failed Facility: DEBUG, VMS DebuggerB Explanation: This message indicates an internal debugger error.5 User Action: Submit a Software Performance Report. 3 WRITE_INTO_KERNEL5cannot write into the debugger kernel's address space Facility: DEBUG, VMS DebuggerB Explanation: This message indicates an internal debugger error.5 User Action: Submit a Software Performance Report. 3 WRITE_INTO_KERNEL_STACK-cannot write into the debugger kernel's st“ack Facility: DEBUG, VMS DebuggerB Explanation: This message indicates an internal debugger error.5 User Action: Submit a Software Performance Report. 3 ZERLENDST8zero length DST record has been ignored (compiler error) Facility: DEBUG, VMS DebuggerA Explanation: A zero-length DST record was encountered within a< module. This message normally indicates a compiler error.5 User Action: Submit a Software Performance Report. 3 ZEROINCR2increment fo”r ranged examine is zero; exiting loop Facility: DEBUG, VMS Debugger; Explanation: While performing a ranged examine, DEBUG noB successor to the current data item was found because the length+ of the current data item was zero bytes.4 User Action: None. This message is informational. 2 Path_Names? If your program has multiple symbols with the same name, you? may need to use pathnames to resolve symbol ambiguities. For> example, your program may have a variab•le X in procedure A,A another variable X in procedure B which is nested in procedureD A, and still another variable X in procedure C. If you specify X,B as in this example, the debugger uses symbol search conventions4 (based on the PC scope) to resolve the ambiguity: DBG> EXAMINE XA If the debugger cannot do so, it issues the following message:& %DEBUG-W-NOUNIQUE, X is not unique.@ To resolve the ambiguity, you can specify which X you want by! using a pathname. F–or example: DBG> EXAMINE A\X DBG> EXAMINE A\B\X DBG> EXAMINE C\X3 For more information, see the SET SCOPE command. 2 SS$_DEBUGD SS$_DEBUG (defined in STARLET) is a condition you can signal from@ your program to start the debugger. Signalling SS$_DEBUG fromB your program is equivalent to entering Ctrl/Y followed by DEBUG at that point.B You can pass commands to the debugger at the time you signal itA with SS$_DEBUG. For example, to start the debugge—r and issue aA SHOW CALLS command at a given point in your program, you could@ put the following into your program (this example is coded in BLISS): SIGNAL(SS$_DEBUG, 1,) UPLIT BYTE(%ASCIC 'SHOW CALLS')); 2 System_Management; The debugger consists of two parts (main and kernel), to6 accommodate the debugging of multiprocess programs.A o For a program that runs in one process, a debugging session, requires two processes instead of one.A o ˜For a multiprocess program, a debugging session requires asC many processes as are used by the program, plus an additional$ process for the main debugger.? Under these conditions, several users who are simultaneouslyC debugging programs can place an additional load on a system. TheD subtopics describe the resources used by the debugger so that you* can tune your system for this activity.A The discussion covers only the resources used by the debugger.D In the case™ of multiprocess programs, you might also have to tune2 your system to support the programs themselves. 3 User_QuotasC Each user needs a PRCLM quota sufficient to create an additionalB process for the debugger, beyond the number of processes needed by the program.A BYTLM, ENQLM, FILLM, and PGFLQUOTA are pooled quotas. They may> need to be increased to account for the debugger process as follows:A o Each user's ENQLM quota should be increased by at least the) š number of processes being debugged.A o Each user's PGFLQUOTA might need to be increased. If a user? has an insufficient PGFLQUOTA, the debugger might fail to> activate or might cause "virtual memory exceeded" errors during execution.B o Each user's BYTLM and FILLM quotas may need to be increased.@ The debugger requires BYTLM and FILLM quotas sufficient toC open each image file being debugged, the corresponding source; files, and the debugger ›input, output, and log files. 3 System_ResourcesD The kernel and main debugger communicate through global sections.? The main debugger communicates with up to 8 kernel debuggersB through a 65-page global section. Therefore, the system global-@ page and global-section parameters (GBLPAGES and GBLSECTIONS,? respectively) might need to be increased. For example, if 10B users are using the debugger simultaneously, 10 global sectionsB using a total of 650 global pages are rœequired by the debugger. 2 @) Executes a debugger command procedure. Format% @file-spec [parameter[, . . . ]] 3 Parameters file-spec? Specifies the command procedure to be executed. For any partA of the full file specification not provided, the debugger uses> the file specification established with the last SET ATSIGNA command, if any. If the missing part of the file specificationD was not established by a SET ATSIGN command, the debugger  assumesB SYS$DISK:[]DEBUG.COM as the default file specification. You can specify a logical name. parameterA Specifies a parameter that is passed to the command procedure.A The parameter can be an address expression, a value expressionC in the current language, or a debugger command; the command must@ be enclosed within quotation marks ("). Unlike with DCL, youA must separate parameters by commas. Also, you can pass as manyC parameters as there are formal parame žter declarations within theC command procedure. For more information about passing parameters2 to command procedures, see the DECLARE command. 3 DescriptionB A debugger command procedure can contain any debugger commands,@ including another execute procedure (@) command. The debuggerC executes commands from the command procedure until it reaches anD EXIT or QUIT command or reaches the end of the command procedure.D At that point, the debugger returns control to the comm Ÿand streamB that invoked the command procedure. A command stream can be theD terminal, an outer (containing) command procedure, a DO clause inB a command such as SET BREAK, or a DO clause in a screen display definition.= By default, commands read from a command procedure are notC echoed. If you enter the SET OUTPUT VERIFY command, all commandsA read from a command procedure are echoed on the current outputC device, as specified by DBG$OUTPUT (the default output device is  SYS$OUTPUT).B For information about passing parameters to command procedures, see the DECLARE command. Related commands: DECLARE (SET,SHOW) ATSIGN SET OUTPUT [NO]VERIFY SHOW OUTPUT 3 Example' DBG> SET ATSIGN USER:[JONES.DEBUG].DBG DBG> SET OUTPUT VERIFY DBG> @CHECKOUT8 %DEBUG-I-VERIFYICF, entering command procedure CHECKOUT SET MODULE/ALL SET BREAK SUB1 GO break at routine PROG5\SUB2 EXAMINE X PROG5\SUB2\X: 37¡6 . . .3 %DEBUG-I-VERIFYICF, exiting command procedure MAIN DBG>8 In this example, the SET ATSIGN command establishes6 that debugger command procedures are, by default,8 in USER:[JONES.DEBUG] and have a file type of .DBG.9 The @CHECKOUT command executes the command procedureA USER:[JONES.DEBUG]CHECKOUT.DBG. The debugger echoes commands= in the command because of the SET OUTPUT VERIFY command. 2 ACTIVATE 3 BREAK? Activates a breakpoin¢t that you have previously set and then deactivated. Format3 ACTIVATE BREAK [address-expression[, . . . ]] 4 Parameters address-expressionB Specifies a breakpoint to be activated. Do not use the asteriskC (*) wildcard character. Instead, use the /ALL qualifier. Do notA specify an address expression when using any qualifiers except! /EVENT, /PREDEFINED, or /USER. 4 Qualifiers /ACTIVATING7 Activates a breakpoint established by£ a previous SET BREAK/ACTIVATING command. /ALL@ By default, activates all user-defined breakpoints. When used= with /PREDEFINED, activates all predefined breakpoints but@ no user-defined breakpoints. To activate all breakpoints, use /ALL/USER/PREDEFINED. /BRANCHD Activates a breakpoint established by a previous SET BREAK/BRANCH command. /CALLB Activates a breakpoint established by a previous SET BREAK/CALL command. /EVENT ¤/EVENT=event-name7 Activates a breakpoint established by a previous SET> BREAK/EVENT=event-name command. Specify the event name (and@ address expression, if any) exactly as specified with the SET BREAK/EVENT command.B To identify the current event facility and the associated event. names, use the SHOW EVENT_FACILITY command. /EXCEPTION7 Activates a breakpoint established by a previous SET BREAK/EXCEPTION command. /HANDLER7 Activates a breakpoint ¥established by a previous SET BREAK/HANDLER command. /INSTRUCTION7 Activates a breakpoint established by a previous SET BREAK/INSTRUCTION command. /LINEB Activates a breakpoint established by a previous SET BREAK/LINE: command. Do not specify an address expression with this qualifier. /PREDEFINED@ Activates a specified predefined breakpoint without affectingC any user-defined breakpoints. When used with /ALL, activates all predefined br¦eakpoints. /SYSEMULATED (Alpha only) Activates a breakpoint established by a previous SET BREAK/SYSEMULATE command. /TERMINATING7 Activates a breakpoint established by a previous SET BREAK/TERMINATING command. /UNALIGNED_DATA< (Alpha and Integrity servers only) Activates a breakpointA established by a previous SET BREAK/UNALIGNED_DATA command, or? reactivates a breakpoint previously disabled by a DEACTIVATE BREAK/UNALIGNED_DATA command. §/USERB Activates a specified user-defined breakpoint without affecting; any predefined breakpoints. To activate all user-defined' breakpoints, use the /ALL qualifier. 4 Description@ User-defined breakpoints are activated when you set them withA the SET BREAK command. Predefined breakpoints are activated byB default. Use the ACTIVATE BREAK command to activate one or more: breakpoints that you deactivated with DEACTIVATE BREAK.A Activating and deactivating break¨points enables you to run andC rerun your program with or without breakpoints without having toB cancel and then reset them. By default, the RERUN command savesC the current state of all breakpoints (activated or deactivated).> You can activate and deactivate user-defined breakpoints or> predefined breakpoints or both. To check if a breakpoint is) activated, use the SHOW BREAK command. Related commands: CANCEL ALL RERUN( (SET,SHOW,CANCEL,DEACTIVATE)© BREAK (SET,SHOW) EVENT_FACILITY 4 Examples% 1.DBG> ACTIVATE BREAK MAIN\LOOP+10B This command activates the user-defined breakpoint set at the% address expression MAIN\LOOP+10. 2.DBG> ACTIVATE BREAK/ALL9 This command activates all user-defined breakpoints., 3.DBG> ACTIVATE BREAK/ALL/USER/PREDEFINEDB This command activates all breakpoints, both user-defined and predefined. 3 TRACE? Activates a tracepoint that you have previoªusly set and then deactivated. Format3 ACTIVATE TRACE [address-expression[, . . . ]] 4 Parameters address-expressionB Specifies a tracepoint to be activated. Do not use the asteriskC (*) wildcard character. Instead, use the /ALL qualifier. Do notA specify an address expression when using any qualifiers except! /EVENT, /PREDEFINED, or /USER. 4 Qualifiers /ACTIVATING9 Activates a tracepoint established with a previous SET « TRACE/ACTIVATING command. /ALL@ By default, activates all user-defined tracepoints. When used= with /PREDEFINED, activates all predefined tracepoints but@ no user-defined tracepoints. To activate all tracepoints, use /ALL/USER/PREDEFINED. /BRANCH9 Activates a tracepoint established with a previous SET TRACE/BRANCH command. /CALLD Activates a tracepoint established with a previous SET TRACE/CALL command. /EVENT /EVENT=event-nam¬e9 Activates a tracepoint established with a previous SET> TRACE/EVENT=event-name command. Specify the event name (and@ address expression, if any) exactly as specified with the SET TRACE/EVENT command.B To identify the current event facility and the associated event. names, use the SHOW EVENT_FACILITY command. /EXCEPTION9 Activates a tracepoint established with a previous SET TRACE/EXCEPTION command. /INSTRUCTION9 Activates a tracepoint establis­hed with a previous SET TRACE/INSTRUCTION command. /LINED Activates a tracepoint established with a previous SET TRACE/LINE command. /PREDEFINED@ Activates a specified predefined tracepoint without affectingC any user-defined tracepoints. When used with /ALL, activates all predefined tracepoints. /TERMINATING9 Activates a tracepoint established with a previous SET TRACE/TERMINATING command. /USERB Activates a specified user-de ®fined tracepoint without affecting; any predefined tracepoints. To activate all user-defined' tracepoints, use the /ALL qualifier. 4 Description@ User-defined tracepoints are activated when you set them withA the SET TRACE command. Predefined tracepoints are activated byB default. Use the ACTIVATE TRACE command to activate one or more: tracepoints that you deactivated with DEACTIVATE TRACE.A Activating and deactivating tracepoints enables you to run andC rerun you¯r program with or without tracepoints without having toB cancel and then reset them. By default, the RERUN command savesC the current state of all tracepoints (activated or deactivated).> You can activate and deactivate user-defined tracepoints or> predefined tracepoints or both. To check if a tracepoint is) activated, use the SHOW TRACE command. Related commands: CANCEL ALL RERUN (SET,SHOW) EVENT_FACILITY( (SET,SHOW,CANCEL,DEACTIVATE) TRACE ° 4 Examples% 1.DBG> ACTIVATE TRACE MAIN\LOOP+10> This command activates the user-defined tracepoint at the location MAIN\LOOP+10. 2.DBG> ACTIVATE TRACE/ALL9 This command activates all user-defined tracepoints. 3 WATCH? Activates a watchpoint that you have previously set and then deactivated. Format3 ACTIVATE WATCH [address-expression[, . . . ]] 4 Parameters address-expression: Specifies a watchpoint to be acti±vated. With high-level> languages, this is typically the name of a variable. Do notB use the asterisk (*) wildcard character. Instead, use the /ALL= qualifier. Do not specify an address expression with /ALL. 4 Qualifiers /ALL Activates all watchpoints. 4 DescriptionA Watchpoints are activated when you set them with the SET WATCHB command. Use the ACTIVATE WATCH command to activate one or more: watchpoints that you deactivated with DEACTIVATE WATCH. ²A Activating and deactivating watchpoints enables you to run andC rerun your program with or without watchpoints without having to cancel and then reset them.? By default, the RERUN command saves the current state of all> static watchpoints (activated or deactivated). The state of@ a particular nonstatic watchpoint might or might not be savedC depending on the scope of the variable being watched relative to4 the main program unit (where execution restarts).< To chec³k if a watchpoint is activated, use the SHOW WATCH command. Related commands: CANCEL ALL RERUN( (SET,SHOW,CANCEL,DEACTIVATE) WATCH 4 Examples# 1.DBG> ACTIVATE WATCH SUB2\TOTAL? This command activates the watchpoint at variable TOTAL in module SUB2. 2.DBG> ACTIVATE WATCH/ALL< This command activates all watchpoints you have set and deactivated. 2 ANALYZE 3 /CRASH_DUMP? Opens a system dump for analysis ´by the System Dump Debugger (kept debugger only). Format ANALYZE/CRASH_DUMP 4 Description? For OpenVMS Integrity servers and Alpha systems, invokes the7 System Dump Debugger (SDD) to analyze a system dump.? SDD is similar in concept to the System Code Debugger (SCD).C While SCD allows connection to a running system, with control ofA the system's execution and the examination and modification ofC variables, SDD allows analysis of memory as recordeµd in a system dump.? Use of SDD usually involves two systems, although all of the= required environment can be set up on a single system. TheD description that follows assumes that two systems are being used:D o The build system, where the image that causes the system crash has been builtA o The test system, where the image is executed and the system crash occursA In common with SCD, the OpenVMS debugger user interface allows; you to specify variab ¶le names, routine names, and so on,> precisely as they appear in your source code. Also, SDD canB display the source code where the software was executing at the time of the system crash.B SDD recognizes the syntax, data typing, operators, expressions,C scoping rules, and other constructs of a given language. If your? code or driver is written in more than one language, you canC change the debugging context from one language to another during a debugging session.( · To use SDD you must do the following:A o Build the system image or device driver that is causing the system crash.A o Boot a system, including the system image or device driver,@ and perform the necessary steps to cause the system crash./ o Reboot the system and save the dump file.@ o Invoke SDD, which is integrated with the OpenVMS debugger.C For more information about using the SDD, including a sample SDD= session, see the VSI OpenVMS System Analysi"¸s Tools Manual. Related commands: ANALYZE/PROCESS_DUMP CONNECT %NODE SDA 4 Example DBG> ANALYZE/CRASH_DUMP DBG>/ Invokes SDD from within the kept debugger. 3 /PROCESS_DUMPB Opens a process dump for analysis with the System Code Debugger (kept debugger only) Format# ANALYZE/PROCESS_DUMP dumpfile 4 Parameters dumpfileB The name of the process dump file to be analyzed. The file type must be .¹DMP. 4 Qualifiers /IMAGE_PATH /IMAGE_PATH=directory-specD Specifies the search path for the debugger to find the files thatC contains the debugger symbol tables (DSTs). The files must be ofB type .DSF or .EXE, with the same name as the image names in theD dumpfile. For example, if image name foo.exe is in the dump file,5 then the debugger searches for foo.dsf or foo.exe. 4 Description? (Kept debugger only.) Opens a process dump for analysis wit ºhA the System Code Debugger (SCD). The qualifier /PROCESS_DUMP isD required and distinguishes this command from the one that invokes6 the System Dump Debugger (SDD), ANALYZE/CRASH_DUMP.< The qualifier /IMAGE_PATH=directory-spec is optional, and? specifies the search path the debugger is to use to find theB debugger symbol table (DST) files. The debugger builds an image@ list from the saved process image list. When you set an imageB (the main image is automatically set), th »e debugger attempts to- open that image in order to find the DSTs.? If you include the /IMAGE_PATH=directory-spec qualifier, theB debugger searches for the .DST file in the specified directory.> The debugger first tries to translate directory-spec as the> logical name of a directory search list. If that fails, theC debugger interprets directory-spec as a directory specification,A and searches that directory for matching .DSF or .EXE files. A@ .DSF file takes precedence ov ¼er an .EXE file. The name of the/ .DSF or .EXE file must match the image name.B If you do not include the /IMAGE_PATH=directory-spec qualifier,= the debugger looks for the DST file first in the directory@ that contains the dump file. If that fails, the debugger nextB searches directory SYS$SHARE and then directory SYS$MESSAGE. If@ the debugger fails to find a DST file for the image, symbolicA information available to the debugger is limited to global and universal symbol ½names.@ The debugger checks for link date-time mismatches between theB dump file image and the DST file and issues a warning if one is discovered.D The parameter dumpfile is the name of the process dump file to beB analyzed. Note that the process dump file type must be .DMP and1 the DST file type must be either .DSF or .EXE.C For more information about using SCD, see the VSI OpenVMS System Analysis Tools Manual. Related commands: ANALYZE/CRASH_DUMP ¾ CONNECT %NODE SDA 4 Example2 DBG> ANALYZE/PROCESS/IMAGE_DUMP=my_disk$:[my_dir] my_disk$:[my_dir]wecrash.dmpD %SYSTEM-F-IMGDMP, dynamic image dump signal at PC=001C0FA0B280099C, PS=001C003C0 break on unhandled exception preceding WECRASH\ th_run \%LINE 26412 in THREAD 8 26412: if (verify) {' DBG> SET RADIX HEXADECIMAL; EXAMINE PC) WECRASH\th_run\%PC: 0000000000030244 DBG> 2 ATTACH> Passes control of your terminal from the current ¿process to another process.& NOTEC This command is not available in the VSI DECwindows Motif for- OpenVMS user interface to the debugger. Format ATTACH process-name 3 Parameters process-nameB Specifies the process to which your terminal is to be attached.A The process must already exist before you try to attach to it.D If the process name contains nonalphanumeric or space characters,. you must enclÀose it in quotation marks ("). 3 Description> The ATTACH command enables you to go back and forth between? a debugging session and your command interpreter, or betweenA two debugging sessions. To do so, you must first use the SPAWN< command to create a subprocess. You can then attach to it= whenever you want. To return to your original process with7 minimal system overhead, use another ATTACH command. Related command: SPAWN 3 Examples 1.DBGÁ> SPAWN $ ATTACH JONES9 %DEBUG-I-RETURNED, control returned to process JONES DBG> ATTACH JONES_1 $A In this example, the series of commands creates a subprocess named@ JONES_1 from the debugger (currently running in the process1 JONES) and then attaches to that subprocess. 2.DBG> ATTACH "Alpha One" $@ This example illustrates using quotation marks to enclose a2 process name that contains a space character. 2 CALL5 CÂalls a routine that was linked with your program. Format. CALL routine-name [(argument[, . . . ])] 3 Parameters routine-name@ Specifies the name or the memory address of the routine to be called. argumentB Specifies an argument required by the routine. Arguments can beC passed by address, by descriptor, by reference, and by value, as follows:B %ADDR (Default, except for C and C++.) Passes the argument by- address. The form Ãat is as follows:7 CALL routine-name (%ADDR address-expression)< The debugger evaluates the address expression and< passes that address to the routine specified. For< simple variables (such as X), the address of X isA passed into the routine. This passing mechanism is howC Fortran implements ROUTINE(X). In other words, for namedD variables, using %ADDR corresponds to a call by referenceC in Fortran. For oth Äer expressions, however, you must useA the %REF function to call by reference. For complex orC composite variables (such as arrays, records, and access@ types), the address is passed when you specify %ADDR,B but the called routine might not handle the passed dataC properly. Do not specify a literal value (a number or an6 expression composed of numbers) with %ADDR.> %DESCR Passes the argument by descriptor. The format is as Å follows:9 CALL routine-name (%DESCR language-expression)= The debugger evaluates the language expression andB builds a standard descriptor to describe the value. TheB descriptor is then passed to the routine you named. You@ would use this technique to pass strings to a Fortran routine.= %REF Passes the argument by reference. The format is as follows:7 CALL routine-name (%REF language-expr Æession)D The debugger evaluates the language expression and passes@ a pointer to the value, into the called routine. ThisB passing mechanism corresponds to the way Fortran passes' the result of an expression.A %VAL (Default for C and C++.) Passes the argument by value.$ The format is as follows:7 CALL routine-name (%VAL language-expression)D The debugger evaluates the language expression and passes4 Ç the value directly to the called routine. 3 Qualifiers /AST /AST (default) /NOAST= Controls whether the delivery of asynchronous system trapsC (ASTs) is enabled or disabled during the execution of the calledB routine. The /AST qualifier enables the delivery of ASTs in the@ called routine. The /NOAST qualifier disables the delivery ofC ASTs in the called routine. If you do not specify /AST or /NOASTD with the CALL command, the delivery of ASTs is Èenabled unless you3 have previously entered the DISABLE AST command. /SAVE_VECTOR_STATE /SAVE_VECTOR_STATE$ /NOSAVE_VECTOR_STATE (default)C Applies to VAX vectorized programs. Controls whether the currentB state of the vector processor is saved and then restored when a+ routine is called with the CALL command.= The state of the vector processor comprises the following:C o The values of the vector registers (V0 to V15) and the vector+ control reÉgisters (VCR, VLR, and VMR)C o Any vector exception (an exception caused by the execution of: a vector instruction) that might be pending delivery@ When you use the CALL command to execute a routine, executionC of the routine might change the state of the vector processor as follows:B o By changing the values of vector registers or vector control registers# o By causing a vector exceptionD o By causing the delivery of a vector exception that was p Êending& when the CALL command was issuedC The /SAVE_VECTOR_STATE qualifier specifies that after the calledC routine has completed execution, the debugger restores the stateA of the vector processor that exists before the CALL command isD issued. This ensures that, after the called routine has completed execution:D o Any vector exception that was pending delivery before the CALL2 command was issued is still pending deliveryD o No vector exception that was t Ëriggered during the routine call is still pending delivery? o The values of the vector registers are identical to their/ values before the CALL command was issued< The /NOSAVE_VECTOR_STATE qualifier (which is the default)? specifies that the state of the vector processor that existsD before the CALL command is issued is not restored by the debuggerB after the called routine has completed execution. In this case,C the state of the vector processor after the routi Ìne call depends0 on the effect (if any) of the called routine.> The /[NO]SAVE_VECTOR_STATE qualifiers have no effect on theD general registers. The values of these registers are always savedA and restored when you execute a routine with the CALL command. 3 Description= The CALL command is one of the four debugger commands that@ can be used to execute your program (the others are GO, STEP,? and EXIT). The CALL command enables you to execute a routineB independently Í of the normal execution of your program. The CALLB command executes a routine whether or not your program actually> includes a call to that routine, as long as the routine was linked with your program.B When you enter a CALL command, the debugger takes the followingA actions. For more information, see the qualifier descriptions.8 1. Saves the current values of the general registers." 2. Constructs an argument list.A 3. Executes a call to the routine specified in the Îcommand and passes any arguments. 4. Executes the routine.> 5. Displays the value returned by the routine in the return@ status register. By convention, after a called routine has> executed, register R0 contains the function return value@ (if the routine is a function) or the procedure completionA status (if the routine is a procedure that returns a statusB value). If a called procedure does not return a status valueB or function value, the val Ïue in R0 might be meaningless, and2 the "value returned" message can be ignored.@ 6. Restores the values of the general registers to the values9 they had just before the CALL command was executed. 7. Issues the prompt.? The debugger assumes that the called routine conforms to theA procedure calling standard (see the OpenVMS Calling Standard).> However, the debugger does not know about all the argument-= passing mechanisms for all supported languages. Therefore, ÐA you might need to specify how to pass parameters, for example,? use CALL SUB1(%VAL X) rather than CALL SUB1(X). For completeC information about how arguments are passed to routines, see your language documentation.= When the current language is C or C++, the CALL command byB default now passes arguments by value rather than by reference.@ In addition, you can now pass the following arguments without< using a passing mechanism lexical (such as %REF or %VAL): o Ro Ñutine references. o Quoted strings (treated as %REF strings)& o Structures, records, and objectsB o Floating-point parameters by value in F_, D_, G_, S_, and T_? floating format by dereferencing a variable of that type.A If the routine contains parameters that are not read-only, the? values assigned to parameters may not be visible, and access@ to values is unreliable. This is because the debugger adjustsA parameter values in an internal argument list, not the ÒprogramC argument list. To examine changing values, consider using static# variables instead of parameters.> The CALL command converts all floating-point literals to F_B floating format for VAX and Alpha systems and T_floating format for Integrity servers.D On Alpha, passing a floating-point literal in a format other than> F_floating is not supported, as shown in the example below.: A common debugging technique at an exception breakpointC (resulting from a SET BRE ÓAK/EXCEPTION or STEP/EXCEPTION command)B is to call a dump routine with the CALL command. When you enter@ the CALL command at an exception breakpoint, any breakpoints,B tracepoints, or watchpoints that were previously set within theD called routine are temporarily disabled so that the debugger does@ not lose the exception context. However, such eventpoints areC active if you enter the CALL command at a location other than an exception breakpoint. 3 Description,_Continue Ôd...D When an exception breakpoint is triggered, execution is suspended@ before any application-declared condition handler is invoked.B At an exception breakpoint, entering a GO or STEP command afterC executing a routine with the CALL command causes the debugger to9 resignal the exception (see the GO and STEP commands).D On Alpha processors, you cannot debug routines that are activatedD before the routine activated by a CALL command. For example, yourB program is stopped Õin routine MAIN, and you set a breakpoint in@ routine SORT. You issue the debugger command CALL SORT. WhileB debugging routine SORT, you cannot debug routine MAIN. You must/ first return from the call to routine SO RT.C If you are debugging a multiprocess program, the CALL command isC executed in the context of the current process set. In addition,D when debugging a multiprocess program, the way in which executionA continues in your process depends on whether you entered a SEÖT@ MODE [NO]INTERRUPT command or a SET MODE [NO]WAIT command. By> default (SET MODE NOINTERRUPT), when one process stops, the? debugger takes no action with regard to the other processes.< Also by default (SET MODE WAIT), the debugger waits until? all processes in the current process set have stopped before prompting for a new command. Related commands: GO EXIT SET PROCESS SET MODE [NO]INTERRUPT STEP 3 Examples 1.DBG> CA×LL SUB1(X) value returned is 19 DBG>C This command calls routine SUB1, with parameter X (by default,C the address of X is passed). In this case, the routine returns the value 19. 2.DBG> CALL SUB(%REF 1) value returned is 1 DBG>B This command passes a pointer to a memory location containing1 the numeric literal 1, into the routine SUB.! 3.DBG> SET MODULE SHARE$LIBRTL DBG> CALL LIB$SHOW_VMF 1785 calls to LIB$GET_VM, 284 Øcalls to LIB$FREE_VM, 122216 bytes1 still allocated, value returned is 00000001 DBG>< This example calls Run-Time Library routine LIB$SHOW_VM> (in shareable image LIBRTL) to display memory statistics.@ The SET MODULE command makes the universal symbols (routineB names) in LIBRTL visible in the main image. See also the SHOW MODULE/SHARE command.; 4.DBG> CALL testsub (%val 11.11, %val 22.22, %val 33.33)A This example passes floating-point parametersÙ by value, to aB C subroutine with the function prototype void testsub (float,B float, float). The floating-point parameters are passed in F_ floating format. 2 CANCEL 3 ALLB Cancels all breakpoints, tracepoints, and watchpoints. RestoresA the scope and type to their default values. Restores the line,? symbolic, and G_floating modes established with the SET MODE# command to their default values. Format CANCEL ALL 4 QualifiersÚ /PREDEFINED? Cancels all predefined (but no user-defined) breakpoints and tracepoints. /USER< Cancels all user-defined (but no predefined) breakpoints,? tracepoints, and watchpoints. This is the default unless you specify /PREDEFINED. 4 Description- The CANCEL ALL command does the following:> 1. Cancels all user-defined eventpoints (those created with@ the commands SET BREAK, SET TRACE, and SET WATCH). This isB equivalent to entering Û the commands CANCEL BREAK/ALL, CANCEL? TRACE/ALL, and CANCEL WATCH/ALL. Depending on the type ofA program (for example Ada, multiprocess), certain predefined@ breakpoints or tracepoints might be set automatically whenC you start the debugger. To cancel all predefined but no user-? defined eventpoints, use CANCEL ALL/PREDEFINED. To cancel= all predefined and user-defined eventpoints, use CANCEL ALL/PREDEFINED/USER.9 2. Restores the scope search list Ü to its default valueB (0,1,2, . . . ,n). This is equivalent to entering the CANCEL SCOPE command.: 3. Restores the data type for memory locations that areA associated with a compiler-generated type to the associatedC type. Restores the type for locations that are not associatedC with a compiler-generated type to "longword integer". This isB equivalent to entering the CANCEL TYPE/OVERRIDE and SET TYPE LONGWORD commands.C 4. Restores the line, sÝymbolic, and G_floating modes established@ with the SET MODE command to their default values. This is3 equivalent to entering the following command:+ DBG> SET MODE LINE,SYMBOLIC,NOG_FLOAT> The CANCEL ALL command does not affect the current language< setting or modules included in the run-time symbol table.  Related commands: (CANCEL,DEACTIVATE) BREAK CANCEL SCOPE (CANCEL,DEACTIVATE) TRACE CANCEL TYPE/OVERRIDE (CANCEL,DEACTIÞVATE) WATCH (SET,CANCEL) MODE SET TYPE 4 Examples 1.DBG> CANCEL ALL: This command cancels all user-defined breakpoints andA tracepoints and all watchpoints, and restores scopes, types,C and some modes to their default values. In this example, there2 are no predefined breakpoints or tracepoints. 2.DBG> CANCEL ALL? %DEBUG-I-PREDEPTNOT, predefined eventpoint(s) not canceled: This command cancels all user-defined breakpoints andA ß tracepoints and all watchpoints, and restores scopes, types,C and some modes to their default values. In this example, thereC is a predefined breakpoint or tracepoint; this is not canceled by default. 3.DBG> CANCEL ALL/PREDEFINED8 This command cancels all predefined breakpoints and< tracepoints, and restores scopes, types, and some modes< to their default values. No user-defined breakpoints or tracepoints are affected. 3 BREAK Cancels a bàreakpoint. Format1 CANCEL BREAK [address-expression[, . . . ]] 4 Parameters address-expressionA Specifies a breakpoint to be canceled. Do not use the asteriskC (*) wildcard character. Instead, use the /ALL qualifier. Do notA specify an address expression when using any qualifiers except! /EVENT, /PREDEFINED, or /USER. 4 Qualifiers /ACTIVATINGA Cancels the effect of a previous SET BREAK/ACTIVATING command. /ALL> By deáfault, cancels all user-defined breakpoints. When used> with /PREDEFINED, cancels all predefined breakpoints but noB user-defined breakpoints. To cancel all breakpoints, use CANCEL BREAK/ALL/USER/PREDEFINED. /BRANCH= Cancels the effect of a previous SET BREAK/BRANCH command. /CALL; Cancels the effect of a previous SET BREAK/CALL command. /EVENT /EVENT=event-name> Cancels the effect of a previous SET BREAK/EVENT=event-name> command. Specifây the event name (and address expression, ifA any) exactly as specified with the SET BREAK/EVENT command. To? identify the current event facility and the associated event. names, use the SHOW EVENT_FACILITY command. /EXCEPTION@ Cancels the effect of a previous SET BREAK/EXCEPTION command. /HANDLER> Cancels the effect of a previous SET BREAK/HANDLER command. /INSTRUCTIONB Cancels the effect of a previous SET BREAK/INSTRUCTION command. /LINE; Cãancels the effect of a previous SET BREAK/LINE command. /PREDEFINED> Cancels a specified predefined breakpoint without affectingA any user-defined breakpoints. When used with /ALL, cancels all predefined breakpoints. /SYSEMULATE4 (Alpha only) Cancels the effect of a previous SET BREAK/SYSEMULATE command. /TERMINATINGB Cancels the effect of a previous SET BREAK/TERMINATING command. /UNALIGNED_DATA4 (Alpha only) Cancels the effect of a preväious SET BREAK/UNALIGNED_DATA command. /USERD Cancels a specified user-defined breakpoint without affecting anyA predefined breakpoints. This is the default unless you specifyD /PREDEFINED. To cancel all user-defined breakpoints, use the /ALL qualifier. 4 Description> Breakpoints can be user defined or predefined. User-defined= breakpoints are set explicitly with the SET BREAK command.> Predefined breakpoints, which depend on the type of programB you a åre debugging (for example, Ada or ZQUIT multiprocess), areA established automatically when you start the debugger. Use theD SHOW BREAK command to identify all breakpoints that are currently: set. Any predefined breakpoints are identified as such.? User-defined and predefined breakpoints are set and canceled@ independently. For example, a location or event can have bothB a user-defined and a predefined breakpoint. Canceling the user-D defined breakpoint does not affect the pred æefined breakpoint, and conversely.: To cancel only user-defined breakpoints, do not specifyD /PREDEFINED with the CANCEL BREAK command (the default is /USER).= To cancel only predefined breakpoints, specify /PREDEFINED< but not /USER. To cancel both predefined and user-defined3 breakpoints, specify both /PREDEFINED and /USER.D In general, the effect of the CANCEL BREAK command is symmetrical@ with that of the SET BREAK command (even though the SET BREAK@ command is us çed only with user-defined breakpoints). Thus, toC cancel a breakpoint that was established at a specific location,B specify that same location (address expression) with the CANCEL= BREAK command. To cancel breakpoints that were established= on a class of instructions or events, specify the class ofB instructions or events with the corresponding qualifier (/LINE,C /BRANCH, /ACTIVATING, /EVENT=, and so on). For more information," see the qualifier descriptions.? If you wantè the debugger to ignore a breakpoint without your= having to cancel it (for example, if you want to rerun theB program with and without breakpoints), use the DEACTIVATE BREAKC instead of the CANCEL BREAK command. Later, you can activate the$ breakpoint (with ACTIVATE BREAK).  Related commands:! (ACTIVATE,DEACTIVATE) BREAK CANCEL ALL (SET,SHOW) BREAK (SET,SHOW) EVENT_FACILITY (SET,SHOW,CANCEL) TRACE 4 Examples# 1.DBG> CANCEL BéREAK MAIN\LOOP+10@ This command cancels the user-defined breakpoint set at the% address expression MAIN\LOOP+10. 2.DBG> CANCEL BREAK/ALL7 This command cancels all user-defined breakpoints.* 3.DBG> CANCEL BREAK/ALL/USER/PREDEFINED9 This command cancels all user-defined and predefined breakpoints.! 4.all> CANCEL BREAK/ACTIVATING5 This command cancels a previous user-defined SETA BREAK/ACTIVATING command. As a result, the debugger does noêtC suspend execution when a new process is brought under debugger control.< 5.DBG> CANCEL BREAK/EVENT=EXCEPTION_TERMINATED/PREDEFINED? This command cancels the predefined breakpoint set on task> terminations due to unhandled exceptions. This breakpoint@ is predefined for Ada programs and programs that call POSIX threads or Ada routines. 3 DISPLAY( Permanently deletes a screen display.& NOTEC This commandë is not available in the VSI DECwindows Motif for- OpenVMS user interface to the debugger. Format- CANCEL DISPLAY [display-name[, . . . ]] 4 Parameters display-nameA Specifies the name of a display to be canceled. Do not specify; the PROMPT display, which cannot be canceled. Do not use> the asterisk (*) wildcard character. Instead, use the /ALL6 qualifier. Do not specify a display name with /ALL. 4 Qualifiers /ALL3 Cancels aìll displays, except the PROMPT display. 4 DescriptionA When a display is canceled, its contents are permanently lost,C it is deleted from the display list, and all the memory that was allocated to it is released.( You cannot cancel the PROMPT display. Related commands: (SHOW) DISPLAY (SET,SHOW,CANCEL) WINDOW 4 Examples 1.DBG> CANCEL DISPLAY SRC2' This command deletes display SRC2. 2.DBG> CANCEL DISPLAY/ALLB This commíand deletes all displays, except the PROMPT display. 3 MODEC Restores the line, symbolic, and G_floating modes established byB the SET MODE command to their default values. Also restores the default input/output radix.& NOTEC This command is not available in the VSI DECwindows Motif for- OpenVMS user interface to the debugger. Format CANCEL MODE 4 Description= The effect of the CANCEL MODE command is equiîvalent to the following commands:( DBG> SET MODE LINE,SYMBOLIC,NOG_FLOAT DBG> CANCEL RADIXC The default radix for both data entry and display is decimal for most languages.? On Alpha processors, the exceptions are BLISS, MACRO-32, and7 MACRO-64, which have a default radix of hexadecimal.? On Intel[R] Itanium[R] processors, the exceptions are BLISS,' MACRO, and Intel[R] Assembler (IAS). Related commands: (SET,SHOW) MODE (SET,SHOW,CANCELï) RADIX 4 Example DBG> CANCEL MODEA This command restores the default radix mode and all default mode values. 3 RADIXB Restores the default radix for the entry and display of integer data. Format CANCEL RADIX 4 Qualifiers /OVERRIDE; Cancels the override radix established by a previous SET? RADIX/OVERRIDE command. This sets the current override radix< to "none" and restores the output radix mode to the value< e ðstablished with a previous SET RADIX or SET RADIX/OUTPUTA command. If you did not change the radix mode with a SET RADIXA or SET RADIX/OUTPUT command, the CANCEL RADIX/OVERRIDE command0 restores the radix mode to its default value. 4 DescriptionB The CANCEL RADIX command cancels the effect of any previous SETC RADIX and SET RADIX/OVERRIDE commands. It restores the input and' output radix to their default value.C The default radix for both data entry and display is deñcimal forC most languages. The exceptions are BLISS and MACRO, which have a default radix of hexadecimal.B The effect of the CANCEL RADIX/OVERRIDE command is more limitedB and is explained in the description of the /OVERRIDE qualifier. Related commands: EVALUATE (SET,SHOW) RADIX 4 Examples 1.DBG> CANCEL RADIX> This command restores the default input and output radix. 2.DBG> CANCEL RADIX/OVERRIDED This command cancels any overriòde radix you might have set with$ the SET RADIX/OVERRIDE command. 3 SCOPE< Restores the default scope search list for symbol lookup. Format CANCEL SCOPE 4 DescriptionA The CANCEL SCOPE command cancels the current scope search list? established by a previous SET SCOPE command and restores theD default scope search list, namely 0,1,2, . . . ,n, where n is the% number of calls in the call stack.= The default scope search list specifies that, foró a symbol@ without a path-name prefix, a symbol lookup such as EXAMINE X? first looks for X in the routine that is currently executingA (scope 0); if no X is visible there, the debugger looks in theC caller of that routine (scope 1), and so on down the call stack;B if X is not found in scope n, the debugger searches the rest ofC the run-time symbol table (RST), then searches the global symbol table (GST), if necessary. Related commands: (SET,SHOW) SCOPE ô 4 Example DBG> CANCEL SCOPE, This command cancels the current scope. 3 SOURCED Cancels a source directory search list, a source directory searchB method, or both a list and method established by a previous SET SOURCE command. Format CANCEL SOURCE 4 Qualifiers /DISPLAY? Cancels the effect of a previous SET SOURCE/DISPLAY command,> which specifies the directory search list to be used by the? debugger when displaying source code.õ Canceling this commandD means the debugger searches for a source file in the directory in which it was compiled. /EDITB Cancels the effect of a previous SET SOURCE/EDIT command, whichB specifies the directory search list to be used during executionC of the debugger's EDIT command. Canceling this command means theC debugger searches for a source file in the directory in which it was compiled. /EXACTC Cancels the effect of a previous SET SOURCE/EXACT com ömand, whichD specifies a directory search method. Canceling this command meansD that the debugger no longer searches for the exact version of theC source file from compilation; it reverts to the default behavior3 of searching for the latest version of the file. /LATESTD Cancels the effect of a previous SET SOURCE/LATEST command, which@ specifies a directory search method. In this case, the CANCELD SOURCE/LATEST command directs the debugger to return to searching= f ÷or the exact version of the source file from compilation.D Because /LATEST is the default setting, this qualifier only makes? sense when used with other qualifiers, for example, /MODULE. /MODULE /MODULE=module-name= Cancels the effect of a previous SET SOURCE/MODULE=module-A name command in which the same module name and qualifiers wereC specified. (The /MODULE qualifier allows you to specify a unique? directory search list, directory search method, or both, øforB the named module.) You can append one or more of the qualifiersA listed above to the SET SOURCE/MODULE and CANCEL SOURCE/MODULE commands.> If you issue a CANCEL SOURCE/MODULE command with additional@ qualifiers, you cancel the effect of the specified qualifiersB on the module. If you issue an unqualified CANCEL SOURCE/MODULEA command, the debugger no longer differentiates the module from( any other module in your directories. /ORIGINALC (Applies to STDL ùprograms only. Requires the installation of theC Correlation Facility (a separate layered product) and invocation> of the kept debugger.) Cancels the effect of a previous SET> SOURCE/ORIGINAL command. The SET SOURCE/ORIGINAL command isA required to debug STDL source files, and must be canceled when5 you debug source files written in other languages. 4 Description< CANCEL SOURCE cancels the effect of a previous SET SOURCE: command. The nature of this cancellation depend ús on the@ qualifiers activated in previous SET SOURCE commands. See theA CANCEL SOURCE examples to see how CANCEL SOURCE and SET SOURCE interact.@ When you issue a SET SOURCE command, be aware that one of theA two qualifiers -/LATEST or /EXACT-will always be active. These< qualifiers affect the debugger search method. The /LATEST@ qualifier directs the debugger to search for the version last@ created (the highest-numbered version in your directory). TheB /EXACT qualifie ûr directs the debugger to search for the versionC last compiled (the version recorded in the debugger symbol table= created at compile time). For example, a SET SOURCE/LATEST? command might search for SORT.FOR;3 while a SET SOURCE/EXACT' command might search for SORT.FOR;1.D CANCEL SOURCE without the /DISPLAY or /EDIT qualifier cancels theA effect of both SET SOURCE/DISPLAY and SET SOURCE/EDIT, if both were previously given.B The /DISPLAY qualifier is needed when the ü files to be displayed. are no longer in the compilation directory.D The /EDIT qualifier is needed when the files used for the displayD of source code are different from the editable files. This is theB case with Ada programs. For Ada programs, the (SET,SHOW,CANCEL)= SOURCE commands affect the search of files used for source@ display (the "copied" source files in Ada program libraries);B the (SET,SHOW,CANCEL) SOURCE/EDIT commands affect the search of> the source files that yýou edit when using the EDIT command.4 For information specific to Ada programs, see the# Language_Support Ada help topic. Related commands: (SET,SHOW) SOURCE 4 ExamplesA 1.DBG> SET SOURCE/MODULE=CTEST/EXACT [],SYSTEM::DEVICE:[PROJD]2 DBG> SET SOURCE [PROJA],[PROJB],[PETER.PROJC] . . . DBG> SHOW SOURCE/ source directory search list for CTEST,- match the exact source file version: []# SYSTEM::DEVþICE:[PROJD]5 source directory list for all other modules,. match the latest source file version: [PROJA] [PROJB] [PETER.PROJC] DBG> CANCEL SOURCE DBG> SHOW SOURCE/ source directory search list for CTEST,- match the exact source file version: []# SYSTEM::DEVICE:[PROJD]1 all other source files will try to match' the latest source file versionD In this exa ÿmple, the SET SOURCE command establishes a directoryB search list and a search method (the default, latest version)A for source files other than CTEST. The CANCEL SOURCE command> cancels the directory search list but does not cancel the search method. 2.DBG> SET SOURCE /EXACT DBG> SHOW SOURCE, no directory search list in effect,% match the exact source file DBG> SET SOURCE [JONES] DBG> SHOW SOURCE/ source directory list for  all modules,. match the exact source file version: [JONES] DBG> CANCEL SOURCE /EXACT DBG> SHOW SOURCE0 source directory list for all modules,/ match the latest source file version: [JONES]@ In this example, the SET SOURCE/EXACT command establishes aA search method (exact version) that remains in effect for theD SET SOURCE [JONES] command. The CANCEL SOURCE/EXACT command notD only cancels the SET SOURCE/EXACT command, but also affects the SET SOURCE [JONES] command. 3 TRACE Cancels a tracepoint. Format1 CANCEL TRACE [address-expression[, . . . ]] 4 Parameters address-expressionA Specifies a tracepoint to be canceled. Do not use the asteriskC (*) wildcard character. Instead, use the /ALL qualifier. Do notA specify an address expression when using any qualifiers except! /EVENT, /PREDEFINED, or /USER. 4 Qualifiers /ACTIVATINGA Cancels the effect of a previous SET TRACE/ACTIVATING command. /ALL> By default, cancels all user-defined tracepoints. When used> with /PREDEFINED, it cancels all predefined tracepoints but> no user-defined tracepoints. To cancel all tracepoints, use /ALL/USER/PREDEFINED. /BRANCH= Cancels the effect of a previous SET TRACE/BRANCH command. /CALL; Cancels the effect of a previous SET TRACE/CALL command. /EVENT /EVENT=event-name> Cancels the effect of a previous SET TRACE/EVENT=event-name> command. Specify the event name (and address expression, ifA any) exactly as specified with the SET TRACE/EVENT command. To? identify the current event facility and the associated event. names, use the SHOW EVENT_FACILITY command. /EXCEPTION@ Cancels the effect of a previous SET TRACE/EXCEPTION command. /INSTRUCTIONB Cancels the effect of a previous SET TRACE/INSTRUCTION command. /LINE; Cancels the effect of a previous SET TRACE/LINE command. /PREDEFINEDB Cancels a specified predefined tracepoint without affecting any@ user-defined tracepoints. When used with /ALL, it cancels all predefined tracepoints. /TERMINATINGB Cancels the effect of a previous SET TRACE/TERMINATING command. /USERD Cancels a specified user-defined tracepoint without affecting anyA predefined tracepoints. This is the default unless you specifyA /PREDEF INED. To cancel all user-defined tracepoints, use /ALL. 4 Description> Tracepoints can be user defined or predefined. User-defined= tracepoints are explicitly set with the SET TRACE command.B Predefined tracepoints, which depend on the type of program youD are debugging (for example, Ada or multiprocess), are established@ automatically when you start the debugger. Use the SHOW TRACEB command to identify all tracepoints that are currently set. Any1 predefined tracepoints are identified as such.? User-defined and predefined tracepoints are set and canceled@ independently. For example, a location or event can have bothB a user-defined and a predefined tracepoint. Canceling the user-D defined tracepoint does not affect the predefined tracepoint, and conversely.: To cancel only user-defined tracepoints, do not specifyD /PREDEFINED with the CANCEL TRACE command (the default is /USER).= To cancel only predefined tracepoints, specify /PREDEFINE D< but not /USER. To cancel both user-defined and predefined5 tracepoints, use CANCEL TRACE/ALL/USER/PREDEFINED.= In general, the effect of CANCEL TRACE is symmetrical with= that of SET TRACE (even though SET TRACE is used only with? user-defined tracepoints). Thus, to cancel a tracepoint that< was established at a specific location, specify that same= location (address expression) with CANCEL TRACE. To cancel? tracepoints that were established on a class of instructionsB or events, specify the class of instructions or events with theA corresponding qualifier (/LINE, /BRANCH, /ACTIVATING, /EVENT=,D and so on). For more information, see the qualifier descriptions.@ To cause the debugger to temporarily ignore a tracepoint, butB retain definition of the tracepoint, use the command DEACTIVATE> TRACE. You can later activate the tracepoint (with ACTIVATE TRACE). Related commands:* (ACTIVATE,DEACTIVATE,SET,SHOW) TRACE CANCEL A LL (SET,SHOW,CANCEL) BREAK (SET,SHOW) EVENT_FACILITY 4 Examples# 1.DBG> CANCEL TRACE MAIN\LOOP+10< This command cancels the user-defined tracepoint at the location MAIN\LOOP+10. 2.DBG> CANCEL TRACE/ALL7 This command cancels all user-defined tracepoints." 3.all> CANCEL TRACE/TERMINATINGC This command cancels a previous SET TRACE/TERMINATING command.C As a result, a user-defined tracepoint is not triggered when a process  does an image exit.( 4.DBG> CANCEL TRACE/EVENT=RUN %TASK 3@ This command cancels the tracepoint that was set to trigger5 when task 3 (task ID = 3) entered the RUN state. 3 TYPE 4 /OVERRIDE: Cancels the override type established by a previous SET TYPE/OVERRIDE command. Format CANCEL TYPE/OVERRIDE 5 DescriptionB The CANCEL TYPE/OVERRIDE command sets the current override type? to "none." As a result, a program location associated w! ith aA compiler-generated type is interpreted according to that type. Related commands: DEPOSIT EXAMINE (SET,SHOW) EVENT_FACILITY (SET,SHOW) TYPE/OVERRIDE 5 Example DBG> CANCEL TYPE/OVERRIDED This command cancels the effect of a previous SET TYPE/OVERRIDE command. 3 WATCH Cancels a watchpoint. Format1 CANCEL WATCH [address-expression[, . . . ]] 4 Parameters address-expressionD Specifi es a watchpoint to be canceled. With high-level languages,D this is typically the name of a variable. Do not use the asteriskC (*) wildcard character. Instead, use the /ALL qualifier. Do not+ specify an address expression with /ALL. 4 Qualifiers /ALL Cancels all watchpoints. 4 DescriptionA The effect of the CANCEL WATCH command is symmetrical with theC effect of the SET WATCH command. To cancel a watchpoint that wasA established at a specific locat ion with the SET WATCH command,@ specify that same location with CANCEL WATCH. Thus, to cancel@ a watchpoint that was set on an entire aggregate, specify the@ aggregate in the CANCEL WATCH command; to cancel a watchpointD that was set on one element of an aggregate, specify that element in the CANCEL WATCH command.7 The CANCEL ALL command also cancels all watchpoints.@ To cause the debugger to temporarily ignore a watchpoint, but? not delete the definition of the watchpoint, use the command@ DEACTIVATE WATCH. You can later activate the watchpoint (with ACTIVATE WATCH). Related commands:* (ACTIVATE,DEACTIVATE,SET,SHOW) WATCH CANCEL ALL (SET,SHOW,CANCEL) BREAK (SET,SHOW,CANCEL) TRACE 4 Examples! 1.DBG> CANCEL WATCH SUB2\TOTALD This command cancels the watchpoint at variable TOTAL in module SUB2. 2.DBG> CANCEL WATCH/ALL7 This command cancels all watchpoints you have set. 3 WINDOW2 Permanently deletes a screen window definition.& NOTEC This command is not available in the VSI DECwindows Motif for- OpenVMS user interface to the debugger. Format+ CANCEL WINDOW [window-name[, . . . ]] 4 Parameters window-nameC Specifies the name of a screen window definition to be canceled.@ Do not use the asterisk (*) wildcard character. Instead, useC the /ALL qualifier. Do not specify a window definition name with /ALL. 4 Qualifiers /ALL> Cancels all predefined and user-defined window definitions. 4 DescriptionB When a window definition is canceled, you can no longer use its@ name in a DISPLAY command. The CANCEL WINDOW command does not affect any displays. Related commands: (SHOW,CANCEL) DISPLAY (SET,SHOW) WATCH 4 Example DBG> CANCEL WINDOW MIDDLEB This command permanently deletes the screen window definition MIDDLE. 2 CONNECTD (Kept debugger only.) Interrupts an image that is running withoutD debugger control in another process and brings that process underB debugger control. When used without a parameter, CONNECT bringsA any spawned process that is waiting to connect to the debugger under debugger control.B On Alpha systems, the debugger command CONNECT can also be used> to bring a target system running the Alpha operating system? under the control of the OpenVMS Alpha System-Code Debugger.C The OpenVMS Alpha System-Code Debugger is a kernel debugger that- you activate through the OpenVMS Debugger.A On Integrity servers, the debugger command CONNECT can also be> used to bring a target system running the Integrity servers> operating system under the control of the OpenVMS IntegrityD server System-Code Debugger. The OpenVMS Integrity server System-C Code Debugger is a kernel debugger that you activate through the OpenV MS Debugger.D If you are using the CONNECT command to debug the Alpha operating> system, you must complete the instructions described in theB System Code Debugger chapter of the VSI OpenVMS System AnalysisA Tools Manual before you issue the command. (These instructions? include the creation of an Alpha device driver and the setupC commands activating the OpenVMS Alpha System-Code Debugger.) YouC must also have started the OpenVMS Debugger with the DCL command DEBUG/KEEP. Format CONNECT [process-spec]" CONNECT %NODE_NAME node-name 3 Parameters process-spec= Specifies a process in which an image to be interrupted is> running. The process must be in the same OpenVMS job as the< process in which the debugger was started. Use any of the following forms:= [%PROCESS_NAME] proc- The OpenVMS process name, if that? name name contains no space or lowercaseD char acters. The process name can includeA the asterisk (*) wildcard character.B [%PROCESS_NAME] "proc- The OpenVMS process name, if that nameC name" contains space or lowercase characters.D You can also use apostrophes (') instead3 of quotation marks (").B %PROCESS_PID proc-id The OpenVMS process identifier (PID, a0 hexadecimal number). node-nameD (Alpha or Integrity servers only) When you are debugging an AlphaA or Integrity servers operating system, specifies the node nameA of the machine to which you are connecting (the target machine< running the Alpha or Integrity servers operating system). 3 Qualifiers /PASSWORD /PASSWORD="password"D (Alpha or Integrity servers only) When you are debugging an Alpha@ or Integrity servers operating system, specifies the passwordB for the machine to which you are connecting (the target machine? running the Alpha or Integrity servers operating system). If= a password has not been established for that machine, this qualifier can be omitted. /IMAGE_PATH /IMAGE_PATH="image-path"D (Alpha or Integrity servers only) When you are debugging an AlphaB operating system, specifies the image-path for the machine fromD which you are connecting (the host machine running the debugger).B The image-path is a logical name that poi nts to the location of@ system images. The default logical name is DBGHK$IMAGE_PATH:. 3 Description@ (Kept debugger only.) When you specify a process, the CONNECTD command enables you to interrupt an image that is running without? debugger control in that process and bring the process underC debugger control. The command is useful if, for example, you runB a debuggable image with the DCL command RUN/NODEBUG, or if yourA program issues a LIB$SPAWN Run-Time Library call th at does notC start the debugger. You can connect to a process created throughD a $CREPRC system service call only if you specify LOGINOUT.EXE as the executable image.C Depending on the version of the debugger you are running on yourA system, you may be restricted to connection with processes youA created, or you may be able to connect to processes created byD any member of your user identification code (UIC) group. (In someB cases, you may have to set the SYSGEN SECURIT Y_POLICY parameter' to 8 before you create the process.)@ If debugger logicals (DEBUG, DEBUGSHR, DEBUGUISHR, DBGTBKMSG,8 DBG$PROCESS, DBG$HELP, DBG$UIHELP, DEBUGAPPCLASS, andB VMSDEBUGUIL) exist, they must translate to the same definitions/ in both the debugger and the target process.C The code in the image must be compiled with the /DEBUG qualifier? and the image must be linked with either /DEBUG or /DSF. The< image must not be linked with the /NOTRACEBACK qualifier. C When the process is brought under debugger control, execution ofC the image is suspended at the point at which it was interrupted.D When you do not specify a process, the CONNECT command brings anyB processes that are waiting to connect to your debugging sessionB under debugger control. If no process is waiting, you can press' Ctrl/C to abort the CONNECT command.B By default, a tracepoint is triggered when a process is broughtC under debugger control. This predefined tracepoint is equivalentD to that resulting from entering the SET TRACE/ACTIVATING command.B The process is then known to the debugger and can be identified in a SHOW PROCESS display.@ You cannot use the CONNECT command to connect to a subprocessB of a process running under debugger control.Use the SET PROCESS+ command to connect to such a subprocess. Related commands: DISCONNECT Ctrl/Y (SET,SHOW,CANCEL) TRACEB Using the CONNECT Command to Debu g the OpenVMS Operating System% (Alpha and Integrity servers only)> You can use the CONNECT command to debug Alpha or Integrity= servers operating system code with the OpenVMS System CodeC Debugger (SCD). This capability requires two systems, one called@ the host and the other called the target. The host and target@ must be running the same operating system (Alpha or IntegrityA servers). The host is configured as a standard OpenVMS system,C from which you run the debugger using DEBUG/KEEP, then enter theD CONNECT command. The target is a standalone system that is bootedD in a special way that enables SCD. Communication between the host3 and the target occurs over the Ethernet network.< For complete information on using the OpenVMS System Code> Debugger, see the VSI OpenVMS System Analysis Tools Manual. 3 Examples 1.DBG_1> CONNECTB This command brings under debugger control any processes that1 are waiting to be connected to the debugger. 2.DBG_1> CONNECT JONES_3A This command interrupts the image running in process JONES_3B and brings the process under debugger control. Process JONES_@ 3 must be in the same UIC group as the process in which theD debugger was started. Also, the image must not have been linked% with the /NOTRACEBACK qualifier.< 3.DBG> CONNECT %NODE_NAME SCDTST /PASSWORD="eager_beaver"< %DEBUG-I-NOLOCALS, image does not contain local symbols DBG>>   This CONNECT command brings the target system running theB OpenVMS operating system under debugger control. This exampleC specifies that the target system has a node name of SCDTST and a password of eager_beaver. 2 Ctrl_CB When entered from within a debugging session, Ctrl/C aborts theB execution of a debugger command or interrupts program execution. without interrupting the debugging session.& NOTE8 Do not use Ctrl/Y fr!om within a debugging session. Format  3 DescriptionC Pressing Ctrl/C enables you to abort the execution of a debuggerA command or to interrupt program execution without interrupting? the debugging session. This is useful when, for example, the= program is executing an infinite loop that does not have aA breakpoint, or you want to abort a debugger command that takesB a long time to complete. The debugger prompt is then displayed,+ so that you c "an enter debugger commands.D If your program already has a Ctrl/C AST service routine enabled,? use the SET ABORT_KEY command to assign the debugger's abortB function to another Ctrl-key sequence. Note, however, that manyC Ctrl-key sequences have predefined functions, and the SET ABORT_@ KEY command enables you to override such definitions (see theC OpenVMS User's Manual). Some of the Ctrl-key characters not used. by the operating system are G, K, N, and P.= If your pro #gram does not have a Ctrl/C AST service routineB enabled and you assign the debugger's abort function to anotherA Ctrl-key sequence, then Ctrl/C behaves like Ctrl/Y-that is, itA interrupts the debugging session and returns you to DCL level.B Do not use Ctrl/Y from within a debugging session. Instead, useD either Ctrl/C or an equivalent Ctrl-key sequence established with the SET ABORT_KEY command.C You can use the SPAWN and ATTACH commands to leave and return to< a deb$ugging session without losing the debugging context.& NOTE: Pressing Ctrl/C to interrupt a program running under> debugger control works only once. Thereafter, the Ctrl/C; interrupt is ignored. The same is true when using the= DECwindows STOP button; the action is acknowledged only+ the first time the button is pressed. Related commands: ATTACH Ctrl/Y (SET,SHOW) ABORT_KEY SPAWN 3 Example% DBG> GO . . . < DBG> EXAMINE/BYTE 1000:101000 !should have typed 1000:1010 1000: 0 1004: 0 1008: 0 1012: 0 1016: 0 2 %DEBUG-W-ABORTED, command aborted by user request DBG>> This example shows how to use Ctrl/C to interrupt program< execution and then to abort the execution of a debugger command. 2 Ctrl 3 /WB Refreshes the screen in screen mode (like DISPLAY/REFRESH). See the DISPLAY/REFRESH command.& Format  3 /YB When entered from DCL level, Ctrl/Y interrupts an image that isC running without debugger control, enabling you then to start the' debugger with the DCL command DEBUG.& NOTESA Do not use Ctrl/Y from within a debugging session. Instead,@ use Ctrl/C or an equivalent abort-key sequence established% with the SET ABORT_KEY command.A When you start the debugger with the Ctrl/Y-DEBUG se'quence,= you cannot then use the debugger RUN or RERUN commands. Format  4 DescriptionA Pressing Ctrl/Y at DCL level enables you to interrupt an imageA that is running without debugger control, so that you can then1 start the debugger with the DCL command DEBUG.> You can bring an image under debugger control only if, as a? minimum, that image was linked with the /TRACEBACK qualifier4 (/TRACEBACK is the default for the LINK command).D ( When you press Ctrl/Y to interrupt the image's execution, controlA is passed to DCL. If you then enter the DCL command DEBUG, theB interrupted image is brought under control of the debugger. The@ debugger sets its language-dependent parameters to the source@ language of the module in which execution was interrupted andB displays its prompt. You can then determine where execution was. suspended by entering a SHOW CALLS command.B The Ctrl/Y-DEBUG sequence is not supported in the) kept debugger configuration.C The Ctrl/Y-DEBUG sequence is not supported in the VSI DECwindowsA Motif for OpenVMS user interface to the debugger. Instead, use the STOP button.A Within a debugging session, you can use the CONNECT command to? connect an image that is running without debugger control in? another process (of the same job) to that debugging session. Related commands: CONNECT Ctrl/C DEBUG (DCL command) RUN (DCL command*) 4 Examples 1.$ RUN/NODEBUG TEST_B . . .  Interrupt $ DEBUG2 Debugger Banner and Version Number Language: ADA, Module: SWAP DBG>@ In this example, the RUN/NODEBUG command executes the image> TEST_B without debugger control. Execution is interruptedB with Ctrl/Y. The DEBUG command then causes the debugger to beB started. The debugger displays its banner, sets the language-D dependent+ parameters to the language (Ada, in this case) of theC module (SWAP) in which execution was interrupted, and displays the prompt. 2.$ RUN/NODEBUG PROG2 . . .  Interrupt $ DEBUG2 Debugger Banner and Version Number$ Language: FORTRAN, Module: SUB4I predefined trace on activation at SUB4\%LINE 12 in %PROCESS_NUMBER 1 DBG>: In this example, the DEFINE/JOB command establishes aB multiprocess debu,gging configuration. The RUN/NODEBUG commandC executes the image PROG2 without debugger control. The Ctrl/Y-A DEBUG sequence interrupts execution and starts the debugger.? The banner indicates that a new debugging session has beenA started. The activation tracepoint indicates where executionC was interrupted when the debugger took control of the process. 3 /Z> Ends a debugging session (like EXIT). See the EXIT command. Format  2 - DEACTIVATE 3 BREAK: Deactivates a breakpoint, which you can later activate. Format5 DEACTIVATE BREAK [address-expression[, . . . ]] 4 Parameters address-expressionD Specifies a breakpoint to be deactivated. Do not use the asteriskC (*) wildcard character. Instead, use the /ALL qualifier. Do notA specify an address expression when using any qualifiers except! /EVENT, /PREDEFINED, or /USER. 4 Qualifiers /ACTIVATING9 Dea.ctivates a breakpoint established by a previous SET BREAK/ACTIVATING command. /ALLB By default, deactivates all user-defined breakpoints. When used? with /PREDEFINED, deactivates all predefined breakpoints butB no user-defined breakpoints. To deactivate all breakpoints, use /ALL/USER/PREDEFINED. /BRANCH9 Deactivates a breakpoint established by a previous SET BREAK/BRANCH command. /CALLD Deactivates a breakpoint established by a previous SET BR/EAK/CALL command. /EVENT /EVENT=event-name9 Deactivates a breakpoint established by a previous SET> BREAK/EVENT=event-name command. Specify the event name (and@ address expression, if any) exactly as specified with the SET BREAK/EVENT command.B To identify the current event facility and the associated event. names, use the SHOW EVENT_FACILITY command. /EXCEPTION9 Deactivates a breakpoint established by a previous SET BREAK/EXCEPTION comma0nd. /HANDLER9 Deactivates a breakpoint established by a previous SET BREAK/HANDLER command. /INSTRUCTION9 Deactivates a breakpoint established by a previous SET BREAK/INSTRUCTION command. /LINED Deactivates a breakpoint established by a previous SET BREAK/LINE command. /PREDEFINEDB Deactivates a specified predefined breakpoint without affectingA any user-defined breakpoints. When used with /ALL, deactivates all predefined brea1kpoints. /SYSEMULATEB (Alpha only) Deactivates a breakpoint established by a previous SET BREAK/SYSEMULATE command. /TERMINATING9 Deactivates a breakpoint established by a previous SET BREAK/TERMINATING command. /UNALIGNED_DATAB (Alpha only) Deactivates a breakpoint established by a previous$ SET BREAK/UNALIGNED_DATA command. /USERA Deactivates a specified user-defined breakpoint. To deactivate8 all user-defined breakpoints, use the / 2ALL qualifier. 4 Description@ User-defined breakpoints are activated when you set them withA the SET BREAK command. Predefined breakpoints are activated byA default. Use the DEACTIVATE BREAK command to deactivate one or more breakpoints.; If you deactivate a breakpoint, the debugger ignores theA breakpoint during program execution. To activate a deactivatedC breakpoint, use the ACTIVATE BREAK command. You can activate andA deactivate user-defined and predefined 3breakpoints separately.A Activating and deactivating breakpoints enables you to run andC rerun your program with or without breakpoints without having toB cancel and then reset them. By default, the RERUN command savesC the current state of all breakpoints (activated or deactivated).> To check if a breakpoint is deactivated, use the SHOW BREAK command. Related commands: CANCEL ALL RERUN& (SET,SHOW,CANCEL,ACTIVATE) BREAK (SET,SHOW) EVENT_FAC4ILITY 4 Examples' 1.DBG> DEACTIVATE BREAK MAIN\LOOP+10D This command deactivates the user-defined breakpoint set at the% address expression MAIN\LOOP+10. 2.DBG> DEACTIVATE BREAK/ALL; This command deactivates all user-defined breakpoints. 3 TRACE: Deactivates a tracepoint, which you can later activate. Format5 DEACTIVATE TRACE [address-expression[, . . . ]] 4 Parameters address-expressionD Specifies a tracepoint 5to be deactivated. Do not use the asteriskC (*) wildcard character. Instead, use the /ALL qualifier. Do notA specify an address expression when using any qualifiers except! /EVENT, /PREDEFINED, or /USER. 4 Qualifiers /ACTIVATING; Deactivates a tracepoint established with a previous SET TRACE/ACTIVATING command. /ALLB By default, deactivates all user-defined tracepoints. When usedB with /PREDEFINED, it deactivates all predefined tracepoints butB 6 no user-defined tracepoints. To deactivate all tracepoints, use /ALL/USER/PREDEFINED. /BRANCH; Deactivates a tracepoint established with a previous SET TRACE/BRANCH command. /CALL; Deactivates a tracepoint established with a previous SET TRACE/CALL command. /EVENT /EVENT=event-name; Deactivates a tracepoint established with a previous SET> TRACE/EVENT=event-name command. Specify the event name (and@ address expression, if any) exact7ly as specified with the SET TRACE/EVENT command.B To identify the current event facility and the associated event. names, use the SHOW EVENT_FACILITY command. /EXCEPTION; Deactivates a tracepoint established with a previous SET TRACE/EXCEPTION command. /INSTRUCTION; Deactivates a tracepoint established with a previous SET TRACE/INSTRUCTION command. /LINE; Deactivates a tracepoint established with a previous SET TRACE/LINE command. 8 /PREDEFINEDB Deactivates a specified predefined tracepoint without affectingD any user-defined tracepoints. When used with /ALL, it deactivates all predefined tracepoints. /TERMINATING; Deactivates a tracepoint established with a previous SET TRACE/TERMINATING command. /USERD Deactivates a specified user-defined tracepoint without affectingB any predefined tracepoints. When used with /ALL, it deactivatesC all user-defined tracepoints. The /USER qua 9lifier is the default" unless you specify /PREDEFINED. 4 Description@ User-defined tracepoints are activated when you set them withA the SET TRACE command. Predefined tracepoints are activated byA default. Use the DEACTIVATE TRACE command to deactivate one or more tracepoints.; If you deactivate a tracepoint, the debugger ignores theA tracepoint during program execution. To activate a deactivatedC tracepoint, use the ACTIVATE TRACE command. You can activate and:A deactivate user-defined and predefined tracepoints separately.A Activating and deactivating tracepoints enables you to run andC rerun your program with or without tracepoints without having toB cancel and then reset them. By default, the RERUN command savesC the current state of all tracepoints (activated or deactivated).> To check if a tracepoint is deactivated, use the SHOW TRACE command. Related commands: CANCEL ALL RERUN (SET,SHOW) EVENT;_FACILITY& (SET,SHOW,CANCEL,ACTIVATE) TRACE 4 Examples' 1.DBG> DEACTIVATE TRACE MAIN\LOOP+10@ This command deactivates the user-defined tracepoint at the location MAIN\LOOP+10. 2.DBG> DEACTIVATE TRACE/ALL; This command deactivates all user-defined tracepoints. 3 WATCH: Deactivates a watchpoint, which you can later activate. Format5 DEACTIVATE WATCH [address-expression[, . . . ]] 4 Parameters address-expression<< Specifies a watchpoint to be deactivated. With high-level> languages, this is typically the name of a variable. Do notB use the asterisk (*) wildcard character. Instead, use the /ALL= qualifier. Do not specify an address expression with /ALL. 4 Qualifiers /ALL Deactivates all watchpoints. 4 DescriptionA Watchpoints are activated when you set them with the SET WATCHA command. Use the DEACTIVATE WATCH command to deactivate one or more watchpoi =nts.; If you deactivate a watchpoint, the debugger ignores theA watchpoint during program execution. To activate a deactivated= watchpoint, use the ACTIVATE WATCH command. Activating and= deactivating watchpoints enables you to run and rerun your? program with or without watchpoints without having to cancel and then reset them.? By default, the RERUN command saves the current state of all> static watchpoints (activated or deactivated). The state of@ a particular >nonstatic watchpoint might or might not be savedC depending on the scope of the variable being watched relative to4 the main program unit (where execution restarts).> To check if a watchpoint is deactivated, use the SHOW WATCH command. Related commands: CANCEL ALL RERUN& (SET,SHOW,CANCEL,ACTIVATE) WATCH 4 Examples% 1.DBG> DEACTIVATE WATCH SUB2\TOTALA This command deactivates the watchpoint at variable TOTAL in module SUB2.? 2.DBG> DEACTIVATE WATCH/ALL; This command deactivates all watchpoints you have set. 2 DECLARE? Declares a formal parameter within a command procedure. This@ enables you to pass an actual parameter to the procedure when- entering an execute procedure (@) command. Format6 DECLARE p-name:p-kind [,p-name:p-kind[, . . . ]] 3 Parameters p-nameB Specifies a formal parameter (a symbol) that is declared within the command procedure.= D@o not specify a null parameter (represented either by two? consecutive commas or by a comma at the end of the command). p-kind< Specifies the parameter kind of a formal parameter. Valid keywords are as follows:? ADDRESS Specifies that the actual parameter is interpreted5 as an address expression. Same effect as; DEFINE/ADDRESS symbol-name = actual-parameter.3 COMMAND Specifies that the actual parameter is5 interpreted as a co Ammand. Same effect as; DEFINE/COMMAND symbol-name = actual-parameter.D VALUE Specifies that the actual parameter is interpreted as aB value expression in the current language. Same effect< as DEFINE/VALUE symbol-name = actual-parameter. 3 Description@ The DECLARE command is valid only within a command procedure.; The DECLARE command binds one or more actual parameters,@ specified on the command line following the execute procedure@ B (@) command, to formal parameters (symbols) declared within a command procedure.C Each p-name:p-kind pair specified by a DECLARE command binds oneB formal parameter to one actual parameter. Formal parameters are@ bound to actual parameters in the order in which the debugger? processes the parameter declarations. If you specify several> formal parameters on a single DECLARE command, the leftmost? formal parameter is bound to the first actual parameter, theB next formal p Carameter is bound to the second, and so on. If youA use a DECLARE command in a loop, the formal parameter is boundD to the first actual parameter on the first iteration of the loop;D the same formal parameter is bound to the second actual parameter$ on the next iteration, and so on.< Each parameter declaration acts like a DEFINE command: it> associates a formal parameter with an address expression, aD command, or a value expression in the current language, accordingD to the Dparameter kind specified. The formal parameters themselvesC are consistent with those accepted by the DEFINE command and canD in fact be deleted from the symbol table with the DELETE command.? The %PARCNT built-in symbol, which can be used only within a> command procedure, enables you to pass a variable number ofA parameters to a command procedure. The value of %PARCNT is the? number of actual parameters passed to the command procedure. Related commands: @ (ExecuEte Procedure) DEFINE DELETE 3 Examples9 1.! ***** Debugger Command Procedure EXAM_GO.COM *****! DECLARE L:ADDRESS, M:COMMAND EXAMINE L; M DBG> @EXAM_GO X "@DUMP"C In this example, the command procedure EXAM_GO.COM accepts two@ parameters, an address expression (L) and a command stringB (M). The address expression is then examined and the command is executed.D At the debugger prompt, the @EXAM_GO X "@DUMP" command execFutesB EXAM_GO.COM, passing the address expression X and the command string @DUMP.5 2.! ***** Debugger Command Procedure VAR.DBG ***** SET OUTPUT VERIFY: FOR I = 1 TO %PARCNT DO (DECLARE X:VALUE; EVALUATE X) DBG> @VAR.DBG 12,37,45: %DEBUG-I-VERIFYIC, entering command procedure VAR.DBG; FOR I = 1 TO %PARCNT DO (DECLARE X:VALUE; EVALUATE X) 12 37 459 %DEBUG-I-VERIFYIC, exiting command procedure VAR.DBG DBG>= In this e Gxample, the command procedure VAR.DBG accepts a@ variable number of parameters. That number is stored in the built-in symbol %PARCNT.C At the debugger prompt, the @VAR.DBG command executes VAR.DBG,= passing the actual parameters 12, 37, and 45. Therefore,< %PARCNT has the value 3, and the FOR loop is repeated 3@ times. The FOR loop causes the DECLARE command to bind each? of the three actual parameters (starting with 12) to a new@ declaration of X. Each Hactual parameter is interpreted as aA value expression in the current language, and the EVALUATE X! command displays that value. 2 DEFINE@ Assigns a symbolic name to an address expression, command, or value. FormatE DEFINE symbol-name=parameter [,symbol-name=parameter[, . . . ]] 3 Parameters symbol-nameC Specifies a symbolic name to be assigned to an address, command,> or value. The symbolic name can be composed of alphanumeric> I characters and underscores. The debugger converts lowercaseC alphabetic characters to uppercase. The first character must notD be a number. The symbolic name must be no more than 31 characters long. parameter& Depends on the qualifier specified. 3 Qualifiers /ADDRESSA (Default) Specifies that the defined symbol is an abbreviationC for an address expression. In this case, parameter is an address expression. /COMMANDA Specifies that the Jdefined symbol is treated as a new debuggerA command. In this case, parameter is a quoted character string.A This qualifier provides, in simple cases, essentially the same+ capability as the following DCL command: $ symbol := string< To define complex commands, you might need to use command@ procedures with formal parameters. For more information about> declaring parameters to command procedures, see the DECLARE command. /LOCAL= Specifies that the definiKtion is valid only in the command> procedure in which it is defined. The defined symbol is notB visible at debugger command level. By default, a symbol defined@ within a command procedure is visible outside that procedure. /VALUED Specifies that the defined symbol is an abbreviation for a value.B In this case, parameter is a language expression in the current language. 3 Description; The DEFINE/ADDRESS command assigns a symbolic name to anA address expressio Ln in a program. You can define a symbol for aB nonsymbolic program location or for a symbolic program location= having a long path-name prefix. You can then refer to thatB program location with the symbolic name. The /ADDRESS qualifier is the default.A The DEFINE/COMMAND command enables you to define abbreviationsA for debugger commands or even define new commands, either from9 the debugger command level or from command procedures.D The DEFINE/VALUE command enables yo Mu to assign a symbolic name to? a value (or the result of evaluating a language expression).B The DEFINE/LOCAL command confines symbol definitions to command> procedures. By default, defined symbols are global (visible" outside the command procedure).B To enter several DEFINE commands with the same qualifier, firstB use the SET DEFINE command to establish a new default qualifierD (for example, SET DEFINE COMMAND makes subsequent DEFINE commandsD behave like DEFINE/COMMAND) N. You can override the current default> qualifier for a single DEFINE command by specifying another qualifier.B In symbol translation, the debugger searches symbols you define@ during the debugging session first. So if you define a symbolC that already exists in your program, the debugger translates theC symbol according to its defined definition, unless you specify a path-name prefix.A If a symbol is redefined, the previous definition is canceled,A even if you use Od different qualifiers with the DEFINE command.? Definitions created with the DEFINE/ADDRESS and DEFINE/VALUE> commands are available only when the image in whose contextC they were created is the current image. If you use the SET IMAGEB command to establish a new current image, these definitions areA temporarily unavailable. However, definitions created with theB DEFINE/COMMAND and DEFINE/KEY commands are always available for all images.C Use the SHOW SYMBOL/DEFINED cPommand to determine the equivalence value of a symbol.8 Use the DELETE command to cancel a symbol definition. Related commands: DECLARE DELETE SET IMAGE SHOW DEFINE SHOW SYMBOL/DEFINED 3 Examples 1.DBG> DEFINE/VALUE COUNTER=0B DBG> SET TRACE/SILENT R DO (DEFINE/VALUE COUNTER = COUNTER+1)A In this example, the DEFINE/VALUE command assigns a value of> 0 to the symbol COUNTER. The SET TRACE command causes the? Q debugger to increment the value of the symbol COUNTER by 1D whenever address R is encountered. In other words, this example% counts the number of calls to R.* 2.DBG> DEFINE/COMMAND BRE = "SET BREAK"D This command assigns the symbol BRE to the debugger command SET BREAK. 3 /KEY& Assigns a string to a function key.& NOTEC This command is not available in the VSI DECwindows Motif for- OpenVMS user interface to Rthe debugger. Format. DEFINE/KEY key-name "equivalence-string" 4 Parameters key-nameD Specifies a function key to be assigned a string. Valid key names are as follows: Key LK2012 Name Keyboard VT100-type VT52-type- PF1 PF1 PF1 Blue, PF2 PF2 PF2 Red. PF3 PF3 PF3 Black PF4 PF4 PF43 KP0-KP9 Keypad 0-9 Keypad 0-9 KeypaSd 0-9! PERIOD Keypad Keypad% period (.) period (.)' COMMA Keypad comma Keypad comma (,) (,) E1 Find E2 Insert Here E3 Remove E4 Select E5 Prev Screen E6 Next Screen HELP Help DO Do F6-F20 F6-F20 On LK201 keyboards:D o You cannot define keys F1 to F5 or the arrow keys (E7 to E10).B o You can define keys F6 to F14 only if yo Tu have first enteredD the DCL command SET TERMINAL/NOLINE_EDITING. In that case, theA line-editing functions of the left and right arrow keys (E8 and E9) are disabled. equivalence-stringD Specifies the string to be processed when you press the specified@ key. Typically, this is one or more debugger commands. If the? string includes any space or nonalphanumeric characters (forD example, a semicolon separating two commands), enclose the string in quotation Umarks ("). 4 Qualifiers /ECHO /ECHO (default) /NOECHOC Controls whether the command line is displayed after the key has6 been pressed. Do not use /NOECHO with /NOTERMINATE. /IF_STATE& /IF_STATE=(state-name[, . . . ]) /NOIF_STATE (default)B Specifies one or more states to which a key definition applies.< The /IF_STATE qualifier assigns the key definition to the? specified states. You can specify predefined states, such as@V DEFAULT and GOLD, or user-defined states. A state name can beA any appropriate alphanumeric string. The /NOIF_STATE qualifier3 assigns the key definition to the current state. /LOCK_STATE /LOCK_STATE /NOLOCK_STATE (default)B Controls how long the state set by /SET_STATE remains in effect@ after the specified key is pressed. The /LOCK_STATE qualifier; causes the state to remain in effect until it is changed> explicitly (for example, with a SET KEY/STAWTE command). The? /NOLOCK_STATE qualifier causes the state to remain in effectB only until the next terminator character is typed, or until the( next defined function key is pressed. /LOG /LOG (default) /NOLOGB Controls whether a message is displayed indicating that the key? definition has been successfully created. The /LOG qualifier< displays the message. The /NOLOG qualifier suppresses the message. /SET_STATE /SET_STATE=state-nameX /NOSET_STATE (default)C Controls whether pressing the key changes the current key state.A The /SET_STATE qualifier causes the current state to change to? the specified state when you press the key. The /NOSET_STATE: qualifier causes the current state to remain in effect. /TERMINATE /TERMINATE /NOTERMINATE (default)B Controls whether the specified string is terminated (processed)? when the key is pressed. The /TERMINATE qualifier causes theD str Ying to be terminated when the key is pressed. The /NOTERMINATEC qualifier enables you to press other keys before terminating the% string by pressing the Return key. 4 DescriptionC Keypad mode must be enabled (SET MODE KEYPAD) before you can use3 this command. Keypad mode is enabled by default.= The DEFINE/KEY command enables you to assign a string to aB function key, overriding any predefined function that was bound@ to that key. When you then press the key, the deb Zugger enters> the currently associated string into your command line. The9 DEFINE/KEY command is like the DCL command DEFINE/KEY.> For a list of the predefined key functions, see the Keypad_$ Definitions_CI online help topic.A On VT52- and VT100-series terminals, the function keys you canB use include all of the numeric keypad keys. Newer terminals and@ workstations have the LK201 keyboard. On LK201 keyboards, theD function keys you can use include all of the numeric keyp [ad keys,B the nonarrow keys of the editing keypad (Find, Insert Here, and9 so on), and keys F6 to F20 at the top of the keyboard.A A key definition remains in effect until you redefine the key,C enter the DELETE/KEY command for that key, or exit the debugger.B You can include key definitions in a command procedure, such as% your debugger initialization file.@ The /IF_STATE qualifier enables you to increase the number ofB key definitions available on your terminal. The s\ame key can beC assigned any number of definitions as long as each definition is% associated with a different state.> By default, the current key state is the DEFAULT state. The? current state can be changed with the SET KEY/STATE command,B or by pressing a key that causes a state change (a key that was1 defined with DEFINE/KEY/LOCK_STATE/SET_STATE). Related commands: DELETE/KEY (SET,SHOW) KEY 4 Examples 1.DBG> SET KEY/STATE=GOLD7 %DEBU ]G-I-SETKEY, keypad state has been set to GOLD; DBG> DEFINE/KEY/TERMINATE KP9 "SET RADIX/OVERRIDE HEX"3 %DEBUG-I-DEFKEY, GOLD key KP9 has been defined= In this example, the SET KEY command establishes GOLD as> the current key state. The DEFINE/KEY command assigns theA SET RADIX/OVERRIDE HEX command to keypad key 9 (KP9) for theB current state (GOLD). The command is processed when you press the key.9 2.DBG> DEFINE/KEY/IF_STATE=BLUE KP9 "SET BREAK %LINE " ^3 %DEBUG-I-DEFKEY, BLUE key KP9 has been definedD This command assigns the unterminated command string "SET BREAKD %LINE" to keypad key 9 for the BLUE state. After pressing BLUE-C KP9, you can enter a line number and then press the Return key4 to terminate and process the SET BREAK command. 3.DBG> SET KEY/STATE=DEFAULT: %DEBUG-I-SETKEY, keypad state has been set to DEFAULT4 DBG> DEFINE/KEY/SET_STATE=RED/LOCK_STATE F12 ""6 %DEBUG-I-DEFKEY, DEFAULT key _F12 has been defined@ In this example, the SET KEY command establishes DEFAULT as@ the current state. The DEFINE/KEY command makes the F12 key> (on an LK201 keyboard) a state key. Pressing F12 while inB the DEFAULT state causes the current state to become RED. The@ key definition is not terminated and has no other effect (aA null string is assigned to F12). After pressing F12, you can@ enter "RED" commands by pressing keys that have definitions# associated wi`th the RED state. 3 /PROCESS_SET? Assigns a symbolic name to a list of process specifications. FormatA DEFINE/PROCESS_SET process-set-name =process-spec[, . . . ] 4 Parameters process-set-name@ Specifies a symbolic name to be assigned to a list of processD specifications. The symbolic name can be composed of alphanumeric> characters and underscores. The debugger converts lowercaseC alphabetic characters to uppercase. The first character must anotD be a number. The symbolic name must be no more than 31 characters long. process-specC Specifies a process currently under debugger control. Use any of the following forms:D [%PROCESS_NAME] process- The process name, if that name does notD name contain spaces or lowercase characters.= The process name can include the> asterisk (*) wildcard character.D [%PROCESS_NAME] The b process name, if that name contains@ "process-name " spaces or lowercase characters. YouD can also use apostrophes (') instead of1 quotation marks (").; %PROCESS_PID process_id The process identifier (PID, a1 hexadecimal number).B [%PROCESS_NUMBER] The number assigned to a process when? process-number it comes under debugger control. AA (or %PROC process- newc number is assigned sequentially,A number) starting with 1, to each process. IfB a process is terminated with the EXIT? or QUIT command, the number can be@ assigned again during the debuggingA session. Process numbers appear in a@ SHOW PROCESS display. Processes areC ordered in a circular list so they can dA be indexed with the built-in symbolsA %PREVIOUS_PROCESS and %NEXT_PROCESS.6 process-set-name A symbol defined with theD DEFINE/PROCESS_SET command to represent2 a group of processes.? %NEXT_PROCESS The next process after the visible? process in the debugger's circular* process list.@ %PREVIOUS_P eROCESS The process previous to the visible? process in the debugger's circular* process list.C %VISIBLE_PROCESS The process whose stack, register set,C and images are the current context forA looking up symbols, register values,C routine calls, breakpoints, and so on.D If you do not specify a process, the symbolic name is createdf but contains no process entries. 4 Description? The DEFINE/PROCESS_SET command assigns a symbol to a list of= process specifications. You can then use the symbol in any= command where a list of process specifications is allowed.D The DEFINE/PROCESS_SET command does not verify the existence of aC specified process. This enables you to specify processes that do not yet exist.D To identify a symbol that was defined with the DEFINE/PROCESS_SETC command, use gthe SHOW SYMBOL/DEFINED command. To delete a symbol@ that was defined with the DEFINE/PROCESS_SET command, use the DELETE command. Related commands: DELETE (SET,SHOW) DEFINE SHOW SYMBOL/DEFINED 4 Examples? 1.all> DEFINE/PROCESS_SET SERVERS=FILE_SERVER,NETWORK_SERVER all> SHOW PROCESS SERVERS3 Number Name State Current PC9 * 1 FILE_SERVER step FS_PROG\%LINE 37: 2 NETWORK_SERVER break h NET_PROG\%LINE 24 all>> This DEFINE/PROCESS_SET command assigns the symbolic name= SERVERS to the process set consisting of FILE_SERVER and> NETWORK_SERVER. The SHOW PROCESS SERVERS command displaysB information about the processes that make up the set SERVERS.B 2.all> DEFINE/PROCESS_SET G1=%PROCESS_NUMBER 1,%VISIBLE_PROCESS all> SHOW SYMBOL/DEFINED G1 defined G18 bound to: "%PROCESS_NUMBER 1, %VISIBLE_PROCESS"! was defined /process_ iset all> DELETE G1D This DEFINE/PROCESS_SET command assigns the symbolic name G1 toD the process set consisting of process 1 and the visible processC (process 3). The SHOW SYMBOL/DEFINED G1 command identifies the@ defined symbol G1. The DELETE G1 command deletes the symbol" from the DEFINE symbol table.& 3.all> DEFINE/PROCESS_SET A = B,C,D& all> DEFINE/PROCESS_SET B = E,F,G& all> DEFINE/PROCESS_SET E = I,J,A? %DEBUG-E-NORECSYM, recursive PROCESS_jSET symbol definition$ encountered at or near "A"D This series of DEFINE/PROCESS_SET commands illustrate valid and! invalid uses of the command. 2 DELETEC Deletes a symbol definition that was established with the DEFINE command. Format$ DELETE [symbol-name[, . . . ]] 3 Parameters symbol-name@ Specifies a symbol whose definition is to be deleted from the= DEFINE symbol table. Do not use the asterisk (*) wildcard? chakracter. Instead, use the /ALL qualifier. Do not specify a> symbol name with /ALL. If you use the /LOCAL qualifier, the> symbol specified must have been previously defined with theA DEFINE/LOCAL command. If you do not specify /LOCAL, the symbol> specified must have been previously defined with the DEFINE command without /LOCAL. 3 Qualifiers /ALLB Deletes all global DEFINE definitions. Using /ALL/LOCAL deletesC all local DEFINE definitions associated with the culrrent command5 procedure (but not the global DEFINE definitions). /LOCALB Deletes the (local) definition of the specified symbol from theB current command procedure. The symbol must have been previously) defined with the DEFINE/LOCAL command. 3 Description@ The DELETE command deletes either a global DEFINE symbol or aB local DEFINE symbol. A global DEFINE symbol is defined with the> DEFINE command without the /LOCAL qualifier. A local DEFINE= symbol is definmed in a debugger command procedure with theC DEFINE/LOCAL command, so that its definition is confined to that command procedure. Related commands: DECLARE DEFINE SHOW DEFINE SHOW SYMBOL/DEFINED 3 Examples& 1.DBG> DEFINE X = INARR, Y = OUTARR DBG> DELETE X,YB In this example, the DEFINE command defines X and Y as globalA symbols corresponding to INARR and OUTARR, respectively. TheA DELETE command deletes these two synmbol definitions from the global symbol table. 2.DBG> DELETE/ALL/LOCAL? This command deletes all local symbol definitions from the current command procedure. 3 /KEYD Deletes a key definition that was established with the DEFINE/KEY+ command or, by default, by the debugger.& NOTEC This command is not available in the VSI DECwindows Motif for- OpenVMS user interface to the debugger. Format DELoETE/KEY [key-name] 4 Parameters key-name@ Specifies a key whose definition is to be deleted. Do not use> the asterisk (*) wildcard character. Instead, use the /ALLB qualifier. Do not specify a key name with /ALL. Valid key names are as follows: Key LK2012 Name Keyboard VT100-type VT52-type- PF1 PF1 PF1 Blue, PF2 PF2 PF2 Red. PF3 PF3 PF3 Black PF4 p PF4 PF43 KP0-KP9 Keypad 0-9 Keypad 0-9 Keypad 0-9! PERIOD Keypad Keypad% period (.) period (.)' COMMA Keypad comma Keypad comma (,) (,)Keypad minus (-)\). ENTER Enter ENTER ENTER. ENTER Enter ENTER ENTER E1 Find E2 Insert Here E3 Remove E4 Select E5 Prev Screen E6 Next Screen HELP Helpq DO Do F6-F20 F6-F20 4 Qualifiers /ALL@ Deletes all key definitions in the specified state. If you doD not specify a state, all key definitions in the current state areA deleted. To specify one or more states, use /STATE=state-name. /LOG /LOG (default) /NOLOG> Controls whether a message is displayed indicating that theB specified key definitions have been deleted. The /LOG qualifierD (which is the default) displays the mesrsage. The /NOLOG qualifier suppresses the message. /STATE$ /STATE=(state-name [, . . . ]) /NOSTATE (default)A Selects one or more states for which a key definition is to be@ deleted. The /STATE qualifier deletes key definitions for theC specified states. You can specify predefined key states, such asD DEFAULT and GOLD, or user-defined states. A state name can be anyB appropriate alphanumeric string. The /NOSTATE qualifier deletes1 the key definition for sthe current state only.> By default, the current key state is the DEFAULT state. The? current state can be changed with the SET KEY/STATE command,B or by pressing a key that causes a state change (a key that was1 defined with DEFINE/KEY/LOCK_STATE/SET_STATE). 4 Description= The DELETE/KEY command is like the DCL command DELETE/KEY.C Keypad mode must be enabled (SET MODE KEYPAD) before you can use3 this command. Keypad mode is enabled by default. Related comtmands: DEFINE/KEY (SET,SHOW) KEY 4 Examples 1.DBG> DELETE/KEY KP46 %DEBUG-I-DELKEY, DEFAULT key KP4 has been deletedA This command deletes the key definition for KP4 in the state= last set by the SET KEY command (by default, this is the DEFAULT state).+ 2.DBG> DELETE/KEY/STATE=(BLUE,RED) COMMA5 %DEBUG-I-DELKEY, BLUE key COMMA has been deleted4 %DEBUG-I-DELKEY, RED key COMMA has been deletedA This command deletes the key deufinition for the COMMA key in the BLUE and RED states. 2 DEPOSITD Changes the value of a program variable. More generally, deposits@ a new value at the location denoted by an address expression. Format6 DEPOSIT address-expression = language-expression 3 Parameters address-expression> Specifies the location into which the value of the languageA expression is to be deposited. With high-level languages, thisB is typically the name of a vari vable and can include a path name? to specify the variable uniquely. More generally, an address@ expression can also be a memory address or a register and canB be composed of numbers (offsets) and symbols, as well as one orA more operators, operands, or delimiters. For information aboutA the debugger symbols for the registers and about the operatorsC you can use in address expressions, see the Built_in_Symbols and# Address_Expressions help topics.D You cannot specify an e wntire aggregate variable (a composite dataD structure such as an array or a record). To specify an individual@ array element or a record component, follow the syntax of the current language. language-expressionD Specifies the value to be deposited. You can specify any language= expression that is valid in the current language. For most< languages, the expression can include the names of simple< (noncomposite, single-valued) variables but not the names= of aggregate xvariables (such as arrays or records). If the@ expression contains symbols with different compiler-generated@ types, the debugger uses the rules of the current language to evaluate the expression.? If the expression is an ASCII string or an assembly-language> instruction, you must enclose it in quotation marks (") or= apostrophes ('). If the string contains quotation marks or> apostrophes, use the other delimiter to enclose the string.@ If the string has more characteyrs (1-byte ASCII) than can fit? into the program location denoted by the address expression,A the debugger truncates the extra characters from the right. IfC the string has fewer characters, the debugger pads the remainingA characters to the right of the string by inserting ASCII space characters. 3 Qualifiers /ASCIC /ASCIC /ACC Deposits a counted ASCII string into the specified location. YouC must specify a quoted string on the right-hand zside of the equalA sign. The deposited string is preceded by a 1-byte count field' that gives the length of the string. /ASCID /ASCID /AD> Deposits an ASCII string into the address given by a stringA descriptor that is at the specified location. You must specify@ a quoted string on the right-hand side of the equal sign. The> specified location must contain a string descriptor. If theA string lengths do not match, the string is either truncated on: { the right or padded with space characters on the right. /ASCII /ASCII:nC Deposits n bytes of an ASCII string into the specified location.A You must specify a quoted string on the right-hand side of theA equal sign. If its length is not n, the string is truncated or@ padded with space characters on the right. If you omit n, theD actual length of the data item at the specified location is used. /ASCIW /ASCIW /AWC Deposits a counted ASCII |string into the specified location. YouC must specify a quoted string on the right-hand side of the equalA sign. The deposited string is preceded by a 2-byte count field' that gives the length of the string. /ASCIZ /ASCIZ /AZ= Deposits a zero-terminated ASCII string into the specified? location. You must specify a quoted string on the right-handB side of the equal sign. The deposited string is terminated by a2 zero byte that indicates the end of the} string. /BYTE9 Deposits a 1-byte integer into the specified location. /D_FLOATC Converts the expression on the right-hand side of the equal signB to the D_floating type (length 8 bytes) and deposits the result into the specified location. /DATE_TIME? Converts a string representing a date and time (for example,? 21-DEC-1988 21:08:47.15) to the internal format for date andC time and deposits that value (length 8 bytes) into the specified? locat~ion. Specify an absolute date and time in the following format:! [dd-mmm-yyyy[:]] [hh:mm:ss.cc] /EXTENDED_FLOAT /EXTENDED_FLOAT /X_FLOATA (Alpha only) Converts the expression on the right-hand side ofC the equal sign to the IEEE X_floating type (length 16 bytes) and3 deposits the result into the specified location. /FLOATA On Alpha processors, converts the expression on the right-hand= side of the equal sign to the IEEE T_floating type (double> precision, length 8 bytes) and deposits the result into the specified location. /G_FLOATC Converts the expression on the right-hand side of the equal signB to the G_floating type (length 8 bytes) and deposits the result into the specified location. /LONG_FLOAT /LONG_FLOAT /S_FLOAT@ (Alpha and Integrity servers only) Converts the expression onD the right-hand side of the equal sign to the IEEE S_floating typeB (single precision€, length 4 bytes) and deposits the result into the specified location. /LONG_LONG_FLOAT@ (Alpha and Integrity servers only) Converts the expression onD the right-hand side of the equal sign to the IEEE T_floating typeB (double precision, length 8 bytes) and deposits the result into the specified location. /LONGWORDB Deposits a longword integer (length 4 bytes) into the specified location. /OCTAWORDD Deposits an octaword integer (length 16 bytes) into the specified location. /PACKED /PACKED:nC Converts the expression on the right-hand side of the equal sign@ to a packed decimal representation and deposits the resultingB value into the specified location. The value of n is the number> of decimal digits. Each digit occupies one nibble (4 bits). /QUADWORDB Deposits a quadword integer (length 8 bytes) into the specified location. /TASKC Applies to tasking (multithread) programs. De‚posits a task value@ (a task name or a task ID such as %TASK 3) into the specified< location. The deposited value must be a valid task value. /TYPE /TYPE=(name)A Converts the expression to be deposited to the type denoted byC name (which must be the name of a variable or data type declared> in the program), then deposits the resulting value into theB specified location. This enables you to specify a user-declared= type. You must use parentheses around the typƒe expression. /WCHAR_T /WCHAR_T[:n]; Deposits up to n longwords (n characters) of a converted@ multibyte file code sequence into the specified location. TheA default is 1 longword. You must specify a string on the right- hand side of the equal sign.> When converting the specified string, the debugger uses theA locale database of the process in which the debugger runs. The default is C locale. /WORD> Deposits a word integer (length 2 bytes) „into the specified location. 3 Description@ You can use the DEPOSIT command to change the contents of anyB memory location or register that is accessible in your program.D For high-level languages the command is used mostly to change theD value of a variable (an integer, real, string, array, record, and so on).> The DEPOSIT command is like an assignment statement in mostB programming languages. The value of the expression specified toC the right of the equal sign … is assigned to the variable or other@ location specified to the left of the equal sign. For Ada andA Pascal, you can use ":=" instead of "=" in the command syntax.B The debugger recognizes the compiler-generated types associated@ with symbolic address expressions (symbolic names declared inD your program). Symbolic address expressions include the following entities:A o Variable names. When specifying a variable with the DEPOSITC command, use the same syntax that is† used in the source code.. o Routine names, labels, and line numbers.C In general, when you enter a DEPOSIT command, the debugger takes the following actions:B o It evaluates the address expression specified to the left of2 the equal sign, to yield a program location.? o If the program location has a symbolic name, the debuggerB associates the location with the symbol's compiler-generated? type. If the location does not have a symbolic name (and,D ‡ therefore, no associated compiler-generated type) the debugger? associates the location with the type longword integer byC default. This means that, by default, you can deposit integer= values that do not exceed 4 bytes into these locations.D o It evaluates the language expression specified to the right ofB the equal sign, in the syntax of the current language and inB the current radix, to yield a value. The current language isB the language last establis ˆhed with the SET LANGUAGE command.B By default, if you did not enter a SET LANGUAGE command, theC current language is the language of the module containing the main program.B o It checks that the value and type of the language expression? is consistent with the type of the address expression. IfC you try to deposit a value that is incompatible with the typeA of the address expression, the debugger issues a diagnosticD message. If the value is compa ‰tible, the debugger deposits the@ value into the location denoted by the address expression. 3 Description,_Continued...C The debugger might do type conversion during a deposit operation< if the language rules allow it. For example, a real valueA specified to the right of the equal sign might be converted toA an integer value if it is being deposited into a location with@ an integer type. In general, the debugger tries to follow the- assignment rules for the curren Št language.@ There are several ways of changing the type associated with aD program location so that you can deposit data of a different type into that location:C o To change the default type for all locations that do not haveC a symbolic name, you can specify a new type with the SET TYPE command.C o To change the default type for all locations (both those that@ do and do not have a symbolic name), you can specify a new. type with the SET TYPE/OVERR ‹IDE command.A o To override the type currently associated with a particular@ location for the duration of a single DEPOSIT command, youC can specify a new type by using a qualifier (/ASCII:n, /BYTE, /TYPE=(name), and so on).@ When debugging a C program, or a program in any case-specific@ language, you cannot use the DEPOSIT/TYPE command if the typeC specified is a mixed or lowercase name. For example, suppose the- program has a function like the following:Œ xyzzy_type foo () { xyzzy_type z; z = get_z (); return (z); }C If you try to enter the following command, the debugger issues a5 message that it cannot find the type "xyzzy_type":. DBG> DEPOSIT/TYPE=(xyzzy_type) z="whatever"D The debugger can interpret and display integer data in any one of9 four radixes: binary, decimal, hexadecimal, and octal.C The default radix for both data entry and display is decimal forC most languages. The exceptions are BLISS and MACRO, which have a default radix of hexadecimal.? You can use the SET RADIX and SET RADIX/OVERRIDE commands to change the default radix.? The DEPOSIT command sets the current entity built-in symbolsA %CURLOC and period (.) to the location denoted by the address> expression specified. Logical predecessors (%PREVLOC or theA circumflex character (^)) and successors (%NEXTLOC) are based& on the value of the current entity. Related commands: Ž CANCEL TYPE/OVERRIDE EVALUATE EXAMINE MONITOR (SET,SHOW,CANCEL) RADIX (SET,SHOW) TYPE 3 Examples 1.DBG> DEPOSIT I = 7C This command deposits the value 7 into the integer variable I./ 2.DBG> DEPOSIT WIDTH = CURRENT_WIDTH + 24.80D This command deposits the value of the expression CURRENT_WIDTH* + 24.80 into the real variable WIDTH. 3.DBG> DEPOSIT STATUS = FALSED This command deposits the value FALSE into the Boolean variable STATUS.. 4.DBG> DEPOSIT PART_NUMBER = "WG-7619.3-84"B This command deposits the string WG-7619.3-84 into the string variable PART_NUMBER.* 5.DBG> DEPOSIT EMPLOYEE.ZIPCODE = 02172D This command deposits the value 02172 into component ZIPCODE of record EMPLOYEE. 6.DBG> DEPOSIT ARR(8) = 35 DBG> DEPOSIT ^ = 14B In this example, the first DEPOSIT command deposits the valueC 35 into element 8 of array ARR. As a result, element 8 becomesA the current entity. The second command deposits the value 14A into the logical predecessor of element 8, namely element 7.0 7.DBG> FOR I = 1 TO 4 DO (DEPOSIT ARR(I) = 0)D This command deposits the value 0 into elements 1 to 4 of array ARR. 8.DBG> DEPOSIT COLOR = 3< %DEBUG-E-OPTNOTALLOW, operator "DEPOSIT" not allowed on given data type@ The debugger alerts you when you try to deposit data of theD wrong type into a var ‘iable (in this case, if you try to deposit> an integer value into an enumerated type variable). The EB (error) message severity indicates that the debugger does not make the assignment. 9.DBG> DEPOSIT VOLUME = - 100: %DEBUG-I-IVALOUTBNDS, value assigned is out of bounds at or near '-'? The debugger alerts you when you try to deposit an out-of-B bounds value into a variable (in this case a negative value).> The I (informational) message severity ’indicates that the' debugger does make the assignment.3 10DBG> DEPOSIT/OCTAWORD BIGINT = 111222333444555> This command deposits the expression 111222333444555 into< location BIGINT and converts it to an octaword integer./ 11DBG> DEPOSIT/FLOAT BIGFLT = 1.11949*10**35? This command converts 1.11949*10**35 to an F_floating type0 value and deposits it into location BIGFLT. 2 DISABLE 3 ASTD Disables the delivery of asynchronous system traps (AST“s) in your program. Format DISABLE AST 4 Description@ The DISABLE AST command disables the delivery of ASTs in yourC program and thereby prevents interrupts from occurring while theB program is running. If ASTs are delivered while the debugger isD running (processing commands, and so on), they are queued and are5 delivered when control is returned to the program.C The ENABLE AST command reenables the delivery of ASTs, including3 any pending ASTs (A”STs waiting to be delivered).& NOTEA Any call by your program to the $SETAST system service that< enables ASTs overrides a previous DISABLE AST command. Related commands: (ENABLE,SHOW) AST 4 Example DBG> DISABLE AST DBG> SHOW AST ASTs are disabled DBG>B The DISABLE AST command disables the delivery of ASTs in your3 program, as confirmed by the SHOW AST command. 2 DISCONNECTC Releases a proc•ess from debugger control without terminating the process (kept debugger only). Format DISCONNECT process-spec 3 Parameters process-specC Specifies a process currently under debugger control. Use any of the following forms:D [%PROCESS_NAME] process- The process name, if that name does notD name contain spaces or lowercase characters.= The process name can include the> – asterisk (*) wildcard character.D [%PROCESS_NAME] The process name, if that name contains@ "process-name " spaces or lowercase characters. YouD can also use apostrophes (') instead of1 quotation marks (").; %PROCESS_PID process_id The process identifier (PID, a1 hexadecimal number).B [%PROCESS_NUMBER] The number assigned to a process when? process-number — it comes under debugger control. AA (or %PROC process- new number is assigned sequentially,A number) starting with 1, to each process. IfB a process is terminated with the EXIT? or QUIT command, the number can be@ assigned again during the debuggingA session. Process numbers appear in a@ SHOW PROCESS display. Processes are˜C ordered in a circular list so they canA be indexed with the built-in symbolsA %PREVIOUS_PROCESS and %NEXT_PROCESS.6 process-set-name A symbol defined with theD DEFINE/PROCESS_SET command to represent2 a group of processes.? %NEXT_PROCESS The next process after the visible? process in the debugger's ™ circular* process list.@ %PREVIOUS_PROCESS The process previous to the visible? process in the debugger's circular* process list.C %VISIBLE_PROCESS The process whose stack, register set,C and images are the current context forA looking up symbols, register values,C routine calls, breakpoints, and so onš. 3 DescriptionD (Kept debugger only.) The DISCONNECT command releases a specifiedA process from debugger control without terminating the process.= This is useful if, for example, you have brought a runningD program under debugger control with a CONNECT command and you nowB want to release it without terminating the image. (In contrast,@ when you specify a process with the EXIT or QUIT command, the process is terminated.)' CAUTION? › The debugger kernel runs in the same process as the imageB being debugged. If you issue the DISCONNECT command for this? process, you release your process, but the kernel remains activated.@ This activation continues until the program image finishes running.? If you install a new version of the debugger while one orB more disconnected but activated kernels inhabit user programB space, you can experience problems with debugger behavior if3œ you try to reconnect to one of those kernels. Related commands: EXIT QUIT CONNECT 3 Example DBG> DISCONNECT JONES> This command releases process JONES from debugger control% without terminating the process. 2 DISPLAY@ Creates a new screen display or modifies an existing display.& NOTEC This command is not available in the VSI DECwindows Motif for- OpenVMS user interface to the debugger. FormatE DISPLAY display-name [AT window-spec] [display-kind] [, . . . ] 3 Parameters display-name3 Specifies the display to be created or modified.@ If you are creating a new display, specify a name that is not" already used as a display name.C If you are modifying an existing display, you can specify any of the following entities: o A predefined display: SRC OUT PROMPT INST RžEG0 FREG (Alpha and Integrity servers only) IREG; o A display previously created with the DISPLAY command o A display built-in symbol: %CURDISP %CURSCROLL %NEXTDISP %NEXTINST %NEXTOUTPUT %NEXTSCROLL %NEXTSOURCEA You must specify a display unless you use /GENERATE (parameter2 optional), or /REFRESH (parameter not allowed).? You can specify more than one display, each with an optionaŸl) window specification and display kind. window-spec< Specifies the screen window at which the display is to be= positioned. You can specify any of the following entities:= o A predefined window. For example, RH1 (right top half).D o A window definition previously established with the SET WINDOW command.B o A window specification of the form (start-line, line-count[,A start-column, column-count]). The specification can includeB expressions  which can be based on the built-in symbols %PAGE) and %WIDTH (for example, %WIDTH/4).D If you omit the window specification, the screen position depends= on whether you are specifying an existing display or a new display:D o If you are specifying an existing display, the position of the display is not changed.> o If you are specifying a new display, it is positioned atB window H1 or H2, alternating between H1 and H2 each time you create another dis¡play. display-kind= Specifies the display kind. Valid keywords are as follows:@ DO Specifies an automatically updated output@ (command[; . . . ]) display. The commands are executed in the@ order listed each time the debugger gainsB control. Their output forms the contents of@ the display. If you specify more than oneA command, the commands must be separated by" ¢ semicolons.D INSTRUCTION Specifies an instruction display. If selectedB as the current instruction display with theB SELECT/INSTRUCTION command, it displays theA output from subsequent EXAMINE/INSTRUCTION commands.? OUTPUT Specifies an output display. If selected= as the current output display with the= SELECT/OUTPUT comma £nd, it displays any> debugger output that is not directed toB another display. If selected as the currentC input display with the SELECT/INPUT command,C it echoes debugger input. If selected as theB current error display with the SELECT/ERROR? command, it displays debugger diagnostic messages.B REGISTER Specifies an automati ¤cally updated registerD display. The display is updated each time the. debugger gains control.> SOURCE Specifies a source display. If selected= as the current source display with the= SELECT/SOURCE command, it displays theD output from subsequent TYPE or EXAMINE/SOURCE commands.@ SOURCE (command) Specifies an automatically updated source? ¥ display. The command specified must be aA TYPE or EXAMINE/SOURCE command. The source@ display is updated each time the debugger% gains control.< You cannot change the display kind of the PROMPT display.C If you omit the display-kind parameter, the display kind depends= on whether you are specifying an existing display or a new display:A o If you specify an existing display, the displa¦y kind is not changed.A o If you specify a new display, an OUTPUT display is created. 3 Qualifiers /CLEAR@ Erases the entire contents of a specified display. Do not use@ this qualifier with /GENERATE or when creating a new display. /DYNAMIC /DYNAMIC (default) /NODYNAMIC> Controls whether a display automatically adjusts its window? dimensions proportionally when the screen height or width is@ changed by a SET TERMINAL command. By § default (/DYNAMIC), all? user-defined and predefined displays adjust their dimensions automatically. /GENERATE8 Regenerates the contents of a specified display. OnlyB automatically generated displays are regenerated. These includeB DO displays, register displays, source (cmd-list) displays, and> instruction (cmd-list) displays. The debugger automaticallyA regenerates all these kinds of displays before each prompt. IfC you do not specify a display, it regenerates ¨the contents of allC automatically generated displays. Do not use this qualifier with) /CLEAR or when creating a new display. /HIDE: Places a specified display at the bottom of the display? pasteboard (same as /PUSH). This hides the specified display> behind any other displays that share the same region of the. screen. You cannot hide the PROMPT display. /MARK_CHANGE /MARK_CHANGE /NOMARK_CHANGE (default)C Controls whether the lines that chang ©e in a DO display each timeB it is automatically updated are marked. Not applicable to other kinds of displays.> When you use /MARK_CHANGE, any lines in which some contents? have changed since the last time the display was updated are? highlighted in reverse video. This qualifier is particularlyA useful when you want any variables in an automatically updated. display to be highlighted when they change.B The /NOMARK_CHANGE qualifier (default) specifies that any linesBª that change in DO displays are not to be marked. This qualifierA cancels the effect of a previous /MARK_CHANGE on the specified display. /POP /POP (default) /NOPOPC Controls whether a specified display is placed at the top of theA display pasteboard, ahead of any other displays but behind theB PROMPT display. By default (/POP), the display is placed at theD top of the pasteboard and hides any other displays that share the8 same region of the screen«, except the PROMPT display.B The /NOPOP qualifier preserves the order of all displays on the pasteboard (same as /NOPUSH). /PROCESS /PROCESS[=(process-spec)] /NOPROCESS (default)@ Used only when debugging multiprocess programs (kept debuggerD only). Controls whether the specified display is process specificD (that is, whether the specified display is associated only with aB particular process). The contents of a process-specific displayA are generated ¬ and modified in the context of that process. YouD can make any display process specific, except the PROMPT display.= The /PROCESS=(process-spec) qualifier causes the specified@ display to be associated with the specified process. You mustA include the parentheses. Use any of the following process-spec forms:D [%PROCESS_NAME] proc- The process name, if that name containsB name no space or lowercase characters. TheB pro ­cess name can include the asterisk5 (*) wildcard character.D [%PROCESS_NAME] "proc- The process name, if that name containsC name" space or lowercase characters. You can@ also use apostrophes (') instead of1 quotation marks (").; %PROCESS_PID proc-id The process identifier (PID, a1 hexadecimal number).B %PROCESS_NUMBER proc- The number as ®signed to a process when= number it comes under debugger control.= (or %PROC proc-number) Process numbers appear in a SHOW- PROCESS display.6 proc-group-name A symbol defined with the< DEFINE/PROCESS_GROUP command toC represent a group of processes. Do notC specify a recursive symbol definition.B %NEXT_PROCESS The process after ¯ the visible process? in the debugger's circular process" list.@ %PREVIOUS_PROCESS The process previous to the visible? process in the debugger's circular* process list.C %VISIBLE_PROCESS The process whose call stack, registerD set, and images are the current context= for looking up symbols, register@ ° values, routine calls, breakpoints,' and so on.< The /PROCESS qualifier causes the specified display to be@ associated with the process that was the visible process when, the DISPLAY/PROCESS command was executed.= The /NOPROCESS qualifier (which is the default) causes the? specified display to be associated with the visible process,/ which might change during program execution.? If you do not specify /PROCESS, the c±urrent process-specific@ behavior (if any) of the specified display remains unchanged. /PUSH /PUSH /NOPUSH@ The /PUSH qualifier has the same effect as /HIDE. The /NOPUSHB qualifier preserves the order of all displays on the pasteboard (same as /NOPOP). /REFRESH< Refreshes the terminal screen. Do not specify any command= parameters with this qualifier. You can also use Ctrl/W to refresh the screen. /REMOVEB Marks the display as ²being removed from the display pasteboard,A so it is not shown on the screen unless you explicitly requestA it with another DISPLAY command. Although a removed display isB not visible on the screen, it still exists and its contents are3 preserved. You cannot remove the PROMPT display. /SIZE /SIZE:n@ Sets the maximum size of a display to n lines. If more than nA lines are written to the display, the oldest lines are lost asC the new lines are added. If you o ³mit this qualifier, the maximum% size of the display is as follows:= o If you specify an existing display, the maximum size is unchanged.B o If you are creating a display, the default size is 64 lines.B For an output or DO display, /SIZE:n specifies that the displayA should hold the n most recent lines of output. For a source orC instruction display, n gives the number of source lines or linesA of instructions that can be placed in the memory buffer at any> ´ one time. However, you can scroll a source display over theC entire source code of the module whose code is displayed (sourceA lines are paged into the buffer as needed). Similarly, you can@ scroll an instruction display over all of the instructions ofA the routine whose instructions are displayed (instructions are% decoded from the image as needed). 3 DescriptionC You can use the DISPLAY command to create a display or to modify an existing display.B To create µ a display, specify a name that is not already used asC a display name (the SHOW DISPLAY command identifies all existing displays).@ By default, the DISPLAY command places a specified display onA top of the display pasteboard, ahead of any other displays butC behind the PROMPT display, which cannot be hidden. The specified@ display thus hides the portions of other displays (except the< PROMPT display) that share the same region of the screen.@ For a list of the key def¶initions associated with the DISPLAYC command, type Help Keypad_Definitions_CI. Also, use the SHOW KEY4 command to determine the current key definitions. Related commands: Ctrl/W EXPAND MOVE SET PROMPT (SET,SHOW) TERMINAL (SET,SHOW,CANCEL) WINDOW SELECT (SHOW,CANCEL) DISPLAY 3 Examples 1.DBG> DISPLAY REGD This command shows the predefined register display, REG, at its current window location. 2·.DBG> DISPLAY/PUSH INSTB This command pushes display INST to the bottom of the display+ pasteboard, behind all other displays. 3.DBG> DISPLAY NEWDISP AT RT2 DBG> SELECT/INPUT NEWDISP@ In this example, the DISPLAY command shows the user-definedA display NEWDISP at the right middle third of the screen. The> SELECT/INPUT command selects NEWDISP as the current input0 display. NEWDISP now echoes debugger input. 4.DBG> DISPLAY DISP2 AT RS45 DBG> ¸SELECT/OUTPUT DISP2A In this example, the DISPLAY command creates a display namedD DISP2 essentially at the right bottom half of the screen, aboveB the PROMPT display, which is located at S6. This is an output? display by default. The SELECT/OUTPUT command then selects) DISP2 as the current output display.' 5.DBG> SET WINDOW TOP AT (1,8,45,30), DBG> DISPLAY NEWINST AT TOP INSTRUCTION DBG> SELECT/INST NEWINSTC In this example, the SET WINDOW comma ¹nd creates a window namedA TOP starting at line 1 and column 45, and extending down forA 8 lines and to the right for 30 columns. The DISPLAY commandA creates an instruction display named NEWINST to be displayed@ through TOP. The SELECT/INST command selects NEWINST as the! current instruction display.- 6.DBG> DISPLAY CALLS AT Q3 DO (SHOW CALLS)@ This command creates a DO display named CALLS at window Q3.? Each time the debugger gains control from the proºgram, theB SHOW CALLS command is executed and the output is displayed in4 display CALLS, replacing any previous contents.4 7.DBG> DISPLAY/MARK EXAM AT Q2 DO (EXAMINE A,B,C)? This command creates a DO display named EXAM at window Q2.B The display shows the current values of variables A, B, and CD whenever the debugger prompts for input. Any changed values are highlighted.% 8.all> DISPLAY/PROCESS OUT_X AT S4= This command makes display OUT_X specific » to the visible; process (process 3) and puts the display at window S4. 2 DUMP# Displays the contents of memory. Format5 DUMP address-expression1 [:address-expression2] 3 Parameters address-expression17 Specifies the first memory location to be displayed. address-expression2A Specifies the last memory location to be displayed (default is address-expression1). 3 Qualifiers /BINARY5 Displays each examined ¼entity as a binary integer. /BYTEC Displays each examined entity as a byte integer (length 1 byte). /DECIMAL6 Displays each examined entity as a decimal integer. /HEXADECIMAL: Displays each examined entity as a hexadecimal integer. /LONGWORD /LONGWORD (default)= Displays each examined entity in the longword integer typeC (length 4 bytes). This is the default type for program locations. that do not have a compiler-generated type. ½/OCTAL5 Displays each examined entity as an octal integer. /QUADWORD= Displays each examined entity in the quadword integer type (length 8 bytes). /WORDC Displays each examined entity in the word integer type (length 2 bytes). 3 Description> The DUMP command displays the contents of memory, includingA registers, variables, and arrays. The DUMP command formats itsC output in a manner similar to the DCL command DUMP. The debugger> DUMP ¾command makes no attempt to interpret the structure of aggregates.D In general, when you enter a DUMP command, the debugger evaluates@ address-expression1 to yield a program location. The debugger? then displays the entity stored at that location as follows:C o If the entity has a symbolic name, the debugger uses the size> of the entity to determine the address range to display.B o If the entity does not have a symbolic name (and, therefore,9 no associated comp¿iler-generated type) the debuggerB displays address-expression1 through address-expression2 (if specified).B In either case, the DUMP command displays the contents of theseC locations as longword (by default) integer values in the current radix.C The default radix for display is decimal for most languages. The@ exceptions are BLISS and MACRO, which have a default radix of hexadecimal.; Use one of the four radix qualifiers (/BINARY, /DECIMAL,B /HEXADE ÀCIMAL, /OCTAL) to display data in another radix. You canC also use the SET RADIX and SET RADIX/OVERRIDE commands to change the default radix.; Use one of the size qualifiers (/BYTE, /WORD, /LONGWORD,2 /QUADWORD) to change the format of the display.D The DUMP command sets the current entity built-in symbols %CURLOCC and period (.) to the location denoted by the address expression> specified. Logical predecessors (%PREVLOC or the circumflexB character (^)) and successorsÁ (%NEXTLOC) are based on the value of the current entity. Related command: EXAMINE 3 Examples 1.DBG> DUMP/QUAD R16:R25= 0000000000000078 0000000000030038 8.......x....... %R16= 000000202020786B 0000000000030041 A.......kx ... %R18= 0000000000030140 0000000000007800 .x......@....... %R20= 0000000000010038 0000000000000007 ........8....... %R22= 0000000000000006 0000000000000000 ................ %R24 DBG>? This Âcommand displays general registers R16 through R25 in+ quadword format and hexadecimal radix.' 2.DBG> DUMP/BYTE/DECIMAL 30000:30040G 0 0 0 0 0 3 0 -80 °....... 0000000000030000G 0 0 0 0 0 3 1 64 @....... 0000000000030008G 0 0 0 0 0 3 0 48 0....... 0000000000030010G 0 0 0 0 0 3 0 56 8....... 0000000000030018G 0 0 0 0 0 3 0 -64 À....... 0000000Ã000030020G 0 0 0 0 0 3 0 -80 °....... 0000000000030028G 0 0 0 0 0 0 7 -50 Î....... 0000000000030030G 101 101 119 32 116 120 101 110 next wee 0000000000030038G 107 k 0000000000030040 DBG>@ This command displays locations 30000 through 30040 in byte format and decimal radix. 2 EDITD Starts the editor established with the SET EDITOR command. If youDÄ did not enter a SET EDITOR command, starts the Language-Sensitive< Editor (LSE), if that editor is installed on your system. Format' EDIT [[module-name\] line-number] 3 Parameters module-name> Specifies the name of the module whose source file is to be@ edited. If you specify a module name, you must also specify aA line number. If you omit the module name parameter, the sourceB file whose code appears in the current source display is chosen forÅ editing. line-numberA A positive integer that specifies the source line on which theC editor's cursor is initially placed. If you omit this parameter,D the cursor is initially positioned at the beginning of the sourceB line that is centered in the debugger's current source display,C or at the beginning of line 1 if the editor was set to /NOSTART_) POSITION (see the SET EDITOR command.) 3 Qualifiers /EXIT /EXIT /NOEXIT (default)C Æ Controls whether you end the debugging session prior to starting= the editor. If you specify /EXIT, the debugging session is< terminated and the editor is then started. If you specifyA /NOEXIT, the editing session is started and you return to your; debugging session after terminating the editing session. 3 DescriptionC If you have not specified an editor with the SET EDITOR command,A the EDIT command starts the Language-Sensitive Editor (LSE) inA a spawned subproces Çs (if LSE is installed on your system). TheB typical (default) way to use the EDIT command is not to specify@ any parameters. In this case, the editing cursor is initiallyB positioned at the beginning of the line that is centered in theA currently selected debugger source display (the current source display).A The SET EDITOR command provides options for starting differentC editors, either in a subprocess or through a callable interface. Related commands: (SETÈ,SHOW) EDITOR (SET,SHOW,CANCEL) SOURCE 3 Examples 1.DBG> EDITA This command spawns the Language-Sensitive Editor (LSE) in aA subprocess to edit the source file whose code appears in theD current source display. The editing cursor is positioned at theC beginning of the line that was centered in the source display. 2.DBG> EDIT SWAP\12A This command spawns the Language-Sensitive Editor (LSE) in aC subprocess to edit the source file contai Éning the module SWAP.@ The editing cursor is positioned at the beginning of source line 12.! 3.DBG> SET EDITOR/CALLABLE_EDT DBG> EDIT9 In this example, the SET EDITOR/CALLABLE_EDT command> establishes that EDT is the default editor and is started= through its callable interface (rather than spawned in a@ subprocess). The EDIT command starts EDT to edit the source? file whose code appears in the current source display. TheD editing cursor is pÊositioned at the beginning of source line 1,D because the default qualifier /NOSTART_POSITION applies to EDT. 2 ENABLE 3 ASTC Enables the delivery of asynchronous system traps (ASTs) in your program. Format ENABLE AST 4 DescriptionA The ENABLE AST command enables the delivery of ASTs while your? program is running, including any pending ASTs (ASTs waiting@ to be delivered). If ASTs are delivered while the debugger isD running (procesËsing commands, and so on), they are queued and areA delivered when control is returned to the program. Delivery of8 ASTs in your program is initially enabled by default.& NOTEA Any call by your program to the $SETAST system service that< disables ASTs overrides a previous ENABLE AST command. Related commands: (DISABLE,SHOW) AST 4 Example DBG> ENABLE AST DBG> SHOW AST ASTs are enabled DBG>@ The ENABLE ASÌT command enables the delivery of ASTs in your5 program, as confirmed with the SHOW AST command. 2 EVALUATE= Displays the value of a language expression in the currentB language (by default, the language of the module containing the main program). Format, EVALUATE language-expression[, . . . ] 3 Parameters language-expression: Specifies any valid expression in the current language. 3 Qualifiers /BINARY: Specifies thaÍt the result be displayed in binary radix. /CONDITION_VALUE> Specifies that the expression be interpreted as a conditionA value (the kind of condition value you would specify using theC condition-handling mechanism). The message text corresponding toC that condition value is then displayed. The specified value must be an integer value. /DECIMAL; Specifies that the result be displayed in decimal radix. /HEXADECIMAL? Specifies that the result be dispÎlayed in hexadecimal radix. /OCTAL9 Specifies that the result be displayed in octal radix. 3 DescriptionB The debugger interprets the expression specified in an EVALUATEB command as a language expression, evaluates it in the syntax ofB the current language and in the current radix, and displays itsD value as a literal (for example, an integer value) in the current language.= The current language is the language last established with@ the SET LANGUAGE comm Ïand. If you did not enter a SET LANGUAGED command, the current language is, by default, the language of the& module containing the main program.= If an expression contains symbols with different compiler-? generated types, the debugger uses the type-conversion rules6 of the current language to evaluate the expression.A The debugger can interpret and display integer data in any one@ of four radixes: binary, decimal, hexadecimal, and octal. TheA current radix is the radix Ðlast established with the SET RADIX command.B If you did not enter a SET RADIX command, the default radix forA both data entry and display is decimal for most languages. The@ exceptions are BLISS and MACRO, which have a default radix of hexadecimal.@ You can use a radix qualifier (/BINARY, /OCTAL, and so on) toA display integer data in another radix. These qualifiers do not@ affect how the debugger interprets the data you specify; they> override the current output Ñ radix, but not the input radix.B The EVALUATE command sets the current value of built-in symbolsC %CURVAL and backslash (\) to the value denoted by the specified expression.< You cannot evaluate a language expression that includes a< function call. For example, if PRODUCT is a function that? multiplies two integers, you cannot use the command EVALUATE; PRODUCT(3,5). If your program assigns the returned value= of a function to a variable, you can examine the resultingÒ; value of that variable. On Alpha processors, the commandD EVALUATE procedure-name displays the procedure descriptor addressA (not the code address) of a specified routine, entry point, or Ada package.D For more information about debugger support for language-specificA operators and constructs, see the Language_Support Help topic. Related commands: EVALUATE/ADDRESS MONITOR (SET,SHOW) LANGUAGE (SET,SHOW,CANCEL) RADIX (SET,SHOW) TYPÓE 3 Examples( 1.DBG> EVALUATE 100.34 * (14.2 + 7.9) 2217.514 DBG>B This command uses the debugger as a calculator by multiplying 100.34 by (14.2 + 7.9). 2.DBG> EVALUATE/OCTAL X 00000001512 DBG>C This command evaluates the symbol X and displays the result in octal radix.& 3.DBG> EVALUATE TOTAL + CURR_AMOUNT 8247.20 DBG>= This command evaluates the sum of the values of two real& variables, TOTAL anÔd CURR_AMOUNT. 4.DBG> DEPOSIT WILLING = TRUE DBG> DEPOSIT ABLE = FALSE# DBG> EVALUATE WILLING AND ABLE False DBG>@ In this example, the EVALUATE command evaluates the logicalD AND of the current values of two Boolean variables, WILLING and ABLE. 5.DBG> EVALUATE COLOR'FIRST RED DBG>B In this Ada example, this command evaluates the first element# of the enumeration type COLOR. 3 /ADDRESS? Evaluates an address exÕpression and displays the result as a% memory address or a register name. Format3 EVALUATE/ADDRESS address-expression[, . . . ] 4 Parameters address-expressionD Specifies an address expression of any valid form (for example, a? routine name, variable name, label, line number, and so on). 4 Qualifiers /BINARY/ Displays the memory address in binary radix. /DECIMAL0 Displays the memory address in decimal radix. /HEXADÖECIMAL4 Displays the memory address in hexadecimal radix. /OCTAL. Displays the memory address in octal radix. 4 DescriptionC The EVALUATE/ADDRESS command enables you to determine the memory= address or register associated with an address expression.D The debugger can interpret and display integer data in any one of9 four radixes: binary, decimal, hexadecimal, and octal.C The default radix for both data entry and display is decimal forC most languages. × The exceptions are BLISS and MACRO, which have a default radix of hexadecimal.@ You can use a radix qualifier (/BINARY, /OCTAL, and so on) toC display address values in another radix. These qualifiers do notD affect how the debugger interprets the data you specify; that is,C they override the current output radix, but not the input radix.? If the value of a variable is currently stored in a registerA instead of memory, the EVALUATE/ADDRESS command identifies the> reg Øister. The radix qualifiers have no effect in that case.@ The EVALUATE/ADDRESS command sets the current entity built-inA symbols %CURLOC and period (.) to the location denoted by the? address expression specified. Logical predecessors (%PREVLOCB or the circumflex character (^)) and successors (%NEXTLOC) are, based on the value of the current entity.C On Alpha processors, the command EVALUATE/ADDRESS procedure-nameC displays the procedure descriptor address (not the code aÙddress)7 of a specified routine, entry point, or Ada package. Related commands: EVALUATE (SET,SHOW,CANCEL) RADIX SHOW SYMBOL/ADDRESS SYMBOLIZEC Routine names in debugger expressions have different meanings on& Integrity server and Alpha systems.D On Alpha systems, the command EVALUATE/ADDRESS RTN-NAME evaluates. to the address of the procedure descriptor. 4 Examples# 1.DBG> EVALUATE/ADDRESS RTN-NAMEC On Integrity server Ú systems, instead of displaying the addressD of the official function descriptor, the debugger just displaysC the code address. For example, on Alpha systems, you can enterD the following command and then set a breakpoint when a variable contains the address, FOO:6 2.DBG> SET BREAK .PC WHEN (.SOME_VARIABLE EQLA FOO)A The breakpoint occurs when the variable contains the addressB of the procedure descriptor. However, when you enter the sameA command on Inte Ûgrity server systems, the breakpoint is neverB reached because, although the user variable might contain theB address of the function descriptor for FOO, the "EQLA FOO" in@ the WHEN clause compares it to the code address for FOO. As@ a result, the user variable never contains the code address? of FOO. However, the first quadword of an Integrity serverD function descriptor contains the code address, you can write it as:7 3.DBG> SET BREAK .PC WHEN (..SOME_VARIAÜBLE EQLA FOO)& NOTE@ On Integrity server systems, you cannot copy the following@ line from your BLISS code: IF .SOME_VARIABLE EQLA FOO THEN do-something;1 4. DBG> EVALUATE/ADDRESS MODNAME\%LINE 110 3942 DBG>D This command displays the memory address denoted by the address" expression MODNAME\%LINE 110.$ 5.DBG> EVALUATE/ADDRESS/HEX A,B,C 000004A4 000004AC 000004A0 DBG>> Ý This command displays the memory addresses denoted by the: address expressions A, B, and C in hexadecimal radix. 6.DBG> EVALUATE/ADDRESS X MOD3\%R1 DBG>> This command indicates that variable X is associated with7 register R1. X is a nonstatic (register) variable. 2 EXAMINE9 Displays the current value of a program variable. MoreD generally, displays the value of the entity denoted by an address expression. FormatB EXAMINE [addressÞ-expression[:address-expression] [, . . . ]] 3 Parameters address-expressionA Specifies an entity to be examined. With high-level languages,B this is typically the name of a variable and can include a pathD name to specify the variable uniquely. More generally, an address@ expression can also be a memory address or a register and canB be composed of numbers (offsets) and symbols, as well as one orA more operators, operands, or delimiters. For information aboutA ß the debugger symbols for the registers and about the operatorsD you can use in address expressions, type Help Built_in_Symbols or Help Address_Expressions.@ If you specify the name of an aggregate variable (a compositeD data structure such as an array or record structure) the debuggerA displays the values of all elements. For an array, the displayC shows the subscript (index) and value of each array element. For@ a record, the display shows the name and value of each record à component.A To specify an individual array element, array slice, or record8 component, follow the syntax of the current language.? If you specify a range of entities, the value of the address= expression that denotes the first entity in the range must@ be less than the value of the address expression that denotesA the last entity in the range. The debugger displays the entityC specified by the first address expression, the logical successorA of that address expreássion, the next logical successor, and soA on, until it displays the entity specified by the last addressD expression. You can specify a list of ranges by separating ranges with a comma.: For information specific to vector registers and vectorD instructions, see /TMASK, /FMASK, /VMR, and /OPERANDS qualifiers. 3 Qualifiers /ASCIC /ASCIC /AC< Interprets each examined entity as a counted ASCII string@ preceded by a 1-byte count field that givesâ the length of the( string. The string is then displayed. /ASCID /ASCID /AD= Interprets each examined entity as the address of a string> descriptor pointing to an ASCII string. The CLASS and DTYPE? fields of the descriptor are not checked, but the LENGTH andA POINTER fields provide the character length and address of the. ASCII string. The string is then displayed. /ASCII /ASCII:nB Interprets and displays each examined entity as an ASãCII string@ of length n bytes (n characters). If you omit n, the debugger> attempts to determine a length from the type of the address expression. /ASCIW /ASCIW /AW< Interprets each examined entity as a counted ASCII string@ preceded by a 2-byte count field that gives the length of the( string. The string is then displayed. /ASCIZ /ASCIZ /AZ= Interprets each examined entity as a zero-terminated ASCII@ string. The ending zeroä byte indicates the end of the string. The string is then displayed. /BINARY5 Displays each examined entity as a binary integer. /BYTEC Displays each examined entity in the byte integer type (length 1 byte). /CONDITION_VALUE> Interprets each examined entity as a condition-value return> status and displays the message associated with that return status. /D_FLOATA Displays each examined entity in the D_floating type (length 8 byteså). /DATE_TIMEB Interprets each examined entity as a quadword integer (length 8B bytes) containing the internal representation of date and time.< Displays the value in the format dd-mmm-yyyy hh:mm:ss.cc. /DECIMAL6 Displays each examined entity as a decimal integer. /DEFAULT6 Displays each examined entity in the default radix.% The minimum abbreviation is /DEFA. /DEFINITIONS /DEFINITIONS=nC (Alpha only, Integrity servers when optimized æ code is supported)A When the code is optimized, displays n definition points for a? split-lifetime variable. A definition point is a location in@ the program where the variable could have received its value.B By default, up to five definition points are displayed. If moreA than the given number of definitions (explicit or default) areC available, then the number of additional definitions is reportedB as well. (For more information on split-lifetime variables, see# the VSIç OpenVMS Debugger Manual.% The minimum abbreviation is /DEFI. /EXPAND= Helps to expand complex unions or structures which have anF embedded structure containing a pointer to the top level structure./EXTENDED_FLOAT /EXTENDED_FLOAT /X_FLOATC (Alpha and Integrity servers only) Displays each examined entity1 in the IEEE X_floating type (length 16 bytes). /FLOAT> On VAX processors, same as /F_FLOAT. Displays each examined2 entity in tèhe F_floating type (length 4 bytes).? On Alpha processors, same as T_FLOAT. Displays each examinedA entity in the IEEE T_floating type (double precision, length 8 bytes). /FPCR@ (Alpha only) Displays each examined entity in FPCR (floating-" point control register) format. /G_FLOATA Displays each examined entity in the G_floating type (length 8 bytes). /HEXADECIMAL: Displays each examined entity as a hexadecimal integer. /INSTRUCTIOND é Displays each examined entity as an assembly-language instructionD (variable length, depending on the number of instruction operandsA and the kind of addressing modes used). See also the /OPERANDS qualifier.B In screen mode, the output of an EXAMINE/INSTRUCTION command isA directed at the current instruction display, if any, not at anD output or DO display. The arrow in the instruction display points to the examined instruction.B On Alpha processors, the command EXêAMINE/INSTRUCTION procedure-? name displays the first instruction at the code address of a2 specified routine, entry point, or Ada package. /LINE /LINE (default) /NOLINED Controls whether program locations are displayed in terms of lineA numbers (%LINE x) or as routine-name + byte-offset. By defaultA (/LINE), the debugger symbolizes program locations in terms of line numbers. /LONG_FLOAT /LONG_FLOAT /S_FLOATC (Alpha and Inëtegrity servers only) Displays each examined entityB in the IEEE S_floating type (single precision, length 4 bytes). /LONG_LONG_FLOAT /LONG_LONG_FLOAT /T_FLOATC (Alpha and Integrity servers only) Displays each examined entityB in the IEEE T_floating type (double precision, length 8 bytes). /LONGWORD= Displays each examined entity in the longword integer typeC (length 4 bytes). This is the default type for program locations. that do not have a coìmpiler-generated type. /OCTAL5 Displays each examined entity as an octal integer. /OCTAWORD= Displays each examined entity in the octaword integer type (length 16 bytes). /PACKED /PACKED:nB Interprets each examined entity as a packed decimal number. TheB value of n is the number of decimal digits. Each digit occupies one nibble (4 bits). /PS> (Alpha only) Displays each examined entity in PS (processor status register) formíat. /PSR@ (Integrity servers only) Displays each examined entity in PSR& (processor status register) format. /PSR@ (Integrity servers only) Displays each examined entity in PSR& (processor status register) format. /QUADWORD= Displays each examined entity in the quadword integer type (length 8 bytes). /S_FLOATD (Alpha only) Displays each examined entity in the IEEE S_floating+ type (single precision, length 4 bytes). /SFPCR@ (îAlpha only) Displays each examined entity in SFPCR (software+ floating-point control register) format. /SOURCE& NOTEA This qualifier is not available in the VSI DECwindows Motif1 for OpenVMS user interface to the debugger.A Displays the source line corresponding to the location of eachA examined entity. The examined entity must be associated with aD machine code instruction and, therefore, must be a line number, aB label ï, a routine name, or the memory address of an instruction.= The examined entity cannot be a variable name or any other3 address expression that is associated with data.= In screen mode, the output of an EXAMINE/SOURCE command isC directed at the current source display, if any, not at an output? or DO display. The arrow in the source display points to the@ source line associated with the last entity specified (or the- last one specified in a list of entities).A On Alphða processors, the command EXAMINE/SOURCE procedure-name> displays the source code at the code address of a specified( routine, entry point, or Ada package. /SYMBOLIC /SYMBOLIC (default) /NOSYMBOLICA Controls whether symbolization occurs. By default (/SYMBOLIC),B the debugger symbolizes all addresses, if possible; that is, itA converts numeric addresses into their symbolic representation.D If you specify /NOSYMBOLIC, the debugger suppresses symbolization ñ@ of entities you specify as absolute addresses. If you specify> entities as variable names, symbolization still occurs. The; /NOSYMBOLIC qualifier is useful if you are interested inA identifying numeric addresses rather than their symbolic namesC (if symbolic names exist for those addresses). Using /NOSYMBOLIC@ may speed up command processing because the debugger does not$ need to convert numbers to names. /TASK= Applies to tasking (multithread) programs. Interpreòts eachB examined entity as a task (thread) object and displays the taskD value (the name or task ID) of that task object. When examining aC task object, use /TASK only if the programming language does not" have built-in tasking services. /TYPE /TYPE=(name) /TYPE:(name) /TYPE(name)@ Interprets and displays each examined entity according to theB type specified by name (which must be the name of a variable orB data type declared in the program). Tóhis enables you to specifyA a user-declared type. You must use parentheses around the type expression. /VARIANT2 /VARIANT=variant-selector address-expression8 /VARIANT=(variant-selector,...) address-expression; Enables the debugger to display the correct item when it# encounters an anonymous variant.A In a C program, a union contains members, only one of which isD valid at any one time. When displaying a union, the debugger does, not know which memberô is currently valid.= In a PASCAL program, a record with a variant part contains= variants, only one of which is valid at any one time. WhenC displaying a record with an anonymous variant part, the debuggerC does not know which variant is currently valid, and displays all variants by default.? You can use the /VARIANT qualifier of the EXAMINE command toC select which member of a union (C) or anonymous variant (PASCAL) to display. /WCHAR_T /WCHAR_T[:õn]C Interprets and displays each examined entity as a multibyte fileB code sequence of length n longwords (n characters). The default is 1 longword.D When converting the examined string, the debugger uses the localeB database of the process in which the debugger runs. The default is C locale. /WORDC Displays each examined entity in the word integer type (length 2 bytes). /X_FLOATC (Alpha and Integrity servers only) Displays each examined entity ö1 in the IEEE X_floating type (length 16 bytes). 3 DescriptionB The EXAMINE command displays the entity at the location denotedC by an address expression. You can use the command to display theA contents of any memory location or register that is accessibleA in your program. For high-level languages, the command is used@ mostly to obtain the current value of a variable (an integer,+ real, string, array, record, and so on).D If you are debugging optimized code on ÷Alpha systems, the EXAMINEC command displays the definition points at which a split-lifetimeC variable could have received its value. Split-lifetime variablesD are discussed in the VSI OpenVMS Debugger Manual. By default, theB EXAMINE command displays up to five definition points. With theC /DEFINITIONS qualifier, you can specify the number of definition points.B The debugger recognizes the compiler-generated types associated@ with symbolic address expressions (symbolic n øames declared inD your program). Symbolic address expressions include the following entities:A o Variable names. When specifying a variable with the EXAMINEC command, use the same syntax that is used in the source code.C o Routine names, labels, and line numbers. These are associatedD with instructions. You can examine instructions using the same- techniques as when examining variables.> In general, when you enter an EXAMINE command, the debugger@ evalu ùates the address expression specified to yield a program@ location. The debugger then displays the value stored at that location as follows:C o If the location has a symbolic name, the debugger formats theD value according to the compiler-generated type associated withD that symbol (that is, as a variable of a particular type or as an instruction).D o If the location does not have a symbolic name (and, therefore,A no associated compiler-generated type) theú debugger formatsC the value in the type longword integer by default. This meansD that, by default, the EXAMINE command displays the contents of: these locations as longword (4-byte) integer values. 3 Description,_Continued...> There are several ways of changing the type associated with> a program location so that you can display the data at that# location in another data format:C o To change the default type for all locations that do not haveC a sy ûmbolic name, you can specify a new type with the SET TYPE command.C o To change the default type for all locations (both those that@ do and do not have a symbolic name), you can specify a new. type with the SET TYPE/OVERRIDE command.A o To override the type currently associated with a particularD location for the duration of a single EXAMINE command, you canD specify a new type by using a type qualifier (/ASCII:n, /BYTE,? /TYPE=(name), and so on). Mo üst qualifiers for the EXAMINE" command are type qualifiers.D The debugger can interpret and display integer data in any one of9 four radixes: binary, decimal, hexadecimal, and octal.C The default radix for both data entry and display is decimal forC most languages. The exceptions are BLISS and MACRO, which have a default radix of hexadecimal.D The EXAMINE command has four radix qualifiers (/BINARY, /DECIMAL,C /HEXADECIMAL, /OCTAL) that enable you to display data i ýn another? radix. You can also use the SET RADIX and SET RADIX/OVERRIDE( commands to change the default radix.D In addition to the type and radix qualifiers, the EXAMINE command% has qualifiers for other purposes:? o The /SOURCE qualifier enables you to identify the line of? source code corresponding to a line number, routine name,D label, or any other address expression that is associated with& an instruction rather than data.> o The /[NO]LINE and /[NO þ]SYMBOLIC qualifiers enable you to7 control the symbolization of address expressions.? The EXAMINE command sets the current entity built-in symbolsA %CURLOC and period (.) to the location denoted by the address> expression specified. Logical predecessors (%PREVLOC or theA circumflex character (^)) and successors (%NEXTLOC) are based& on the value of the current entity.= The /VARIANT qualifier enables the debugger to display the8 correct item when it encounters an ÿanonymous variant.A In a C program, a union contains members, only one of which isD valid at any one time. When displaying a union, the debugger doesA not know which member is currently valid. In a PASCAL program,> a record with a variant part contains variants, only one ofC which is valid at any one time. When displaying a record with anC anonymous variant part, the debugger does not know which variant< is currently valid, and displays all variants by default.? You can use the /VARIANT qualifier of the EXAMINE command toB select which member of a union (C program) or anonymous variant9 (PASCAL program) to display. The format is as follows:= DBG> EXAMINE /VARIANT=variant-selector address-expressionD DBG> EXAMINE /VARIANT=(variant-selector,...) address-expression< The variant selector variant-selector specifies a name, aA discriminant (PASCAL only), or a position; that is, one of the following: o NAME = name-string o DISCRIMINANT = expression o POSITION = expression> The /VARIANT qualifier takes a list of zero or more variant; selectors. /VARIANT without any variant selectors is theA default: the first variant of all anonymous variant lists will be displayed.7 Each variant selector specifies either the name, the@ discriminant, or the position of the variant to be displayed.5 The debugger uses the variant selector as follows:A 1. If the debugger encounters an anonymous variable list whileB displaying address-expression, the debugger uses the variant2 selector to choose which variant to display.B 2. Each time the debugger encounters an anonymous variant list,B it attempts to use the next variant selector to choose whichD variant to display. If the variant selector matches one of theA variants of the variant list (union), the debugger displays that variant.B 3. The debugger walks the structure top-to-bottom, depth firs t,7 so that children are encountered before siblings.C 4. If the debugger encounters an anonymous variant list and does@ not have a variant selector to match it with, the debugger! displays the first variant.C 5. If the variant selector does not match any of the variants ofD an anonymous variant list, the debugger displays a single lineD to indicate that. This is similar to what the debugger does ifD the discriminant value fails to match any of the var iants in a0 discriminated variant list. . For example:E [Variant Record omitted - null or illegal Tag Value: 3]C A name specifies a name string. A name matches a variant if that< variant contains a field with the name specified by name.> A discriminant specifies a language expression that must be> type compatible with the tag type of the variant part it is@ meant to match. The discriminant expression matches a variant? if it evaluates to a value in the var iant's case-label list.A Discriminants apply only to Pascal programs, because C and C++$ unions do not have discriminants.? A positional-selector specifies a language expression, which? should evaluate to a integer between 1 and N, where N is theC number of variants in a variant list. A positional-selector thatD evaluates to I specifies that the Ith variant is to be displayed.< You can use asterisk (*) as a wildcard, which matches all) variants of an anonymous variant list.; Each of these variant selectors can be used to match allC variants. In particular, each of the following variant selectorsD indicates that all of the variants of the first anonymous variant list are to be displayed. /VAR=D=* /VAR=N=* /VAR=P=*D The variant selectors can themselves contain a list of selectors.? For example, the following commands all mean the same thing.+ EXAMINE /VARIANT=(DIS=3,DIS=1,DIS=54) x% EXAMINE /VARIANT=(DIS=(3,1,54) ) x# EXAMINE /VARIANT=DIS=(3,1,54) xD You can specify a a single discriminant or position value without? parentheses if the value is a simple decimal integer. To use= a general expression to specify the value, you enclose the@ expression in parentheses. In the following list of commands,9 the first four are legal while the last three are not. EXAMINE /VARIANT=POS=39 EXAMINE /VARIANT=POS=(3) ! parentheses unnecessary9 EXAMINE /VARIANT=(POS=(3)) ! parentheses unnecessary9 EXAMINE /VARIANT=(POS=3) ! parentheses unnecessary7 EXAMINE /VARIANT=(POS=foo) ! parentheses necessary7 EXAMINE /VARIANT=POS=(foo) ! parentheses necessary7 EXAMINE /VARIANT=(POS=3-1) ! parentheses necessary Related Commands: CANCEL TYPE/OVERRIDE DEPOSIT DUMP EVALUATE SET MODE [NO]OPERANDS SET MODE [NO]SYMBOLIC (SET,SHOW,CANCEL) RADIX (SET,SHOW) TYPE 3 Examples 1.DBG> EXAMINE CO UNT SUB2\COUNT: 27 DBG>B This command displays the value of the integer variable COUNT in module SUB2. 2.DBG> EXAMINE PART_NUMBER+ INVENTORY\PART_NUMBER: "LP-3592.6-84" DBG>A This command displays the value of the string variable PART_ NUMBER. 3.DBG> EXAMINE SUB1\ARR3 SUB1\ARR3 (1,1): 27.01000 (1,2): 31.01000 (1,3): 12.48000 (2,1): 15.08000 (2,2): 22.30000  (2,3): 18.73000 DBG>B This command displays the value of all elements in array ARR3D in module SUB1. ARR3 is a 2 by 3 element array of real numbers." 4.DBG> EXAMINE SUB1\ARR3(2,1:3) SUB1\ARR3 (2,1): 15.08000 (2,2): 22.30000 (2,3): 18.73000 DBG>B This command displays the value of the elements in a slice ofB array SUB1\ARR3. The slice includes "columns" 1 to 3 of "row" 2.& 5.DBG> EXAMINE  VALVES.INTAKE.STATUS' MONITOR\VALVES.INTAKE.STATUS: OFF DBG>C This command displays the value of the nested record component, VALVES.INTAKE.STATUS in module MONITOR. 6.DBG> EXAMINE/SOURCE SWAP module MAIN4 47: procedure SWAP(X,Y: in out INTEGER) is DBG>C This command displays the source line in which routine SWAP is- declared (the location of routine SWAP).1 7.DBG> EXAMINE /VARIANT=(NAME=m,DIS=4,POS=1) xA This command specifies that, for the first anonymous variantB list encountered, display the variant part containing a field> named "m", for the second anonymous variant list, display? the part with the discriminant value 4, and, for the third< anonymous variant list, display the first variant part. 8.DBG> ex %r9:%r12' TEST\%R9: 0000000000000000' TEST\%R10: 0000000000000000' TEST\%R11: 0000000000000000' TEST\%SP: 000000007AC8FB70  DBG> ex/bin grnat0 <9,4,0> TEST\%GRNAT0+1: 0110 DBG>C Debugger displays the string "NaT" when the integer register's NaT bit is set.@ 9.Use /EXPAND to EXAMINE certain complex structures as below: typedef struct _A{ int i; struct { int j; int k; struct _A *p; } ST; }A; void main() { A a1,a2; a1.i = 10; a1.ST.j=11; a1.ST.k=12; a1.ST.p=0; a2.i = 210; a2.ST.j=211; a2.ST.k=212; a2.ST.p=&a1; }D The EXAMINE command displays the following output for the above example. DBG> EXAMINE a2 TEST\main\a2 i: 210 ST j: 211 k: 212 p: 2060327712 DBG> EXAMINE *a2.ST.p *TEST\main\a2.ST.p i: 10; ST: 51539607563 [cycle found in type definitions]4 EXAMINE command does not expand the pointer ST.- Similar behavior happens for unions too.> The EXAMINE/EXPAND command displays the following output:! DBG> EXAMINE/EXPAND *a2.ST.p9 %DEBUG-I-EXAMEXPAND, Use examine/expand with caution *TEST\main\a2.ST.p i: 10 ST j: 11 k: 12 p: 0 DBG>H Note: In case of genuine loops in the structure, the EXAMINE/EXPANDI behavior is undefined. The debugger can go into an infinite loop andM in such cases, the use of EXAMINE/EXPAND must be avoided. An example for this case is given below. $ type a.cxx struct B; struct A { B &x; A( B &x ); }; struct B { A y; B(); };! A::A( B &xx ) : x(xx) {} B::B( ) : y( *this ) {} B b; void main() { B b1; A a1(b1); }> The EXAMINE/EXPAND command displays the following output:! DBG> EXAMINE/EXPAND *a2.ST.p9 %DEBUG-I-EXAMEXPAND, Use examine/expand with caution *TEST\main\a2.ST.p i: 10 ST j: 11 k: 12 p: 0 DBG>H Note: In case of genuine loops in the structure, the EXAMINE/EXPANDI behavior is undefined. The debugger can go into an infinite loop andM in such cases, the use of EXAMINE/EXPAND must be avoided. An example for this case is given below. $ type a.cxx struct B; struct A { B &x; A( B &x ); }; struct B { A y; B(); };! A::A( B &xx ) : x(xx) {} B::B( ) : y( *this ) {} B b; void main() { B b1; A a1(b1); } 2 EXITC Ends a debugging session, or terminates one or more processes ofA a multiprocess program, allowing any application-declared exitC handlers to run. If used within a command procedure or DO clauseD and no process is specified, it exits the command procedure or DO clause at that point. Format# EXIT [process-spec[, . . . ]] 3 Parameters process-specC Specifies a process currently under debugger control. Use any of the following forms: D [%PROCESS_NAME] process- The process name, if that name does notD name contain spaces or lowercase characters.= The process name can include the> asterisk (*) wildcard character.D [%PROCESS_NAME] The process name, if that name contains@ "process-name " spaces or lowercase characters. YouD can also use apostrophes (') instead of1  quotation marks (").; %PROCESS_PID process_id The process identifier (PID, a1 hexadecimal number).B [%PROCESS_NUMBER] The number assigned to a process when? process-number it comes under debugger control. AA (or %PROC process- new number is assigned sequentially,A number) starting with 1, to each process. IfB a process is terminated with the EXIT? o r QUIT command, the number can be@ assigned again during the debuggingA session. Process numbers appear in a@ SHOW PROCESS display. Processes areC ordered in a circular list so they canA be indexed with the built-in symbolsA %PREVIOUS_PROCESS and %NEXT_PROCESS.6 process-set-name A symbol defined with theD  DEFINE/PROCESS_SET command to represent2 a group of processes.? %NEXT_PROCESS The next process after the visible? process in the debugger's circular* process list.@ %PREVIOUS_PROCESS The process previous to the visible? process in the debugger's circular* process list.C %VISIBLE_PROCESS The process whose stack, register set,C and images are the current context forA looking up symbols, register values,C routine calls, breakpoints, and so on.C You can also use the asterisk (*) wildcard character to specify all processes. 3 DescriptionD The EXIT command is one of the four debugger commands that can beD used to execute your program (the others are CALL, GO, and STEP). Ending a Debugging Session:< To end a debugging session, enter the EXIT command at theA debugger prompt without specifying any parameters. This causesA orderly termination of the session: the program's application-B declared exit handlers (if any) are executed, the debugger exitC handler is executed (closing log files, restoring the screen andD keypad states, and so on), and control is returned to the commandA interpreter. You cannot then continue to debug your program byC enter ing the DCL command DEBUG or CONTINUE (you must restart the debugger).D Because EXIT runs any application-declared exit handlers, you canA set breakpoints in such exit handlers, and the breakpoints areC triggered upon typing EXIT. Thus, you can use EXIT to debug your exit handlers.> To end a debugging session without running any application-@ declared exit handlers, use the QUIT command instead of EXIT.? Using the EXIT Command in Command Procedures and DO Clauses: : When the debugger executes an EXIT command (without any= parameters) in a command procedure, control returns to the? command stream that invoked the command procedure. A command< stream can be the terminal, an outer (containing) command; procedure, or a DO clause in a command or screen display@ definition. For example, if the command procedure was invokedD from within a DO clause, control returns to that DO clause, where? the debugger executes the next command (if any remain in the command sequence).: When the debugger executes an EXIT command (without any@ parameters) in a DO clause, it ignores any remaining commands* in that clause and displays its prompt. 3 Description,_Continued...# Terminating Specified Processes:> If you are debugging a multiprocess program you can use the? EXIT command to terminate specified processes without endingA the debugging session. The same techniques and behavior apply,D whether you enter  the EXIT command at the prompt or use it within$ a command procedure or DO clause.> To terminate one or more processes, enter the EXIT command,@ specifying these processes as parameters. This causes orderly> termination of the images in these processes, executing anyC application-declared exit handlers associated with these images.A Subsequently, the specified processes are no longer identifiedD in a SHOW PROCESS/ALL display. If any specified processes were onB hold as the  result of a SET PROCESS command, the hold condition is ignored.> When the specified processes begin to exit, any unspecified@ process that is not on hold begins execution. After executionC is started, the way in which it continues depends on whether youA entered a SET MODE [NO]INTERRUPT command. By default (SET MODE? INTERRUPT), execution continues until it is suspended in any@ process. At that point, execution is interrupted in any otherA processes that were executing images, and the debugger prompts for input.D To terminate specified processes without running any application-B declared exit handlers or otherwise starting execution, use the QUIT command instead of EXIT. Related commands: DISCONNECT @ (Execute Procedure) Ctrl/C Ctrl/Y Ctrl/Z QUIT RERUN RUN SET ABORT_KEY SET MODE [NO]INTERRUPT SET PROCESS 3 Examples 1.DBG> EXIT $C Thi s command ends the debugging session and returns you to DCL level.. 2.all> EXIT %NEXT_PROCESS, JONES_3, %PROC 5 all>B This command causes orderly termination of three processes ofB a multiprocess program: the process after the visible processA on the process list, process JONES_3, and process 5. ControlC is returned to the debugger after the specified processes have exited. 2 EXITLOOP; Exits one or more enclosing FOR, REPEAT, or WHILE loops !. Format EXITLOOP [integer] 3 Parameters integerA A decimal integer that specifies the number of nested loops to exit from. The default is 1. 3 Description> Use the EXITLOOP command to exit one or more enclosing FOR, REPEAT, or WHILE loops. Related commands: FOR REPEAT WHILE 3 Example2 DBG> WHILE 1 DO (STEP; IF X .GT. 3 THEN EXITLOOP)B The WHILE 1 command generates an endless loop that executes" aA STEP command with each iteration. After each STEP, the valueA of X is tested. If X is greater than 3, the EXITLOOP command+ terminates the loop (Fortran example). 2 EXPANDD Expands or contracts the window associated with a screen display.& NOTEC This command is not available in the VSI DECwindows Motif for- OpenVMS user interface to the debugger. Format% EXPAND [display-name[, . . . ]] 3 Param#eters display-nameD Specifies a display to be expanded or contracted. You can specify! any of the following entities: o A predefined display: SRC OUT PROMPT INST REG0 FREG (Alpha and Integrity servers only) IREG; o A display previously created with the DISPLAY command o A display built-in symbol: %CURDISP %CURSCROLL %NEXTDISP %NEXTINST %$NEXTOUTPUT %NEXTSCROLL %NEXTSOURCEB If you do not specify a display, the current scrolling display,3 as established by the SELECT command, is chosen. 3 Qualifiers /DOWN /DOWN[:n]B Moves the bottom border of the display down by n lines (if n isD positive) or up by n lines (if n is negative). If you omit n, the" border is moved down by 1 line. /LEFT /LEFT[:n]B Moves the left border of the display to the left by n l%ines (ifC n is positive) or to the right by n lines (if n is negative). If9 you omit n, the border is moved to the left by 1 line. /RIGHT /RIGHT[:n]D Moves the right border of the display to the right by n lines (ifB n is positive) or to the left by n lines (if n is negative). If: you omit n, the border is moved to the right by 1 line. /UP /UP[:n]= Moves the top border of the display up by n lines (if n is? positive) or down by n lines (if &n is negative). If you omit' n, the border is moved up by 1 line. 3 Description+ You must specify at least one qualifier.> The EXPAND command moves one or more display-window borders= according to the qualifiers specified (/UP:[n], /DOWN:[n], RIGHT:[n], /LEFT:[n]).? The EXPAND command does not affect the order of a display on= the display pasteboard. Depending on the relative order ofB displays, the EXPAND command can cause the specified display toC hide 'or uncover another display or be hidden by another display, partially or totally.B Except for the PROMPT display, any display can be contracted to@ the point where it disappears (at which point it is marked asC "removed"). It can then be expanded from that point. ContractingC a display to the point where it disappears causes it to lose anyB attributes that were selected for it. The PROMPT display cannot? be contracted or expanded horizontally but can be contracted% verti (cally to a height of 2 lines.= A window border can be expanded only up to the edge of theD screen. The left and top window borders cannot be expanded beyondA the left and top edges of the display, respectively. The rightA border can be expanded up to 255 columns from the left displayA edge. The bottom border of a source or instruction display canB be expanded down only to the bottom edge of the display (to theB end of the source module or routine's instructions). A register)3 display cannot be expanded beyond its full size.? For a list of the key definitions associated with the EXPANDC command, type Help Keypad_Definitions_CI. Also, use the SHOW KEY4 command to determine the current key definitions. Related commands: DISPLAY MOVE SELECT/SCROLL (SET,SHOW) TERMINAL 3 Examples 1.DBG> EXPAND/RIGHT:6A This command moves the right border of the current scrolling' display to the right by 6 colum*ns." 2.DBG> EXPAND/UP/RIGHT:-12 OUT2D This command moves the top border of display OUT2 up by 1 line,4 and the right border to the left by 12 columns. 3.DBG> EXPAND/DOWN:99 SRCD This command moves the bottom border of display SRC down to the bottom edge of the screen. 2 EXTRACT? Saves the contents of screen displays in a file or creates aC debugger command procedure with all of the commands necessary to/ re-create the current screen state later +on.& NOTEC This command is not available in the VSI DECwindows Motif for- OpenVMS user interface to the debugger. Format2 EXTRACT [display-name[, . . . ]] [file-spec] 3 Parameters display-nameB Specifies a display to be extracted. You can specify any of the following entities: o A predefined display: SRC OUT PROMPT INST REG0 FREG (Alpha and, Integrity servers only) IREG; o A display previously created with the DISPLAY command@ You can use the asterisk (*) wildcard character in a display? name. Do not specify a display name with the /ALL qualifier. file-specB Specifies the file to which the information is written. You can specify a logical name.? If you specify /SCREEN_LAYOUT, the default specification for? the file is SYS$DISK:[]DBGSCREEN.COM. Otherwise, the default) specification- is SYS$DISK:[]DEBUG.TXT. 3 Qualifiers /ALLA Extracts all displays. Do not specify /SCREEN_LAYOUT with this qualifier. /APPEND> Appends the information at the end of the file, rather thanA creating a new file. By default, a new file is created. Do not. specify /SCREEN_LAYOUT with this qualifier. /SCREEN_LAYOUTC Writes a file that contains the debugger commands describing theD current state of the screen. This information includes the scre .enD height and width, message wrap setting, and the position, displayD kind, and display attributes of every existing display. This fileA can then be executed with the execute procedure (@) command toC reconstruct the screen at a later time. Do not specify /ALL with this qualifier. 3 Description= When you use the EXTRACT command to save the contents of aB display into a file, only those lines that are currently stored= in the display's memory buffer (as determined b/y the /SIZE= qualifier on the DISPLAY command) are written to the file.5 You cannot extract the PROMPT display into a file. Related commands: DISPLAY SAVE 3 Examples 1.DBG> EXTRACT SRC? This command writes all the lines in display SRC into file SYS$DISK:[]DEBUG.TXT./ 2.DBG> EXTRACT/APPEND OUT [JONES.WORK]MYFILED This command appends all the lines in display OUT to the end of! file [JONES.WORK]MYFILE.TXT. 3.DBG> EX0TRACT/SCREEN_LAYOUTD This command writes the debugger commands needed to reconstruct3 the screen into file SYS$DISK:[]DBGSCREEN.COM. 2 FORB Executes a sequence of commands while incrementing a variable a specified number of times. Format: FOR name=expression1 TO expression2 [BY expression3] DO (command[; . . . ]) 3 Parameters name* Specifies the name of a count variable. expression1B Specifies an integer or enu1meration type value. The expression17 and expression2 parameters must be of the same type. expression2B Specifies an integer or enumeration type value. The expression17 and expression2 parameters must be of the same type. expression3 Specifies an integer. command= Specifies a debugger command. If you specify more than oneC command, you must separate the commands with semicolons. At eachB execution, the debugger checks the syntax of any expression2s in( the commands and then evaluates them. 3 Description> The behavior of the FOR command depends on the value of the= expression3 parameter, as detailed in the following table:' expression3Action of the FOR Command= Positive name parameter is incremented from the value ofA expression1 by the value of expression3 until it is3 greater than the value of expression2B Negative name is decremented from the value of expression1 by@ 3 the value of expression3 until it is less than the" value of expression23 0 The debugger returns an error message: Omitted The debugger assumes it to have the value +1 Related commands: EXITLOOP REPEAT WHILE 3 Examples1 1.DBG> FOR I = 10 TO 1 BY -1 DO (EXAMINE A(I)). This command examines an array backwards./ 2.DBG> FOR I = 1 TO 10 DO (DEPOSIT A(I) = 0)/ This command initializes an array to zero.4 2 GO' Starts or resumes program execution. Format GO [address-expression] 3 Parameters address-expressionB Specifies that program execution resume at the location denoted> by the address expression. If you do not specify an address? expression, execution resumes at the point of suspension or,B in the case of debugger startup, at the image transfer address. 3 DescriptionD The GO command starts program execution or resumes execution 5fromA the point at which it is currently suspended. GO is one of theB four debugger commands that can be used to execute your program) (the others are CALL, EXIT, and STEP).C Specifying an address expression with the GO command can produce? unexpected results because it alters the normal control flow; of your program. For example, during a debugging session? you can restart execution at the beginning of the program byD entering the GO %LINE 1 command. However, because t 6he program hasD executed, the contents of some variables might now be initialized3 differently from when you first ran the program.@ If an exception breakpoint is triggered (resulting from a SET= BREAK/EXCEPTION or a STEP/EXCEPTION command), execution isA suspended before any application-declared condition handler isA invoked. If you then resume execution with the GO command, the behavior is as follows:@ o Entering a GO command to resume execution from the currentB 7 location causes the debugger to resignal the exception. ThisC enables you to observe which application-declared handler, if& any, next handles the exception.? o Entering a GO command to resume execution from a locationC other than the current location inhibits the execution of any6 application-declared handler for that exception.A If you are debugging a multiprocess program, the GO command isC executed in the context of the current process set. In addition 8,D when debugging a multiprocess program, the way in which executionA continues in your process depends on whether you entered a SET@ MODE [NO]INTERRUPT command or a SET MODE [NO]WAIT command. By> default (SET MODE NOINTERRUPT), when one process stops, the? debugger takes no action with regard to the other processes.@ Also by default (SET MODE WAIT), the debugger waits until allC process in the current process set have stopped before prompting for a new command. Rel9ated commands: CALL EXIT RERUN SET BREAK SET MODE [NO]INTERRUPT SET MODE [NO]WAIT SET PROCESS SET STEP SET TRACE SET WATCH STEP WAIT 3 Examples 1.DBG> GO . . .# 'Normal successful completion' DBG>@ This command starts program execution, which then completes successfully. 2.DBG> SET BREAK RESTORE" DBG> GO ! start execution . . .' : break at routine INVENTORY\RESTORE 137: procedure RESTORE;# DBG> GO ! resume execution . . .@ In this example, the SET BREAK command sets a breakpoint onD routine RESTORE. The first GO command starts program execution,B which is then suspended at the breakpoint on routine RESTORE.A The second GO command resumes execution from the breakpoint. 3.DBG> GO %LINE 42D This command resumes program execution at line 42 of the module/ in ;which execution is currently suspended. 2 HELPA Displays online help on debugger commands and selected topics.& NOTE? This command is not available in the VSI DECwindows MotifB for OpenVMS user interface to the debugger. Help on commands> is available from the Help menu in a DECwindows debugger window. Format% HELP topic [subtopic [ . . . ]] 3 Parameters topicD Specifies the name of a d<ebugger command or topic about which youC want help. You can specify the asterisk (*) wildcard character," either singly or within a name. subtopic@ Specifies a subtopic, qualifier, or parameter about which youB want further information. You can specify the asterisk wildcard( (*), either singly or within a name. 3 Description= The debugger's online help facility provides the followingB information about any debugger command, including a description= of the =command, its format, explanations of any parametersB that can be specified with the command, and explanations of any5 qualifiers that can be specified with the command.@ To get information about a particular qualifier or parameter,> specify it as a subtopic. If you want information about all= qualifiers, specify "qualifier" as a subtopic. If you want; information about all parameters, specify "parameter" as< a subtopic. If you want information about all parameters,D quali >fiers, and any other subtopics related to a command, specify" an asterisk (*) as a subtopic.> In addition to help on commands, you can get online help onB various topics such as screen features, keypad mode, and so on.B Topic keywords are listed along with the commands when you type HELP.B For summary information about new features with this release of* the debugger, see help on New_Features.= For help on the predefined keypad-key functions, type Help; Keypad_Defini?tions_CI. Also, use the SHOW KEY command to) determine the current key definitions. 3 Example DBG> HELP GO3 This command displays help for the GO command. 2 IFD Executes a sequence of commands if a language expression (Boolean$ expression) is evaluated as true. Format4 IF Boolean-expression THEN (command[; . . . ])# [ELSE (command[; . . . ])] 3 Parameters Boolean-expressionD Specifies a language expression that ev@aluates as a Boolean value1 (true or false) in the currently set language. command= Specifies a debugger command. If you specify more than one? command, you must separate the commands with semicolons (;). 3 DescriptionA The IF command evaluates a Boolean expression. If the value isA true (as defined in the current language), the command list in? the THEN clause is executed. If the expression is false, the8 command list in the ELSE clause (if any) is executeAd. Related commands: EXITLOOP FOR REPEAT WHILE 3 Example= DBG> SET BREAK R DO (IF X .LT. 5 THEN (GO) ELSE (EXAMINE X))B This command causes the debugger to suspend program executionC at location R (a breakpoint) and then resume program execution? if the value of X is less than 5 (Fortran example). If the5 value of X is 5 or more, its value is displayed. 2 MONITOR? Displays the current value of a program variable or lBanguageA expression in the monitor view of the VSI DECwindows Motif for OpenVMS user interface.& NOTEC Requires the VSI DECwindows Motif for OpenVMS user interface. Format MONITOR expression 3 Parameters expressionB Specifies an entity to be monitored. With high-level languages,D this is typically the name of a variable. Currently, MONITOR doesD not handle composite expressions (language expressions contaiCning operators).@ If you specify the name of an aggregate variable (a compositeD data structure such as an array or record structure), the monitor@ view lists "Aggregate" for the value of the variable. You canB then double-click on the variable name to get the values of all- the elements (see context-sensitive Help).A To specify an individual array element, array slice, or record8 component, follow the syntax of the current language. 3 Qualifiers /ASCICD /ASCIC /AC= Interprets each monitored entity as a counted ASCII string@ preceded by a 1-byte count field that gives the length of the( string. The string is then displayed. /ASCID /ASCID /AD> Interprets each monitored entity as the address of a string> descriptor pointing to an ASCII string. The CLASS and DTYPE? fields of the descriptor are not checked, but the LENGTH andA POINTER fields provide the character length and address of theE. ASCII string. The string is then displayed. /ASCII /ASCII:nC Interprets and displays each monitored entity as an ASCII string@ of length n bytes (n characters). If you omit n, the debugger> attempts to determine a length from the type of the address expression. /ASCIW /ASCIW /AW= Interprets each monitored entity as a counted ASCII string@ preceded by a 2-byte count field that gives the length of the( string. The string is then diFsplayed. /ASCIZ /ASCIZ /AZ> Interprets each monitored entity as a zero-terminated ASCII@ string. The ending zero byte indicates the end of the string. The string is then displayed. /BINARY6 Displays each monitored entity as a binary integer. /BYTED Displays each monitored entity in the byte integer type (length 1 byte). /DATE_TIMEC Interprets each monitored entity as a quadword integer (length 8D bytes) containing the iGnternal OpenVMS representation of date andB time. Displays the value in the format dd-mmm-yyyy hh:mm:ss.cc. /DECIMAL7 Displays each monitored entity as a decimal integer. /DEFAULT7 Displays each monitored entity in the default radix. /EXTENDED_FLOATD (Alpha and Integrity servers only) Displays each monitored entity1 in the IEEE X_floating type (length 16 bytes). /FLOAT> On VAX processors, displays each monitored entity in the F_" floating tyHpe (length 4 bytes).B On Alpha processors, displays each monitored entity in the IEEE6 T_floating type (double precision, length 8 bytes). /G_FLOATB Displays each monitored entity in the G_floating type (length 8 bytes). /HEXADECIMAL; Displays each monitored entity as a hexadecimal integer. /INSTRUCTION9 Displays each monitored entity as an assembly-language; instruction (variable length, depending on the number of? instruction operands and the Ikind of addressing modes used).$ See also the /OPERANDS qualifier. /INT Same as /LONGWORD qualifier. /LONG_FLOATD (Alpha and Integrity servers only) Displays each monitored entityB in the IEEE S_floating type (single precision, length 4 bytes). /LONG_LONG_FLOATD (Alpha and Integrity servers only) Displays each monitored entityB in the IEEE T_floating type (double precision, length 8 bytes). /LONGWORD /LONGWORD /INT /LONGJ> Displays each monitored entity in the longword integer typeC (length 4 bytes). This is the default type for program locations. that do not have a compiler-generated type. /OCTAL6 Displays each monitored entity as an octal integer. /OCTAWORD> Displays each monitored entity in the octaword integer type (length 16 bytes). /QUADWORD> Displays each monitored entity in the quadword integer type (length 8 bytes). /REMOVE@ Removes a monKitored item or items with the address expression# specified from the Monitor View. /SHORT Same as /WORD qualfier. /TASK= Applies to tasking (multithread) programs. Interprets eachC monitored entity as a task (thread) object and displays the taskC value (the name or task ID) of that task object. When monitoringA a task object, use /TASK only if the programming language does& not have built-in tasking services. /WORD /WORD /SHORTDL Displays each monitored entity in the word integer type (length 2 bytes). 3 Description? You can use the MONITOR command only with the debugger's VSIB DECwindows Motif for OpenVMS user interface, because the outputD of that command is directed at the monitor view. With the commandB interface, you typically use the EVALUATE, EXAMINE or SET WATCH command instead.* The MONITOR command does the following:D 1. Displays the monitor view (if it is not already displa Myed by a previous MONITOR command).C 2. Puts the name of the specified variable or expression and its( current value in the monitor view.> The debugger updates the monitor view whenever the debuggerD regains control from the program, regardless of whether the valueB of the variable or location you are monitoring has changed. (By? contrast, a watchpoint halts execution when the value of the watched variable changes.)> For more information about the monitor viNew and the MONITOR' command, see context-sensitive Help. Related commands: DEPOSIT EVALUATE EXAMINE SET WATCH 3 Example DBG> MONITOR COUNT< This command displays the name and current value of the= variable COUNT in the monitor view of the debugger's VSI> DECwindows Motif for OpenVMS user interface. The value isD updated whenever the debugger regains control from the program. 2 MOVE? Moves a screen display verticOally or horizontally across the screen.& NOTEC This command is not available in the VSI DECwindows Motif for- OpenVMS user interface to the debugger. Format# MOVE [display-name[, . . . ]] 3 Parameters display-name> Specifies a display to be moved. You can specify any of the following entities: o A predefined display: SRC OUT PROMPT INST REG0 P FREG (Alpha and Integrity servers only) IREG; o A display previously created with the DISPLAY command o A display built-in symbol: %CURDISP %CURSCROLL %NEXTDISP %NEXTINST %NEXTOUTPUT %NEXTSCROLL %NEXTSOURCEB If you do not specify a display, the current scrolling display,3 as established by the SELECT command, is chosen. 3 Qualifiers /DOWN /DOWN[:n]@ Moves tQhe display down by n lines (if n is positive) or up byB n lines (if n is negative). If you omit n, the display is moved down by 1 line. /LEFT /LEFT[:n]A Moves the display to the left by n lines (if n is positive) orB right by n lines (if n is negative). If you omit n, the display" is moved to the left by 1 line. /RIGHT /RIGHT[:n]B Moves the display to the right by n lines (if n is positive) orD left by n lines (if n is negative). If you omitR n, the display is moved to the right by 1 line. /UP /UP[:n]B Moves the display up by n lines (if n is positive) or down by nC lines (if n is negative). If you omit n, the display is moved up by 1 line. 3 Description+ You must specify at least one qualifier.@ For each display specified, the MOVE command simply creates aA window of the same dimensions elsewhere on the screen and mapsD the display to it, while maintaining the relative position Sof the text within the window.A The MOVE command does not change the order of a display on theC display pasteboard. Depending on the relative order of displays,D the MOVE command can cause the display to hide or uncover anotherA display or be hidden by another display, partially or totally.< A display can be moved only up to the edge of the screen.D For a list of the keypad-key definitions associated with the MOVEC command, type Help Keypad_Definitions_CI. Also, use tThe SHOW KEY4 command to determine the current key definitions. Related commands: DISPLAY EXPAND SELECT/SCROLL (SET,SHOW) TERMINAL 3 Examples 1.DBG> MOVE/LEFTD This command moves the current scrolling display to the left by 1 column.# 2.DBG> MOVE/UP:3/RIGHT:5 NEW_OUT@ This command moves display NEW_OUT up by 3 lines and to the right by 5 columns. 2 PTHREAD@ Passes a command to the POSIX threads debuggeUr for execution.& NOTE; This command is valid only when the event facility is> THREADS and the program is running POSIX threads 3.13 or later. Format PTHREAD command 3 Parameters command$ A POSIX threads debugger command. 3 Description@ Passes a command to the POSIX threads debugger for execution.A The results appear in the command view. Once the POSIX threadsB debugger command has been cVompleted, control is returned to the? OpenVMS debugger. You can get help on POSIX threads debugger# commands by typing PTHREAD HELP.B See the Guide to the POSIX Threads Library for more information* about using the POSIX threads debugger. Related commands: o SET EVENT FACILITY o SET TASK|THREAD o SHOW EVENT FACILITY o SHOW TASK|THREAD 3 Example DBG_1> PTHREAD HELP conditions [-afhwqrs] [-(N ] [id]...: list condition variables( W exit: exit from DECthreads debugger+ help [topic]: display help information* keys [-v] [-N ] [id]...: list keys7 mutexes [-afhilqrs] [-N ] [id]...: list mutexes( quit: exit from DECthreads debugger show [-csuv]: show stuff# squeue [-c ] [-fhq] [-t  ] [a]: format queue& stacks [-fs] [sp]...: list stacks$ system: show system information. threads [-1] [-N ] [-abcdfhklmnor] [-s" ] [-tz] [id]...: list threads tset [-chna] [-Xs ]  : set state of thread versions: display versions write : write a stringC All keywords may be abbreviated: if the abbreviation is ambiguous,B the first match will be used. For more help, type 'help '. DBG_1>? This command invokes the POSIX threads debugger help file,B then returns control to the OpenVMS debugger. To get specificC help on a POSIX threads debugger Help topic, type PTHREAD HELP topic. 2 QUITC Ends a debuggYing session, or terminates one or more processes ofA a multiprocess program (similar to EXIT), but without allowingB any application-declared exit handlers to run. If used within aA command procedure or DO clause and no process is specified, it: exits the command procedure or DO clause at that point. Format# QUIT [process-spec[, . . . ]] 3 Parameters process-spec< (Kept debugger only.) Specifies a process currently under4 debugger control. Use any Z of the following forms:D [%PROCESS_NAME] process- The process name, if that name does notD name contain spaces or lowercase characters.= The process name can include the> asterisk (*) wildcard character.D [%PROCESS_NAME] The process name, if that name contains@ "process-name " spaces or lowercase characters. YouD can also use apostrophes (') instead of1 [ quotation marks (").; %PROCESS_PID process_id The process identifier (PID, a1 hexadecimal number).B [%PROCESS_NUMBER] The number assigned to a process when? process-number it comes under debugger control. AA (or %PROC process- new number is assigned sequentially,A number) starting with 1, to each process. IfB a process is terminated with the EXIT? \ or QUIT command, the number can be@ assigned again during the debuggingA session. Process numbers appear in a@ SHOW PROCESS display. Processes areC ordered in a circular list so they canA be indexed with the built-in symbolsA %PREVIOUS_PROCESS and %NEXT_PROCESS.6 process-set-name A symbol de ]fined with theD DEFINE/PROCESS_SET command to represent2 a group of processes.? %NEXT_PROCESS The next process after the visible? process in the debugger's circular* process list.@ %PREVIOUS_PROCESS The process previous to the visible? process in the debugger's circular* process list.C %VISIBLE_PROC ^ESS The process whose stack, register set,C and images are the current context forA looking up symbols, register values,C routine calls, breakpoints, and so on.C You can also use the asterisk (*) wildcard character to specify all processes. 3 DescriptionC The QUIT command is simlar to the EXIT command, except that QUITB does not cause your program to execute and, therefore, do _es notB execute any application-declared exit handlers in your program. Ending a Debugging Session:< To end a debugging session, enter the QUIT command at theA debugger prompt without specifying any parameters. This causes@ orderly termination of the session: the debugger exit handlerB is executed (closing log files, restoring the screen and keypad@ states, and so on), and control is returned to DCL level. YouA cannot then continue to debug your program by entering the DC `L= command DEBUG or CONTINUE (you must restart the debugger).? Using the QUIT Command in Command Procedures and DO Clauses:9 When the debugger executes a QUIT command (without any= parameters) in a command procedure, control returns to the? command stream that invoked the command procedure. A command< stream can be the terminal, an outer (containing) command; procedure, or a DO clause in a command or screen display@ definition. For example, if the command procedure w aas invokedD from within a DO clause, control returns to that DO clause, where? the debugger executes the next command (if any remain in the command sequence).9 When the debugger executes a QUIT command (without any@ parameters) in a DO clause, it ignores any remaining commands* in that clause and displays its prompt.# Terminating Specified Processes:? If you are debugging a multiprocess program, you can use the? QUIT command to terminate specified processes witho but endingA the debugging session. The same techniques and behavior apply,D whether you enter the QUIT command at the prompt or use it within$ a command procedure or DO clause.> To terminate one or more processes, enter the QUIT command,@ specifying these processes as parameters. This causes orderlyA termination of the images in these processes without executing? any application-declared exit handlers associated with these> images. Subsequently, the specified processes arec no longer, identified in a SHOW PROCESS/ALL display.C In contrast to the EXIT command, the QUIT command does not cause" any process to start execution.  Related commands: DISCONNECT @ (Execute Procedure) Ctrl/C Ctrl/Y Ctrl/Z EXIT RERUN RUN SET ABORT_KEY SET PROCESS 3 Examples 1.DBG> QUIT $C This command ends the debugging session and returns you to DCL level.. 2.adll> QUIT %NEXT_PROCESS, JONES_3, %PROC 5 all>B This command causes orderly termination of three processes ofB a multiprocess program: the process after the visible processA on the process list, process JONES_3, and process 5. ControlC is returned to the debugger after the specified processes have exited. 2 REBOOT> (Alpha and Integrity servers only) When debugging operatingA system code with the OpenVMS System-Code Debugger, reboots theD target ma echine running the operating system code and executes (or# reexecutes) your system program.? The REBOOT command, in other words, is similar to the RUN or= RERUN commands when you are within the OpenVMS System-Code? Debugger environment. (The OpenVMS System-Code Debugger is aC kernel debugger that is activated through the OpenVMS Debugger.)= Before you issue this command, you must create an Alpha or@ Integrity servers device driver, activate the OpenVMS System-D Code Defbugger,and use the CONNECT command that provides debugging capability.; You must also have started the OpenVMS Debugger with the DEBUG/KEEP command. Format REBOOT 3 Description< For complete information on using the OpenVMS System-CodeE Debugger, see the VSI OpenVMS System Analysis Tools Manual manual. Related commands: CONNECT DISCONNECT 3 Example DBG> REBOOT> This command reboots the target machine where you will gbeD debugging the OpenVMS operating system and reruns your program. 2 REPEAT? Executes a sequence of commands a specified number of times. Format7 REPEAT language-expression DO (command[; . . . ]) 3 Parameters language-expression< Denotes any expression in the currently set language that# evaluates to a positive integer. command= Specifies a debugger command. If you specify more than oneC command, you must separate the commanhds with semicolons (;). AtD each execution, the debugger checks the syntax of any expressions+ in the commands and then evaluates them. 3 Description> The REPEAT command is a simple form of the FOR command. The@ REPEAT command executes a sequence of commands repetitively a? specified number of times, without providing the options for; establishing count parameters that the FOR command does. Related commands: EXITLOOP FOR WHILE 3 Exaimple$ DBG> REPEAT 10 DO (EXAMINE Y; STEP)C This command line sets up a loop that issues a sequence of two. commands (EXAMINE Y, then STEP) 10 times. 2 RERUN7 Reruns the program currently under debugger control.& NOTE? Requires that you started your debugging session with the? DCL command DEBUG/KEEP and then executed the debugger RUNA command. If you began your session with the DCL command RUNB filespec insteadj, you cannot use the debugger RERUN command. Format RERUN 3 Qualifiers /ARGUMENTS /ARGUMENTS="arg-list"A Specifies a list of arguments. If you specify a quoted string,D you might have to add quotation marks because the debugger stripsA them when parsing the string. If you do not specify arguments,? any arguments that were specified previously when running or2 rerunning that program are applied, by default. /HEAP_ANALYZERD (Applieks only to workstation users.) Invokes the Heap Analyzer, a@ debugger feature that helps you understand how memory is used> by your application. For more information on using the Heap- Analyzer, see the OpenVMS Debugger Manual. /SAVE /SAVE (default) /NOSAVE; Controls whether to save the current state (activated or; deactivated) of all breakpoints, tracepoints, and staticC watchpoints for the next run of the program. The /SAVE qualifierB specifies tha lt their state is saved, and /NOSAVE specifies thatC their state is not saved. /SAVE may or may not save the state ofB a particular nonstatic watchpoint depending on the scope of theB variable being watched relative to the main program unit (where execution restarts). 3 DescriptionB If you invoked the debugger with the DCL command DEBUG/KEEP and@ subsequently used the debugger RUN command to begin debugging@ your program, you can then use the RERUN command to rerun the, m program currently under debugger control.@ The RERUN command terminates the image you were debugging and@ then restarts that image under debugger control. Execution isC paused at the start of the main program unit, as if you had used9 the debugger RUN command or the DCL command RUN/DEBUG.? The RERUN command uses the same version of the image that isA currently under debugger control. To debug a different versionC of that program (or a different program) from the same denbugging session, use the RUN command. Related commands: RUN (debugger command) RUN (DCL command)! (ACTIVATE,DEACTIVATE) BREAK! (ACTIVATE,DEACTIVATE) TRACE! (ACTIVATE,DEACTIVATE) WATCH 3 Examples 1.DBG> RERUN= This command reruns the current program. By default, the9 debugger saves the current state of all breakpoints,D tracepoints, and static watchpoints (activated or deactivated). 2.DBG> RERUN/NOSAVE? Thios command reruns the current program without saving theB current state of breakpoints, tracepoints, and watchpoints-inA effect, the same as using the RUN command and specifying the image name.+ 3.DBG> RERUN/ARGUMENTS="fee fii foo fum"@ This command reruns the current program with new arguments. 2 RUN) Runs a program under debugger control.& NOTE? Requires that you started your debugging session with the< DCL pcommand DEBUG/KEEP. If you began your session with> the DCL command RUN filespec instead, you cannot use the debugger RUN command. Format RUN [program-image] 3 Parameters program-image@ Specifies the executable image of the program to be debugged.= Do not specify an image if you use the /COMMAND=cmd-symbol qualifier. 3 Qualifiers /ARGUMENTS /ARGUMENTS="arg-list"A Specifies a list of arguments. If you specify aq quoted string,D you might have to add quotation marks because the debugger strips" quotes when parsing the string. /COMMAND /COMMAND="cmd-symbol"; Specifies a DCL foreign command for running the program.; Do not use this qualifier if you specify a program-image parameter.D Do not specify a DCL command or any other command definition that, was created with the SET COMMAND command. /HEAP_ANALYZERD (Applies only to workstation users.) Invokes rthe Heap Analyzer, a@ debugger feature that helps you understand how memory is used> by your application. For more information on using the Heap- Analyzer, see the OpenVMS Debugger Manual. /NEWD Runs a new program under debugger control without terminating any programs already running. 3 DescriptionC If you invoked the debugger with the DCL command DEBUG/KEEP, youB can use the debugger RUN command at any time during a debuggingC session to start a program un sder debugger control. If you are inC the midst of debugging a program when you issue the RUN command,@ that program will first be terminated unless you use the /NEW qualifier.B To run the same program again (that is, the same version of theC program that is currently under debugger control), use the RERUNB command. RERUN enables you to save the current state (activated> or deactivated) of any breakpoints, tracepoints, and static watchpoints.B Note the following retstrictions about the debugger RUN command:B o You can use the RUN command only if you started the debugger& with the DCL command DEBUG/KEEP.A o You cannot use the RUN command to connect the debugger to a5 running program. See the description of Ctrl/Y.C o You cannot run a program under debugger control over a DECnet? link. Both the image to be debugged and the debugger must reside on the same node. Related commands: RERUN RUN (DCL cuommand) Ctrl/Y-DEBUG (DCL command) DEBUG (DCL command) 3 Examples 1.DBG> RUN EIGHTQUEENS% Language: C, Module: EIGHTQUEENS? This command brings the program EIGHTQUEENS under debugger control.- 2.$ RUNPROG == "$ DISK3:[SMITH]MYPROG.EXE" $ DEBUG/KEEP . . .1 DBG> RUN/COMMAND="RUNPROG"/ARGUMENTS="X Y Z"D The first line of this example creates a command symbol RUNPROG@ (at DCL level) to run an image named MYPROGv.EXE. The secondC line starts the debugger. The debugger RUN command then brings> the image MYPROG.EXE under debugger control. The /COMMANDB qualifier specifies the command symbol previously created (in@ this case RUNPROG), and the /ARGUMENTS qualifier passes the" arguments X Y Z to the image.& 3.DBG> RUN/ARGUMENTS="X Y Z" MYPROG> This command brings the program MYPROG.EXE under debugger, control and passes the arguments X Y Z. 2 SAVE@ Preserves twhe contents of an existing screen display in a new display.& NOTEC This command is not available in the VSI DECwindows Motif for- OpenVMS user interface to the debugger. Format0 SAVE old-display AS new-display [, . . . ] 3 Parameters old-displayB Specifies the display whose contents are saved. You can specify! any of the following entities: o A predefined display: SRC OUT x PROMPT INST REG0 FREG (Alpha and Integrity servers only) IREG; o A display previously created with the DISPLAY command o A display built-in symbol: %CURDISP %CURSCROLL %NEXTDISP %NEXTINST %NEXTOUTPUT %NEXTSCROLL %NEXTSOURCE new-display@ Specifies the name of the new display to be created. This new> display then receives the contents of the old-disp di ysplay. 3 Description= The SAVE command enables you to save a snapshot copy of anA existing display in a new display for later reference. The newA display is created with the same text contents as the existingC display. In general, the new display is given all the attributesB or characteristics of the old display except that it is removedD from the screen and is never automatically updated. You can laterC recall the saved display to the terminal screen with the DISPLAY z command.; When you use the SAVE command, only those lines that areA currently stored in the display's memory buffer (as determined? by the /SIZE qualifier on the DISPLAY command) are stored in? the saved display. However, in the case of a saved source or? instruction display, you can also see any other source linesC associated with that module or any other instructions associated6 with that routine (by scrolling the saved display).& You cannot save the PROMPT di{splay. Related commands: DISPLAY EXITLOOP 3 Example DBG> SAVE REG AS OLDREGB This command saves the contents of the display named REG into, the newly created display named OLDREG. 2 SCROLLC Scrolls a screen display to make other parts of the text visible through the display window.& NOTEC This command is not available in the VSI DECwindows Motif for- OpenVMS user interface to the debugger |. Format SCROLL [display-name] 3 Parameters display-nameA Specifies a display to be scrolled. You can specify any of the following entities: o A predefined display: SRC OUT PROMPT INST REG0 FREG (Alpha and Integrity servers only) IREG; o A display previously created with the DISPLAY command o A display built-in symbol: %CURDISP %CURSCROLL} %NEXTDISP %NEXTINST %NEXTOUTPUT %NEXTSCROLL %NEXTSOURCEB If you do not specify a display, the current scrolling display,3 as established by the SELECT command, is chosen. 3 Qualifiers /BOTTOM4 Scrolls down to the bottom of the display's text. /DOWN /DOWN:[n]A Scrolls down over the display's text by n lines to reveal text= further down in the display. If you omit n, the display is6 scrolled by~ approximately 3/4 of its window height. /LEFT /LEFT:[n]C Scrolls left over the display's text by n columns to reveal textB beyond the left window border. You cannot scroll past column 1.< If you omit n, the display is scrolled left by 8 columns. /RIGHT /RIGHT[:n]D Scrolls right over the display's text by n columns to reveal text@ beyond the right window border. You cannot scroll past columnB 255. If you omit n, the display is scrolled right by 8 columns. /TOP/ Scrolls up to the top of the display's text. /UP /UP[:n]? Scrolls up over the display's text by n lines to reveal textD further up in the display. If you omit n, the display is scrolled- by approximately 3/4 of its window height. 3 Description> The SCROLL command moves a display up, down, right, or leftC relative to its window so that various parts of the display text* can be made visible through the window.A Use the S€ELECT/SCROLL command to select the target display for6 the SCROLL command (the current scrolling display).? For a list of the key definitions associated with the SCROLLC command, type Help Keypad_Definitions_CI. Also, use the SHOW KEY4 command to determine the current key definitions. Related command: SELECT. 3 Examples 1.DBG> SCROLL/LEFTC This command scrolls the current scrolling display to the left by 8 columns. 2.DBG> SCROLL/UP:4 ALPHA3 This command scrolls display ALPHA 4 lines up. 2 SEARCH? Searches the source code for a specified string and displays9 source lines that contain an occurrence of the string. Format SEARCH [range] [string] 3 Parameters range< Specifies a program region to be searched. Use any of the following formats:C mod-name Searches the specified module from line 0 to- the end of the module.= mod-name\li ‚ne-num Searches the specified module from the> specified line number to the end of the module.B mod-name\line- Searches the specified module from the lineC num:line-num number specified on the left of the colon to> the line number specified on the right.B line-num Uses the current scope to find a module andC searches that module from the specified lineC ƒ number to the end of the module. The currentC scope is established by a previous SET SCOPED command, or the PC scope if you did not enterB a SET SCOPE command. If you specify a scopeB search list with the SET SCOPE command, theC debugger searches only the module associated2 with the first named scope.B line-num:line-num Uses the current scope to find a mo „dule and@ searches that module from the line number@ specified on the left of the colon to the> line number specified on the right. TheA current scope is established by a previous@ SET SCOPE command, or the PC scope if you@ did not enter a SET SCOPE command. If you? specify a scope search list with the SETD SCOPE comma…nd, the debugger searches only theD module associated with the first named scope.B null (no entry) Searches the same module as that from which@ a source line was most recently displayed> (as a result of a TYPE, EXAMINE/SOURCE,A or SEARCH command, for example), beginning@ at the first line following the line mostC recently displayed and continuing to the end†% of the module. stringC Specifies the source code characters for which to search. If youC do not specify a string, the string specified in the last SEARCH command, if any, is used.9 You must enclose the string in quotation marks (") or2 apostrophes (') under the following conditions:B o The string has any leading or ending space or tab characters/ o The string contains an embedded semicolon! o The range parameter is nullD ‡ If the string is enclosed in quotation marks, use two consecutive? quotation marks ("") to indicate an enclosed quotation mark.@ If the string is enclosed in apostrophes, use two consecutive7 apostrophes ('') to indicate an enclosed apostrophe. 3 Qualifiers /ALL@ Specifies that the debugger search for all occurrences of theB string in the specified range and display every line containing an occurrence of the string. /IDENTIFIER> Specifies that the ˆdebugger search for an occurrence of the? string in the specified range but display the string only ifC it is not bounded on either side by a character that can be part, of an identifier in the current language. /NEXT< (Default) Specifies that the debugger search for the nextC occurrence of the string in the specified range and display only' the line containing this occurrence. /STRINGC (Default) Specifies that the debugger search for and display theD s‰tring as specified, and not interpret the context surrounding anC occurrence of the string, as it does in the case of /IDENTIFIER. 3 DescriptionD The SEARCH command displays the lines of source code that contain' an occurrence of a specified string.D If you specify a module name with the SEARCH command, that module@ must be set. To determine whether a particular module is set,C use the SHOW MODULE command, then use the SET MODULE command, if necessary.D Qualifi Šers for the SEARCH command determine whether the debugger:A (1) searches for all occurrences (/ALL) of the string or only@ the next occurrence (/NEXT); and (2) displays any occurrenceA of the string (/STRING) or only those occurrences in which theB string is not bounded on either side by a character that can be? part of an identifier in the current language (/IDENTIFIER).= If you plan to enter several SEARCH commands with the sameC qualifier, you can first use the SET SEAR‹CH command to establishA a new default qualifier (for example, SET SEARCH ALL makes theB SEARCH command behave like SEARCH/ALL). Then you do not have toC use that qualifier with the SEARCH command. You can override theA current default qualifiers for the duration of a single SEARCH* command by specifying other qualifiers. Related commands: (SET,SHOW) LANGUAGE (SET,SHOW) MODULE (SET,SHOW) SCOPE (SET,SHOW) SEARCH 3 Examples# 1.DBG Œ> SEARCH/STRING/ALL 40:50 D module COBOLTEST8 40: 02 D2N COMP-2 VALUE -234560000000.5 41: 02 D COMP-2 VALUE 222222.33.9 42: 02 DN COMP-2 VALUE -222222.333333./ 47: 02 DR0 COMP-2 VALUE 0.1.4 48: 02 DR5 COMP-2 VALUE 0.000001.9 49: 02 DR10 COMP-2 VALUE 0.00000000001.> 50: 02 DR15 COMP-2 VALUE 0.0000000000000001. DBG>A This command searches for all o ccurrences of the letter D inB lines 40 to 50 of the module COBOLTEST, the module that is in the current scope.' 2.DBG> SEARCH/IDENTIFIER/ALL 40:50 D module COBOLTEST5 41: 02 D COMP-2 VALUE 222222.33. DBG>A This command searches for all occurrences of the letter D inB lines 40 to 50 of the module COBOLTEST. The debugger displays@ the only line where the letter D (the search string) is notA bounded on either side by a charactŽer that can be part of an( identifier in the current language. 3.DBG> SEARCH/NEXT 40:50 D module COBOLTEST8 40: 02 D2N COMP-2 VALUE -234560000000. DBG>B This command searches for the next occurrence of the letter D/ in lines 40 to 50 of the module COBOLTEST. 4.DBG> SEARCH/NEXT module COBOLTEST5 41: 02 D COMP-2 VALUE 222222.33. DBG>C This command searches for the next occurrence of the letter D.A The debugger assumes D to be the search string because D wasC the last one entered and no other search string was specified. 5.DBG> SEARCH 43 D module COBOLTEST/ 47: 02 DR0 COMP-2 VALUE 0.1. DBG>B This command searches for the next occurrence (by default) of) the letter D, starting with line 43. 2 SDAA Invokes the System Dump Analyzer (SDA) from within the OpenVMS3 debugger without terminating a debugger session.  Format SDA [sda-command] 3 Parameters sda-commandA One SDA command to be executed before returning control to the OpenVMS debugger. 3 DescriptionC The SDA command allows you to use the System Dump Analyzer (SDA)/ within the debugger for the following tasks:? o System code debugging with the System Code Debugger (SCD)( (Alpha and Integrity servers only)> o System dump analysis with the System Dump Debugger (SDD)( (Alpha and‘ Integrity servers only)? o Process dump analysis with the System Dump Analyzer (SDA)( (Alpha and Integrity servers only)A This gives you access to all SDA commands within the debugging? session. When you exit SDA, you return to the same debuggingA session. Note that you do not have access to debugger commands within the SDA session.& NOTE? The SDA command is not available when debugging user-mode programs. Relat’ed commands ANALYZE/CRASH_DUMP ANALYZE/PROCESS_DUMP CONNECT %NODE 3 Example DBG> SDA) OpenVMS (TM) Alpha process dump analyzer SDA> .. . . SDA> EXIT DBG>C This example opens an SDA session within the OpenVMS debugger,? performs some analysis, closes the SDA session and returns control to the debugger. DBG> SDA SHOW PROCESS . . DBG>A This example show the execution of a single SDA command from@ “ within the debugger, followed by a return of control to the debugger. 2 SELECT8 Selects a screen display as the current error, input,= instruction, output, program, prompt, scrolling, or source display.& NOTEC This command is not available in the VSI DECwindows Motif for- OpenVMS user interface to the debugger. Format SELECT [display-name] 3 Parameters display-name@ Specifies the displ”ay to be selected. You can specify any oneA of the following, with the restrictions noted in the qualifier descriptions: o A predefined display: SRC OUT PROMPT INST REG0 FREG (Alpha and Integrity servers only) IREG; o A display previously created with the DISPLAY command o A display built-in symbol: %CURDISP %CURSCROLL %NEXTDISP %NEXTINST %NEXTOU•TPUT %NEXTSCROLL %NEXTSOURCEA If you omit this parameter and do not specify a qualifier, youD "unselect" the current scrolling display (no display then has theA scrolling attribute). If you omit this parameter but specify aC qualifier (/INPUT, /SOURCE, and so on), you unselect the current@ display with that attribute (see the qualifier descriptions). 3 Qualifiers /ERRORC Selects the specified display as the current error display. ThisA c –auses all debugger diagnostic messages to go to that display.@ The display specified must be either an output display or theB PROMPT display. If you do not specify a display, this qualifierD selects the PROMPT display current error display. By default, the* PROMPT display has the error attribute. /INPUTC Selects the specified display as the current input display. ThisC causes that display to echo debugger input (which appears in theD PROMPT display). The display specif—ied must be an output display.= If you do not specify a display, the current input display@ is unselected and debugger input is not echoed to any displayC (debugger input appears only in the PROMPT display). By default,& no display has the input attribute. /INSTRUCTIOND Selects the specified display as the current instruction display.@ This causes the output of all EXAMINE/INSTRUCTION commands toC go to that display. The display specified must be an instruction d˜isplay.C If you do not specify a display, the current instruction display> is unselected and no display has the instruction attribute.D By default, for all languages except MACRO-32, no display has theA instruction attribute. If the language is set to MACRO-32, the9 INST display has the instruction attribute by default. /OUTPUTD Selects the specified display as the current output display. ThisA causes debugger output that is not already directed to another? d™isplay to go to that display. The display specified must be2 either an output display or the PROMPT display.B If you do not specify a display, the PROMPT display is selectedA as the current output display. By default, the OUT display has the output attribute. /PROGRAM@ Selects the specified display as the current program display.= This causes the debugger to try to force program input andA output to that display. Currently, only the PROMPT display can be specifšied.B If you do not specify a display, the current program display isB unselected and program input and output are no longer forced to the specified display.C By default, the PROMPT display has the program attribute, except> on workstations, where the program attribute is unselected. /PROMPT? Selects the specified display as the current prompt display.D This is where the debugger prompts for input. Currently, only theA PROMPT display can be specified. Moreover›, you cannot unselect? the PROMPT display (the PROMPT display always has the prompt attribute). /SCROLLC (Default) Selects the specified display as the current scrolling= display. This is the default display for the SCROLL, MOVE,@ and EXPAND commands. Although any display can have the scrollD attribute, you can use only the MOVE and EXPAND commands (not the+ SCROLL command) with the PROMPT display.D If you do not specify a display, the current scrolling displaœy is6 unselected and no display has the scroll attribute.A By default, for all languages except MACRO-32, the SRC displayD has the scroll attribute. If the language is set to MACRO-32, the4 INST display has the scroll attribute by default. /SOURCED Selects the specified display as the current source display. ThisB causes the output of all TYPE and EXAMINE/SOURCE commands to goC to that display. The display specified must be a source display.A If you do not speci fy a display, the current source display is6 unselected and no display has the source attribute.A By default, for all languages except MACRO-32, the SRC displayC has the source attribute. If the language is set to MACRO-32, no/ display has the source attribute by default. 3 Description> Attributes are used to select the current scrolling display? and to direct various types of debugger output to particular= displays. This gives you the option of mixing or isolating žB different types of information, such as debugger input, output,9 diagnostic messages, and so on in scrollable displays.> Use the SELECT command with one or more qualifiers (/ERROR,: /SOURCE, and so on) to assign one or more corresponding? attributes to a display. By default, if you do not specify a! qualifier, /SCROLL is assumed.C If you use the SELECT command without specifying a display name,B the attribute assignment indicated by the qualifier is canceled= (unseŸlected). To reassign display attributes, you must useC another SELECT command. For more information, see the individual qualifier.? For a list of the key definitions associated with the SELECTC command, type Help Keypad_Definitions_CI. Also, use the SHOW KEY4 command to determine the current key definitions. Related commands: DISPLAY EXPAND MOVE SCROLL SHOW SELECT 3 Examples# 1.DBG> SELECT/SOURCE/SCROLL SRC2@ Thi s command selects display SRC2 as the current source and scrolling display. 2.DBG> SELECT/INPUT/ERROR OUT> This command selects display OUT as the current input and? error display. This causes debugger input, debugger output? (assuming OUT is the current output display), and debugger? diagnostic messages to be logged in the OUT display in the correct sequence. 3.DBG> SELECT/SOURCE? This command unselects (deletes the source attribute from)@ ¡ the currently selected source display. The output of a TYPEB or EXAMINE/SOURCE command then goes to the currently selected output display. 2 SET 3 ABORT_KEY< Assigns the debugger's abort function to another Ctrl-key8 sequence. By default, Ctrl/C does the abort function.& NOTEC This command is not available in the VSI DECwindows Motif for- OpenVMS user interface to the debugger. Format$ SET ABORT_KEY ¢= CTRL_character 4 Parameters characterC Specifies the key you press while holding down the Ctrl key. You( can specify any alphabetic character. 4 DescriptionC By default, the Ctrl/C sequence, when entered within a debugging: session, aborts the execution of a debugger command andB interrupts program execution. The SET ABORT_KEY command enablesA you to assign the abort function to another Ctrl-key sequence.C This might be necessary if your program has £ a Ctrl/C AST service routine enabled.A Many Ctrl-key sequences have predefined functions, and the SETB ABORT_KEY command enables you to override such definitions (seeB the OpenVMS User's Manual). Some of the Ctrl-key characters not3 used by the operating system are G, K, N, and P.> The SHOW ABORT_KEY command identifies the Ctrl-key sequence. currently in effect for the abort function.B Do not use Ctrl/Y from within a debugging session. Instead, useD either Ctrl/C¤ or an equivalent Ctrl-key sequence established with the SET ABORT_KEY command. Related commands: Ctrl/C Ctrl/Y SHOW ABORT_KEY 4 Example DBG> SHOW ABORT_KEY Abort Command Key is CTRL_C DBG> GO . . . < DBG> EXAMINE/BYTE 1000:101000 !should have typed 1000:1010 1000: 0 1004: 0 1008: 0 1012: 0 1016: 0 2 %DEBUG-W-ABORTED, command aborted by user request DBG> SET ABORT_KEY = CTRL_P DBG> GO . . .¥ < DBG> EXAMINE/BYTE 1000:101000 !should have typed 1000:1010 1000: 0 1004: 0 1008: 0 1012: 0 1016: 0 2 %DEBUG-W-ABORTED, command aborted by user request DBG>& This example shows the following:7 o Use of Ctrl/C for the abort function (default).> o Use of the SET ABORT_KEY command to reassign the abort function to Ctrl/P. 3 ATSIGND Establishes the default file specification that the debugger uses) when search¦ing for command procedures. Format SET ATSIGN file-spec 4 Parameters file-spec= Specifies any part of a file specification (for example, a= directory name or a file type) that the debugger is to use? by default when searching for a command procedure. If you do= not supply a full file specification, the debugger assumesA SYS$DISK:[]DEBUG.COM as the default file specification for any missing field.C You can specify a logical name that tra§nslates to a search list.? In this case, the debugger processes the file specifications@ in the order they appear in the search list until the command procedure is found. 4 Description@ When you invoke a debugger command procedure with the executeD procedure (@) command, the debugger assumes, by default, that theD command procedure file specification is SYS$DISK:[]DEBUG.COM. The; SET ATSIGN command enables you to override this default. Related commands: ¨@ (Execute Procedure) SHOW ATSIGN 4 Example' DBG> SET ATSIGN USER:[JONES.DEBUG].DBG DBG> @TESTB In this example, when you use the @TEST command, the debugger7 looks for the file TEST.DBG in USER:[JONES.DEBUG]. 3 BREAKA Establishes a breakpoint at the location denoted by an address? expression, at instructions of a particular class, or at the" occurrence of specified events. Format. SET BREAK [address-expression[, . . . ]]. © [WHEN(conditional-expression)]' [DO(command[; . . . ])] 4 Parameters address-expression@ Specifies an address expression (a program location) at which= a breakpoint is to be set. With high-level languages, this> is typically a line number, a routine name, or a label, and? can include a path name to specify the entity uniquely. MoreC generally, an address expression can also be a memory address orC a register and can be composed of numªbers (offsets) and symbols,A as well as one or more operators, operands, or delimiters. For> information about the operators that you can use in address7 expressions, see the Address_Expressions help topic.> Do not specify the asterisk (*) wildcard character. Do not: specify an address expression with any of the following qualifiers: /ACTIVATING /BRANCH /CALL /EXCEPTION /HANDLER /INSTRUCTION /INTO /LINE /OVE«R /[NO]SHARE /[NO]SYSTEM /SYSEMULATE (Alpha only) /TERMINATING8 /UNALIGNED_DATA (Alpha and Integrity servers only)B The /MODIFY and /RETURN qualifiers are used with specific kinds of address expressions.A If you specify a memory address or an address expression whose< value is not a symbolic location, check (with the EXAMINE> command) that an instruction actually begins at the byte of@ memory so indicated. If an instruction does not begin at ¬thisA byte, a run-time error can occur when an instruction includingA that byte is executed. When you set a breakpoint by specifyingD an address expression whose value is not a symbolic location, theA debugger does not verify that the location specified marks the beginning of an instruction. conditional-expression: Specifies a conditional expression in the currently setB language that is to be evaluated whenever execution reaches theD breakpoint. (The debugger che ­cks the syntax of the expressions inB the WHEN clause when execution reaches the breakpoint, not whenB the breakpoint is set.) If the expression is true, the debuggerA reports that a breakpoint has been triggered. If an action (DOC clause) is associated with the breakpoint, it will occur at this@ time. If the expression is false, a report is not issued, theA commands specified by the DO clause (if one was specified) are4 not executed, and program execution is continued. ®command@ Specifies a debugger command to be executed as part of the DOD clause when break action is taken. The debugger checks the syntaxA of the commands in a DO clause when it executes the DO clause," not when the breakpoint is set. 4 Qualifiers /ACTIVATING> Causes the debugger to break when a new process comes underD debugger control. The debugger prompt is displayed when the firstB process comes under debugger control. This enables you to enterB debug¯ger commands before the program has started execution. See# also the /TERMINATING qualifier. /AFTER /AFTER:nB Specifies that break action not be taken until the nth time theA designated breakpoint is encountered (n is a decimal integer).A Thereafter, the breakpoint occurs every time it is encounteredA provided that conditions in the WHEN clause (if specified) areA true. The SET BREAK/AFTER:1 command has the same effect as SET BREAK. /BRANCH; C°auses the debugger to break on every branch instruction? encountered during program execution. See also the /INTO and /OVER qualifiers. /CALL9 Causes the debugger to break on every call instruction: encountered during program execution, including the RET8 instruction. See also the /INTO and /OVER qualifiers. /EVENT /EVENT=event-name? Causes the debugger to break on the specified event (if that@ event is defined and detected by the current event fa±cility).? If you specify an address expression with /EVENT, causes theA debugger to break whenever the specified event occurs for thatD address expression. You cannot specify an address expression with certain event names.D Event facilities are available for programs that call Ada or SCANC routines or that use POSIX threads services. Use the SHOW EVENT_B FACILITY command to identify the current event facility and the associated event names. /EXCEPTIONB Cause ²s the debugger to break whenever an exception is signaled.D The break action occurs before any application-declared exception handlers are invoked.> As a result of a SET BREAK/EXCEPTION command, whenever your@ program generates an exception, the debugger suspends programB execution, reports the exception, and displays its prompt. WhenB you resume execution from an exception breakpoint, the behavior is as follows:= o If you enter a GO command without an address-expressio ³n? parameter, the exception is resignaled, thus allowing any8 application-declared exception handler to execute.: o If you enter a GO command with an address-expression= parameter, program execution continues at the specifiedA location, thus inhibiting the execution of any application-! declared exception handler.; On Alpha, you must explicitly set a breakpoint in theA exception handler before entering a STEP or a GO command to? get the de´bugger to suspend execution within the handler.; o If you enter a CALL command, the routine specified is executed.? On Alpha processors, an exception might not be delivered (toB the program or debugger) immediately after the execution of theA instruction that caused the exception. Therefore, the debugger@ might suspend execution on an instruction beyond the one that! actually caused the exception. /HANDLERB Causes the debugger to scan the call stack and µattempt to set aC breakpoint on every established frame-based handler whenever theA program being debugged has an exception. The debugger does notB discriminate between standard RTL handlers and user-established handlers.? On Alpha and Integrity servers, most RTLs establish a jacket> RTL handler on a frame where the user program has defined aA handler. The RTL jacket performs setup, argument manipulation,A and dispatch to the user written handlers. When processing theA ¶ exception, the debugger can only set the breakpoint on the RTLD jacket handler, because that is the address on the call stack. IfC the debugger suspends program execution in a jacket RTL handler,@ you can usually reach the user-defined handler by finding the@ dispatch point(s) via some number of STEP/CALLs followed by a STEP/INTO.B See the OpenVMS Calling Standard for more information on frame- based handlers.A If the jacket RTL handler is part of an installed share ·d imageC such as ALPHA LIBOTS, the debugger cannot set a breakpoint on itB (no private user mode write access). In this case, activate ALL9 RTLs as private images via logical names. For example:) $DEFINE LIBOTS SYS$SHARE:LIBOTS.EXE;C Note that the trailing semicolon (;) is required. Note also thatB all (or none) of your shared installed RTLs should be activatedD privately. Use SHOW IMAGE/FULL data to realize the list of imagesC with system space code sections and the¸n define logicals for all( of them and rerun your debug session. /INSTRUCTION /INSTRUCTION' /INSTRUCTION[=(opcode[, . . . ])]B When you do not specify an opcode, causes the debugger to break= on every instruction encountered during program execution.+ See also the /INTO and /OVER qualifiers. /INTO? (Default) Applies only to breakpoints set with the followingD qualifiers (that is, when an address expression is not explicitly specified): ¹ /BRANCH /CALL /INSTRUCTION /LINE@ When used with those qualifiers, /INTO causes the debugger toC break at the specified points within called routines (as well asA within the routine in which execution is currently suspended).C The /INTO qualifier is the default and is the opposite of /OVER.B When using /INTO, you can further qualify the break action with) /[NO]JSB, /[NO]SHARE, and /[NO]SYSTEM. /LINE? Causes the debugger to break on tºhe beginning of each sourceD line encountered during program execution. See also the /INTO and /OVER qualifiers. /MODIFYC Causes the debugger to break on every instruction that writes toB and modifies the value of the location indicated by the addressC expression. The address expression is typically a variable name.= The SET BREAK/MODIFY command acts exactly like a SET WATCH4 command and operates under the same restrictions.A If you specify an absolute addres »s for the address expression,? the debugger might not be able to associate the address with> a particular data object. In this case, the debugger uses aB default length of 4 bytes. You can change this length, however,C by setting the type to either WORD (SET TYPE WORD, which changes? the default length to 2 bytes) or BYTE (SET TYPE BYTE, whichD changes the default length to 1 byte). SET TYPE LONGWORD restores! the default length of 4 bytes. /OVER@ Applies only to¼ breakpoints set with the following qualifiers9 (that is, when an address expression is not explicitly specified): /BRANCH /CALL /INSTRUCTION /LINE@ When used with those qualifiers, /OVER causes the debugger toA break at the specified points only within the routine in whichA execution is currently suspended (not within called routines).= The /OVER qualifier is the opposite of /INTO (which is the default). /RETURN@ Causes the de½bugger to break on the return instruction of theB routine associated with the specified address expression (whichB can be a routine name, line number, and so on). Breaking on theB return instruction enables you to inspect the local environment< (for example, obtain the values of local variables) while= the routine is still active. Note that the view of a localB environment may differ depending on your architecture. On Alpha< processors, this qualifier can be applied to any routin¾e.D The address-expression parameter is an instruction address within? a routine. It can simply be a routine name, in which case it= specifies the routine start address. However, you can alsoC specify another location in a routine, so you can see only those@ returns that are taken after a certain code path is followed.A A SET BREAK/RETURN command cancels a previous SET BREAK if you' specify the same address expression. /SHARE /SHARE (default) /NOSHA¿RE; Qualifies /INTO. Use with /INTO and one of the following qualifiers: /BRANCH /CALL /INSTRUCTION /LINE< The /SHARE qualifier permits the debugger to break withinC shareable image routines as well as other routines. The /NOSHAREC qualifier specifies that breakpoints not be set within shareable images. /SILENT /SILENT /NOSILENT (default)B Controls whether the "break . . . " message and the source line@ for tÀhe current location are displayed at the breakpoint. TheC /NOSILENT qualifier specifies that the message is displayed. TheC /SILENT qualifier specifies that the message and the source lineB are not displayed. The /SILENT qualifier overrides /SOURCE. See( also the SET STEP [NO]SOURCE command. /SOURCE /SOURCE (default) /NOSOURCE? Controls whether the source line for the current location isD displayed at the breakpoint. The /SOURCE qualifier specifies that ÁB the source line is displayed. The /NOSOURCE qualifier specifiesD that no source line is displayed. The /SILENT qualifier overrides5 /SOURCE. See also the SET STEP [NO]SOURCE command. /SYSEMULATE /SYSEMULATE[=mask]B (Alpha only) Stops program execution and returns control to the? debugger after the operating system emulates an instruction.? The optional argument mask is an unsigned quadword with bits? set to specify which emulated instruction groups shall caÂuse= breakpoints. The only emulated instruction group currentlyB defined consists of the BYTE and WORD instructions. Select this3 instruction group by setting bit 0 of mask to 1.> If mask is not specified or if mask = FFFFFFFFFFFFFFFF, the= debugger stops program execution when the operating system emulates any instruction. /SYSTEM /SYSTEM (default) /NOSYSTEM; Qualifies /INTO. Use with /INTO and one of the following qualifiers: /BRAÃNCH /CALL /INSTRUCTION /LINED The /SYSTEM qualifier permits the debugger to break within system? routines (P1 space) as well as other routines. The /NOSYSTEM@ qualifier specifies that breakpoints not be set within system routines. /TEMPORARY@ Causes the breakpoint to disappear after it is triggered (the/ breakpoint does not remain permanently set). /TERMINATINGB Causes the debugger to break when a process does an image exit.> The d Äebugger gains control and displays its prompt when the? last image of a one-process or multiprocess program exits. A> process is terminated when the image has executed the $EXITA system service and all of its exit handlers have executed. See" also the /ACTIVATING qualifier. /UNALIGNED_DATAA (Alpha and Integrity servers only) Causesthe debugger to breakC directly after any instruction that accesses unaligned data (forD example, after a load word instruction that accesÅses data that is not on a word boundary). 4 DescriptionC When a breakpoint is triggered, the debugger takes the following actions:< 1. Suspends program execution at the breakpoint location.A 2. If you specified /AFTER when you set the breakpoint, checks@ the AFTER count. If the specified number of counts has notB been reached, execution resumes and the debugger does not do the remaining steps.A 3. Evaluates the expression in a WHEN clause, if yo Æu specified: one when you set the breakpoint. If the value of theB expression is false, execution resumes and the debugger does! not do the remaining steps.C 4. Reports that execution has reached the breakpoint location byE issuing a "break . . . " message, unless you specified /SILENT.< 5. Displays the line of source code at which execution is? suspended, unless you specified /NOSOURCE or /SILENT whenA you set the breakpoint or unless you previously Çentered SET STEP NOSOURCE.@ 6. Executes the commands in a DO clause, if you specified oneA when you set the breakpoint. If the DO clause contains a GOD command, execution continues and the debugger does not perform the next step. 7. Issues the prompt.@ You set a breakpoint at a particular location in your programB by specifying an address expression with the SET BREAK command.? You set a breakpoint on consecutive source lines, classes ofA instructi Èons, or events by specifying a qualifier with the SET? BREAK command. Generally, you must specify either an addressA expression or a qualifier, but not both. Exceptions are /EVENT and /RETURN.? The /LINE qualifier sets a breakpoint on each line of source code.9 The following qualifiers set breakpoints on classes of= instructions. Using these qualifiers with /LINE causes the< debugger to trace every instruction of your program as it8 executes and thus significantÉly slows down execution: /BRANCH /CALL /INSTRUCTION /RETURNB The following qualifiers affect what happens at a routine call: /INTO /OVER /[NO]SHARE /[NO]SYSTEM 4 Description,_Continued...B The following qualifiers affect what output is displayed when a breakpoint is reached: /[NO]SILENT /[NO]SOURCE= The following qualifiers affect the timing and duration of breakpoints: /AFTERÊ:n /TEMPORARYD Use the /MODIFY qualifier to monitor changes at program locations2 (typically changes in the values of variables).: If you set a breakpoint at a location currently used as; a tracepoint, the tracepoint is canceled in favor of the breakpoint, and vice versa.C On OpenVMS Alpha and Integrity servers, the SET BREAK/UNALIGNED_B DATA command calls the $START_ALIGN_FAULT_REPORT system service< routine. Do not issue this command if the program you areB Ë debugging includes a call to the same $START_ALIGN_FAULT_REPORTA routine. If you issue the command before the program call, theB program call fails. If the program call occurs before you issue- the command, unaligned breaks are not set.> Breakpoints can be user defined or predefined. User-defined= breakpoints are set explicitly with the SET BREAK command.B Predefined breakpoints, which depend on the type of program youD are debugging (for example, Ada or multiprocess), are e Ìstablished@ automatically when you start the debugger. Use the SHOW BREAKB command to identify all breakpoints that are currently set. Any1 predefined breakpoints are identified as such.? User-defined and predefined breakpoints are set and canceled@ independently. For example, a location or event can have bothB a user-defined and a predefined breakpoint. Canceling the user-D defined breakpoint does not affect the predefined breakpoint, and conversely. Related commandÍs:- (ACTIVATE,DEACTIVATE,SHOW,CANCEL) BREAK CANCEL ALL GO (SET,SHOW) EVENT_FACILITY SET STEP [NO]SOURCE SET TRACE SET WATCH STEP 4 Examples! 1.DBG> SET BREAK SWAP\%LINE 12C This command causes the debugger to break on line 12 of module SWAP. 2.DBG> SET BREAK/AFTER:3 SUB2? This command causes the debugger to break on the third and8 subsequent times that SUB2 (a routine) is executed.@ 3.DBG Î> SET BREAK/NOSOURCE LOOP1 DO (EXAM D; STEP; EXAM Y; GO)D This command causes the debugger to break at location LOOP1. AtD the breakpoint, the following commands are issued, in the orderB given: (1) EXAMINE D, (2) STEP, (3) EXAMINE Y, and (4) GO.B The /NOSOURCE qualifier suppresses the display of source code at the breakpoint.5 4.DBG> SET BREAK ROUT3 WHEN (X > 4) DO (EXAMINE Y)D This command causes the debugger to break on routine ROUT3 whenB X is greaÏter than 4. At the breakpoint, the EXAMINE Y commandD is issued. The syntax of the conditional expression in the WHEN" clause is language-dependent." 5.DBG> SET BREAK/TEMPORARY 1440 DBG> SHOW BREAK# breakpoint at 1440 [temporary] DBG>? This command sets a temporary breakpoint at memory address= 1440. After that breakpoint is triggered, it disappears. 6.DBG> SET BREAK/LINEB This command causes the debugger to break on the beginning of< e Ðvery source line encountered during program execution.( 7.DBG> SET BREAK/LINE WHEN (X .NE. 0)/ DBG> SET BREAK/INSTRUCTION WHEN (X .NE. 0)A These two commands cause the debugger to break when X is notA equal to 0. The first command tests for the condition at theA beginning of every source line encountered during execution.D The second command tests for the condition at each instruction.C The syntax of the conditional expression in the WHEN clause is languÑage-dependent. 8.DBG> SET BREAK/RETURN ROUT4B This command causes the debugger to break whenever the return: instruction of routine ROUT4 is about to be executed.? 9.DBG> SET BREAK/EXCEPTION DO (SET MODULE/CALLS; SHOW CALLS)D This command causes the debugger to break whenever an exceptionB is signaled. At the breakpoint, the SET MODULE/CALLS and SHOW CALLS commands are issued. 10all> SET BREAK/ACTIVATINGD This command causes the debugger to breakÒ whenever a process of> a multiprocess program is brought under debugger control. 3 DEFINEA Establishes a default qualifier (/ADDRESS, /COMMAND, /PROCESS_, GROUP, or /VALUE) for the DEFINE command. Format SET DEFINE define-default 4 Parameters define-defaultB Specifies the default to be established for the DEFINE command.A Valid keywords (which correspond to DEFINE command qualifiers) are as follows:= ADDRESS Subsequent D ÓEFINE commands are treated as8 DEFINE/ADDRESS. This is the default.= COMMAND Subsequent DEFINE commands are treated as# DEFINE/COMMAND.= PROCESS_SET Subsequent DEFINE commands are treated as' DEFINE/PROCESS_SET.= VALUE Subsequent DEFINE commands are treated as! DEFINE/VALUE. 4 Description= The SET DEFINE command establishes a default qualifier forA subsequent DEFINE c Ôommands. The parameters that you specify inC the SET DEFINE command have the same names as the qualifiers forB the DEFINE command. The qualifiers determine whether the DEFINED command binds a symbol to an address, a command string, a list of processes, or a value.B You can override the current DEFINE default for the duration ofC a single DEFINE command by specifying another qualifier. Use the? SHOW DEFINE command to identify the current DEFINE defaults. Related commaÕnds: DEFINE DEFINE/PROCESS_SET DELETE SHOW DEFINE SHOW SYMBOL/DEFINED 4 Example DBG> SET DEFINE VALUEB The SET DEFINE VALUE command specifies that subsequent DEFINE* commands are treated as DEFINE/VALUE. 3 EDITOR> Establishes the editor that is started by the EDIT command. Format SET EDITOR [command-line] 4 Parameters command-line@ Specifies a command line to start a particular editor on yoÖur( system when you use the EDIT command.@ You need not specify a command line if you use /CALLABLE_EDT,? /CALLABLE_LSEDIT, or /CALLABLE_TPU. If you do not use one ofC these qualifiers, the editor specified in the SET EDITOR commandC line is spawned to a subprocess when you enter the EDIT command.: You can specify a command line with /CALLABLE_LSEDIT or, /CALLABLE_TPU but not with /CALLABLE_EDT. 4 Qualifiers /CALLABLE_EDTC Specifies that the callable v×ersion of the EDT editor is startedD when you use the EDIT command. Do not specify a command line with4 this qualifier (a command line of "EDT" is used). /CALLABLE_TPUA Specifies that the callable version of the VSI Text ProcessingA Utility (TPU) is started when you use the EDIT command. If you@ also specify a command line, it is passed to callable TPU. IfA you do not specify a command line, the default command line is TPU. /START_POSITION /START_P ØOSITION! /NOSTART_POSITION (default)= Controls whether the /START_POSITION qualifier is appended> to the specified or default command line when you enter the: EDIT command. Currently, only TPU and the VSI Language-B Sensitive Editor (specified as TPU or /CALLABLE_TPU, and LSEDIT= or /CALLABLE_LSEDIT, respectively) support this qualifier.@ The /START_POSITION qualifier affects the initial position ofD the editor's cursor. By default (/NOSTART_POSITION), the editor'sA Ù cursor is placed at the beginning of source line 1, regardless@ of which line is centered in the debugger's source display or@ whether you specify a line number in the EDIT command. If you> specify /START_POSITION, the cursor is placed either on the@ line whose number you specify in the EDIT command, or (if youD do not specify a line number) on the line that is centered in the current source display. 4 DescriptionC The SET EDITOR command enables you to specify any edi Útor that isC installed on your system. In general, the command line specifiedD as parameter to the SET EDITOR command is spawned and executed in a subprocess.= On Alpha and Integrity servers, if you use EDT, LSEDIT, or< TPU, you can start these editors in a more efficient way.B You can specify /CALLABLE_EDT or /CALLABLE_TPU which causes the? callable versions of EDT and TPU respectively, to be invoked@ by the EDIT command. In the case of TPU, you can also specify: a cÛommand line that is executed by the callable editor.C On Alpha processors, you can use /CALLABLE_EDT or /CALLABLE_TPU, but not /CALLABLE_LSEDIT. Related commands: EDIT (SET,SHOW,CANCEL) SOURCE SHOW DEFINE 4 Examples$ 1.DBG> SET EDITOR '@MAIL$EDIT ""'C This command causes the EDIT command to spawn the command line@ '@MAIL$EDIT ""', which starts the same editor as you use in MAIL.! 2.DBG> SET EDITOR/CALLABLE_TPU? This Ücommand causes the EDIT command to start callable TPU* with the default command line of TPU.B 3.DBG> SET EDITOR/CALLABLE_TPU TPU/SECTION=MYSECINI.TPU$SECTION? This command causes the EDIT command to start callable TPU< with the command line TPU/SECTION=MYSECINI.TPU$SECTION.0 4.DBG> SET EDITOR/CALLABLE_EDT/START_POSITION? This command causes the EDIT command to start callable EDTC with the default command line of EDT. Also the /START_POSITIONC qualifier iÝs appended to the command line, so that the editing> session starts on the source line that is centered in the' debugger's current source display. 3 EVENT_FACILITY* Establishes the current event facility.D Event facilities are available for programs that call Ada or SCAN/ routines or that use POSIX threads services. Format& SET EVENT_FACILITY facility-name 4 Parameters facility-nameC Specifies an event facility. Valid facility-name Þkeywords are as follows:C ADA If the event facility is set to ADA, the (SET,CANCEL)B BREAK and (SET,CANCEL) TRACE commands recognize Ada-@ specific events as well as generic, low-level task? events. (Ada events consist of task and exception events.)D You can set the event facility to ADA only if the mainB program is written in Ada or if the program calls an Ada routine.: THREADS ß If the event facility is set to THREADS, the@ (SET,CANCEL) BREAK and (SET,CANCEL) TRACE commandsB recognize POSIX threads-specific as well as generic,A low-level task events. All POSIX threads events are# task (thread) events.? You can set the event facility to THREADS only ifB the shareable image CMA$RTL is currently part of theB program's process (if that image is listed in a SHOW à IMAGE display). 4 DescriptionA The current event facility (ADA, THREADS, or SCAN) defines the@ eventpoints that you can set with the SET BREAK/EVENT and SET TRACE/EVENT commands.; When started with a program that is linked with an event> facility, the debugger automatically sets the facility in aB manner appropriate for the type of program. For example, if theD main program is written in Ada or SCAN, the event facility is set to ADA or SCAN, respectively.A á The SET EVENT_FACILITY command enables you to change the event> facility and thereby change your debugging context. This is? useful if you have a multilanguage program and want to debug? a routine that is associated with an event facility but that! facility is not currently set.< Use the SHOW EVENT_FACILITY command to identify the eventB names associated with the current event facility. These are theB keywords that you can specify with the (SET,CANCEL) BREAK/EVENT) and (âSET,CANCEL) TRACE/EVENT commands. Related commands: (SET,CANCEL) BREAK/EVENT (SET,CANCEL) TRACE/EVENT SHOW BREAK SHOW EVENT_FACILITY SHOW IMAGE SHOW TASK SHOW TRACE 4 Example DBG> SET EVENT_FACILITY THREADSD This command establishes THREADS (POSIX threads) as the current event facility. 3 IMAGE@ Loads symbol information for one or more shareable images and! establishes the current image. Formatã& SET IMAGE [image-name[, . . . ]] 4 Parameters image-nameA Specifies a shareable image to be set. Do not use the asteriskC (*) wildcard character. Instead, use the /ALL qualifier. Do not# specify an image name with /ALL. 4 Qualifiers /ALL/ Specifies that all shareable images are set. 4 Description? The SET IMAGE command builds data structures for one or moreB specified images but does not set any modules within the images s äpecified.? The current image is the current debugging context: you haveB access to symbols in the current image. If you specify only oneC image with the SET IMAGE command, that image becomes the currentC image. If you specify a list of images, the last one in the listD becomes the current image. If you specify /ALL, the current image is unchanged.A Before an image can be set with the SET IMAGE command, it mustB have been linked with the /DEBUG or /TRACEBACK qualifier åon theC DCL command LINK. If an image was linked /NOTRACEBACK, no symbolD information is available for that image and you cannot specify it with the SET IMAGE command.? Definitions created with the DEFINE/ADDRESS and DEFINE/VALUEC commands are available only when the image in whose context they@ were created is the current image. When you use the SET IMAGEB command to establish a new current image, these definitions areA temporarily unavailable. However, definitions creatæed with the? DEFINE/COMMAND and DEFINE/KEY commands are available for all images. Related commands: SET MODE [NO]DYNAMIC (SET,SHOW,CANCEL) MODULE (SHOW,CANCEL) IMAGE 4 Example DBG> SET IMAGE SHARE1 DBG> SET MODULE SUBR DBG> SET BREAK SUBR? This sequence of commands shows how to set a breakpoint onC routine SUBR in module SUBR of shareable image SHARE1. The SET@ IMAGE command sets the debugging context to SHARE1. The SET@ MçODULE command loads the symbol records of module SUBR intoB the run-time symbol table (RST). The SET BREAK command sets a breakpoint on routine SUBR. 3 KEY% Establishes the current key state.& NOTEC This command is not available in the VSI DECwindows Motif for- OpenVMS user interface to the debugger. Format SET KEY 4 Qualifiers /LOG /LOG (default) /NOLOGB Controls whether a meèssage is displayed indicating that the keyC state has been set. The /LOG qualifier displays the message. The+ /NOLOG qualifier suppresses the message. /STATE /STATE[=state-name] /NOSTATE (default)@ Specifies a key state to be established as the current state.; You can specify a predefined key state, such as GOLD, or< a user-defined state. A state name can be any appropriateA alphanumeric string. The /NOSTATE qualifier leaves the current state unchang éed. 4 DescriptionC Keypad mode must be enabled (SET MODE KEYPAD) before you can use3 this command. Keypad mode is enabled by default.? By default, the current key state is the DEFAULT state. WhenA you define function keys, you can use the DEFINE/KEY /IF_STATEA command to assign a specific state name to the key definition.B If that state is not set when you press the key, the definitionD is not processed. The SET KEY/STATE command enables you to change. the curreênt state to the appropriate state.: You can also change the current state by pressing a key: that causes a state change (a key that was defined with$ DEFINE/KEY/LOCK_STATE/SET_STATE). Related commands: DELETE/KEY DEFINE/KEY SHOW KEY 4 Example DBG> SET KEY/STATE=PROG3? This command changes the key state to the PROG3 state. YouB can now use the key definitions that are associated with this state. 3 LANGUAGE$ Establishesë the current language. Format SET LANGUAGE language-name 4 Parameters language-name Specifies a language.= On Integrity servers, you can specify one of the following keywords:$ AMACRO BASIC BLISS C) C++ COBOL Fortran PASCAL UNKNOWNC On Alpha systems, you can specify one of the following keywords:( ADA AMACRO BASIC BLISS* C C++ COBOL FORTRAN* MACRO MACRO64 ìPASCAL UNKNOWN6 MACRO-32 must be compiled with the AMACRO compiler. 4 DescriptionC When you start the debugger, the current language is set to thatC in which the module containing the main program is written. ThisB is usually the module containing the image transfer address. ToB debug a module written in a different source language from that@ of the main program, you can change the language with the SET LANGUAGE command.B The current language setting determin íes how the debugger parsesC and interprets the names, operators, and expressions you specify< in debugger commands, including things like the typing of@ variables, array and record syntax, the default radix for theB entry and display of integer data, case sensitivity, and so on.D The language setting also determines how the debugger formats and. displays data associated with your program.C The default radix for both data entry and display is decimal forC most languages. The î exceptions are BLISS and MACRO, which have a default radix of hexadecimal.< The default type for program locations that do not have aC compiler-generated type is longword integer. This is appropriate% for debugging 32-bit applications.= It is advisable to change the default type to quadword for? debugging applications that use the 64-bit address space (onC OpenVMS Integrity server systems, the default type is quadword).% Use the SET TYPE QUADWORD command.@ Use ï the SET LANGUAGE UNKNOWN command when debugging a program@ written in an unsupported language. To maximize the usabilityC of the debugger with unsupported languages, SET LANGUAGE UNKNOWN@ causes the debugger to accept a large set of data formats andA operators, including some that might be specific to only a few supported languages.B Note that SET LANGUAGE UNKNOWN can be an easy, quick workaroundB for language-related problems because it uses the "loosest" set of rules.ð? For information about debugger support for language-specificA operators and constructs, see the Language_Support help topic. Related commands: EVALUATE EXAMINE DEPOSIT SET MODE SET RADIX SET TYPE SHOW LANGUAGE 4 Examples 1.DBG> SET LANGUAGE COBOL< This command establishes COBOL as the current language. 2.DBG> SET LANGUAGE PASCAL= This command establishes Pascal as the current language. ñ4 /DYNAMIC3 Toggles the state of automatic language setting. Format SET LANGUAGE/DYNAMIC 5 DescriptionC When you start the debugger, the current language is set to thatC in which the module containing the main program is written. ThisB is usually the module containing the image transfer address. ByC default, when the scope of the program being executed changes toA a module written in a different language, the debugger changes. the current language toò that of the module.? You can prevent the debugger from automatically changing the< current language with the SET LANGUAGE/NODYNAMIC command. Related commands: SET LANGUAGE SHOW LANGUAGE 5 Examples 1.DBG> SET LANGUAGE/NODYNAMICA This command prevents the debugger from changing the currentD language until you enter a SET LANGUAGE or SET LANGUAGE/DYNAMIC command. 3 LOG@ Specifies a log file to which the debugger writes after aó SET' OUTPUT LOG command has been entered. Format SET LOG file-spec 4 Parameters file-spec< Denotes the file specification of the log file. If you do= not supply a full file specification, the debugger assumesA SYS$DISK:[]DEBUG.LOG as the default file specification for any missing field.? If you specify a version number and that version of the file= already exists, the debugger writes to the file specified,B appending the log of the ôdebugging session onto the end of that file. 4 DescriptionA The SET LOG command determines only the name of a log file; itB does not cause the debugger to create or write to the specified6 file. The SET OUTPUT LOG command accomplishes that.B If you entered a SET OUTPUT LOG command but no SET LOG command,C the debugger writes to the file SYS$DISK:[]DEBUG.LOG by default.C If the debugger is writing to a log file and you specify anotherD log file with the SET LOG cõommand, the debugger closes the former? file and begins writing to the file specified in the SET LOG command. Related commands: SET OUTPUT LOG SET OUTPUT SCREEN_LOG SHOW LOG 4 Examples 1.DBG> SET LOG CALC DBG> SET OUTPUT LOG@ In this example, the SET LOG command specifies the debuggerC log file to be SYS$DISK:[]CALC.LOG. The SET OUTPUT LOG command? causes user input and debugger output to be logged to that file.% ö 2.DBG> SET LOG [CODEPROJ]FEB29.TMP DBG> SET OUTPUT LOG@ In this example, the SET LOG command specifies the debuggerC log file to be [CODEPROJ]FEB29.TMP. The SET OUTPUT LOG command? causes user input and debugger output to be logged to that file. 3 MARGINS= Specifies the leftmost and rightmost source-line character? position at which to begin and end display of a source line.& NOTEC This command is not availabl÷e in the VSI DECwindows Motif for- OpenVMS user interface to the debugger. Format SET MARGINS rm lm:rm lm: :rm 4 Parameters lmB The source-line character position at which to begin display of- the line of source code (the left margin). rmD The source-line character position at which to end display of the* line of source code (the right margin). 4 DescriptionD The ø SET MARGINS command affects only the display of source lines.C It does not affect the display of other debugger output, as from an EXAMINE command.@ The SET MARGINS command is useful for controlling the display@ of source code when, for example, the code is deeply indentedA or long lines wrap at the right margin. In such cases, you can@ set the left margin to eliminate indented space in the sourceC display, and you can decrease the right margin setting (from its@ default ù value of 255) to truncate lines and prevent them from wrapping.D The SET MARGINS command is useful mostly in line (noscreen) mode.? In line mode, the SET MARGINS command affects the display ofA source lines resulting from a TYPE, EXAMINE/SOURCE, SEARCH, orC STEP command, or when a breakpoint, tracepoint, or watchpoint is triggered.; In screen mode, the SET MARGINS command has no effect on? the display of source lines in a source display, such as theB predefined údisplay SRC. Therefore it does not affect the output< of a TYPE or EXAMINE/SOURCE command, since that output is@ directed at a source display. The SET MARGINS command affects> only the display of any source code that might appear in an> output or DO display (for example, after a STEP command has@ been executed). However, such source-code display is normallyD suppressed if you enable screen mode by pressing PF1-PF3, becauseD that sequence issues the SET STEP NOSOURCE command as wel ûl as SET5 MODE SCREEN to eliminate redundant source display.> By default, the debugger displays a source line starting at< character position 1 of the source line. This is actually@ character position 9 on your terminal screen. The first eight> character positions on the screen are reserved for the line? number and cannot be manipulated by the SET MARGINS command.D If you specify a single number, the debugger sets the left margin5 to 1 and the right margin to the number s üpecified.C If you specify two numbers, separated with a colon, the debuggerB sets the left margin to the number on the left of the colon and/ the right margin to the number on the right.C If you specify a single number followed by a colon, the debuggerB sets the left margin to that number and leaves the right margin unchanged.C If you specify a colon followed by a single number, the debuggerB sets the right margin to that number and leaves the left margin unchaýnged. Related commands: SET STEP [NO]SOURCE SHOW MARGINS 4 Examples 1.DBG> SHOW MARGINS' left margin: 1 , right margin: 255 DBG> TYPE 14 module FORARRAYB 14: DIMENSION IARRAY(4:5,5), VECTOR(10), I3D(3,3,4) DBG>D This example displays the default margin settings for a line of source code (1 and 255). 2.DBG> SET MARGINS 39 DBG> SHOW MARGINS& left margin: 1 , right margin: 39 DBG> TYPE 14þ module FORARRAY2 14: DIMENSION IARRAY(4:5,5), VECTOR DBG>@ This example shows how the display of a line of source codeA changes when you change the right margin setting from 255 to 39. 3.DBG> SET MARGINS 10:45 DBG> SHOW MARGINS' left margin: 10 , right margin: 45 DBG> TYPE 14 module FORARRAY/ 14: IMENSION IARRAY(4:5,5), VECTOR(10), DBG>C This example shows the display of the same line of source codeÿ$ after both margins are changed. 4.DBG> SET MARGINS :100 DBG> SHOW MARGINS( left margin: 10 , right margin: 100 DBG>D This example shows how to change the right margin setting while0 retaining the previous left margin setting. 5.DBG> SET MARGINS 5: DBG> SHOW MARGINS' left margin: 5 , right margin: 100 DBG>C This example shows how to change the left margin setting while1 retaining the previous right margin setting. 3 MODE' Enables or disables a debugger mode. Format SET MODE mode[, . . . ] 4 Parameters DYNAMIC@ (Default) Enables dynamic mode. When dynamic mode is enabled,D the debugger sets modules and images automatically during program? execution so that you typically do not have to enter the SETC MODULE or SET IMAGE command. Specifically, whenever the debuggerD interrupts execution (whenever the debugger prompt is displayed),D the debugger automati cally sets the module and image that contain@ the routine in which execution is currently suspended. If the= module or image is already set, dynamic mode has no effect@ on that module or image. The debugger issues an informational9 message when its sets a module or image automatically. NODYNAMIC@ Disables dynamic mode. Because additional memory is allocatedC when a module or image is set, you might want to disable dynamic> mode if performance becomes a problem (you can also free up@ memory by canceling modules and images with the CANCEL MODULEA and CANCEL IMAGE commands). When dynamic mode is disabled, youA must set modules and images explicitly with the SET MODULE and SET IMAGE commands. G_FLOATC Specifies that the debugger interpret double-precision floating-> point constants entered in expressions as G_FLOAT (does notD affect the interpretation of variables declared in your program). NOG_FLOATC (Default) Specifies that the debugger interpret double-precisionC floating-point constants entered in expressions as D_FLOAT (does> not affect the interpretation of variables declared in your program). INTERRUPT@ Useful when debugging a multiprocess program. Specifies that,C when program execution is suspended in any process, the debuggerB interrupts execution in all other processes that were executing images and prompts for input. NOINTERRUPTD (Default) Useful when debugging a multiprocess program. Specifies@ that, when program execution is suspended in any process, the8 debugger take no action with regard to other process. KEYPAD& NOTEA This parameter is not available in the VSI DECwindows Motif1 for OpenVMS user interface to the debugger.> (Default) Enables keypad mode. When keypad mode is enabled,@ you can use the keys on the numeric keypad to perform certain> predefined functions. Several debugger commands, especially@ useful in screen mode, are bound to the keypad keys. (See theC Keypad_Definitions_CI help topic; also, use the SHOW KEY commandC to determine the current key definitions.) You can also redefine1 the key functions with the DEFINE/KEY command. NOKEYPAD& NOTEA This parameter is not available in the VSI DECwindows Motif1 for OpenVMS user interface to the debugger.B Disables keypad mode. When keypad mode is disabled, the keys onC the numeric keypad do not have predefined functions, nor can youD assign debugger functions to those keys with DEFINE/KEY commands. LINEB (Default) Specifies that the debugger display program locations) in terms of line numbers, if possible. NOLINED Specifies that the debugger display program locations as routine-; name + byte-offset rather than in terms of line numbers. OPERANDS[=keyword]; Specifies that the EXAMINE command, when used to examine: an instruction, display the address and contents of the< instruction's operands in addition to the instruction and= its operands. The level of information displayed about anyD nonregister operands depends on whether you use the keyword BRIEF* or FULL. The default is OPERANDS=BRIEF. NOOPERANDS= (Default) Specifies that the EXAMINE command, when used to? examine an instruction, display only the instruction and its operands.  SCREEN& NOTEA This parameter is not available in the VSI DECwindows Motif1 for OpenVMS user interface to the debugger.C Enables screen mode. When screen mode is enabled, you can divideB the terminal screen into rectangular regions, so different dataD can be displayed in different regions. Screen mode enables you toB view more information more conveniently than the default, line-C oriented, noscreen mode. You can use the predefined  displays, or you can define your own. NOSCREEN& NOTEA This parameter is not available in the VSI DECwindows Motif1 for OpenVMS user interface to the debugger." (Default) Disables screen mode. SCROLL& NOTEA This parameter is not available in the VSI DECwindows Motif1 for OpenVMS user interface to the debugger.B Enables scroll mode. When scroll mode is enabled, a scr een-modeB output or DO display is updated by scrolling the output line by< line, as it is generated. SET MODE SCROLL is the default. NOSCROLL& NOTEA This parameter is not available in the VSI DECwindows Motif1 for OpenVMS user interface to the debugger.D Disables scroll mode. When scroll mode is disabled, a screen-modeA output or DO display is updated only once per command, insteadD of line by line as it is generated. Disab ling scroll mode reducesC the amount of screen updating that takes place and can be useful with slow terminals. SEPARATE? (Applies only to workstations running VWS.) Specifies that aA separate window be created for debugger input and output. This= feature is useful when debugging screen-oriented programs,@ because it moves all debugger displays out of the window thatB contains the program's input and output. The separate window isD created with a height of 24 lin es and a width of 80 columns wide,) emulating a VT-series terminal screen. NOSEPARATEA (Applies only to workstations running VWS. Default.) SpecifiesD that no separate window be created for debugger input and output. SYMBOLIC9 (Default) Enables symbolic mode. When symbolic mode isB enabled, the debugger displays the locations denoted by addressB expressions symbolically (if possible) and displays instructionA operands symbolically (if possible). EXAMINE/NOSYMB OLIC can beD used to override SET MODE SYMBOLIC for the duration of an EXAMINE command. NOSYMBOLIC> Disables symbolic mode. When symbolic mode is disabled, the? debugger does not attempt to symbolize numeric addresses (itD does not cause the debugger to convert numbers to names). This is@ useful if you are interested in identifying numeric addresses< rather than their symbolic names (if symbolic names exist@ for those addresses). When symbolic mode is disabled, commandD processing might speed up somewhat, because the debugger does notA need to convert numbers to names. EXAMINE/SYMBOLIC can be usedA to override SET MODE NOSYMBOLIC for the duration of an EXAMINE command. WAIT? (Default) Enables wait mode. In wait mode the debugger waits< until all processes under its control have stopped before prompting for a new command. NOWAIT> Disable wait mode. In nowait mode, the debugger immediatelyC prompts for new commands even if some or all processes are still running. 4 Description< For details about the SET MODE command, see the parameter? descriptions. The default values of these modes are the same for all languages. Related commands: EVALUATE EXAMINE DEFINE/KEY DEPOSIT DISPLAY (SET,SHOW,CANCEL) IMAGE (SET,SHOW,CANCEL) MODULE SET PROMPT (SET,SHOW,CANCEL) RADIX (SET,SHOW) TYPE (SHOW,CANCEL) MODE SYMBOLIZE 4 Example DBG> SET MODE SCREEN3 This command puts the debugger in screen mode. 3 MODULEA Loads the symbol records of a module in the current image into1 the run-time symbol table (RST) of that image.& NOTES@ The current image is either the main image (by default) orB the image established as the current image by a previous SET IMAGE command.? By default, the debugger automatically loads symbols in aB module as needed. As such, this behavior makes the use of anA explicit SET MODULE command optional. For more information, see SET MODE DYNAMIC. Format( SET MODULE [module-name[, . . . ]] 4 Parameters module-name? Specifies a module of the current image whose symbol recordsA are loaded into the RST. Do not use the asterisk (*) wildcard? character. Instead, use the /ALL qualifier. Do not specify a# module name with /ALL or /CALLS. 4 Qualifiers /ALLB Specifies that the symbol records of all modules in the current image be loaded into the RST. /CALLS@ Sets all the modules that currently have routines on the callB stack. If a module is already set, /CALLS has no effect on that module. /RELATED /RELATED (default) /NORELATEDA (Applies to Ada programs.) Controls whether the debugger loadsC into the RST the symbol records of a module that is r elated to aB specified module through a with-clause or subunit relationship.C Once loaded, you can reference names declared in related modulesD within debugger commands exactly as you reference them within the Ada source code. 4 DescriptionA The SET MODULE command loads the symbol records of a module inA the current image into the run-time symbol table (RST) of thatC image. Symbol records must be present in the RST if the debuggerA is to recognize and properly interpret the symbols declared inD your program. The process by which the symbol records of a moduleC are loaded into the RST is called setting a module. This commandD also supports user-provided mixed-case and lowercase module names" on Integrity and Alpha servers.? At debugger startup, the debugger sets the module containing? the transfer address (the main program). By default, dynamicC mode is enabled (SET MODE DYNAMIC). Therefore, the debugger sets@ modules (and imag es) automatically as the program executes soA that you can reference symbols as you need them. Specifically,@ whenever execution is suspended, the debugger sets the moduleD and image containing the routine in which execution is suspended.C In the case of Ada programs, as a module is set dynamically, itsB related modules are also set automatically, by default, to make0 the appropriate symbols accessible (visible).C Dynamic mode makes accessible most of the symbols you might needC to reference. If you need to reference a symbol in a module that* is not already set, proceed as follows:? o If the module is in the current image, use the SET MODULE> command to set the module where the symbol is defined or@ reference the symbol with a fully-qualified path name. For example: DBG>SET BREAK X\YB o If the module is in another image, use the SET IMAGE commandC to make that image the current image, then use the SET MODULE< command to set the module where the symbol is defined.D If dynamic mode is disabled (SET MODE NODYNAMIC), only the moduleA containing the transfer address is set automatically. You must$ set any other modules explicitly.> If you use the SET IMAGE command to establish a new currentB image, all modules previously set remain set. However, only theB symbols in the set modules of the current image are accessible.= Symbols in the set modules of other images are temporarily ina ccessible.B When dynamic mode is enabled, memory is allocated automaticallyA to accommodate the increasing size of the RST. If dynamic modeC is disabled, the debugger automatically allocates more memory as, needed when you set a module or an image.= If a parameter in a SET SCOPE command designates a program> location in a module that is not already set, the SET SCOPE command sets that module.6 For information specific to Ada programs, type Help Language_Support Ada. Related commands: (SET,SHOW,CANCEL) IMAGE SET MODE [NO]DYNAMIC (SHOW) MODULE 4 Examples 1.DBG> SET MODULE SUB1? This command sets module SUB1 (loads the symbol records of module SUB1 into the RST). 2.DBG> SET IMAGE SHARE3 DBG> SET MODULE MATH DBG> SET BREAK %LINE 31A In this example, the SET IMAGE command makes shareable imageA SHARE3 the current image. The SET MODULE command sets moduleB MATH in ima ge SHARE3. The SET BREAK command sets a breakpoint on line 31 of module MATH. 3.DBG> SHOW MODULE/SHARE4 module name symbols language size4 FOO yes MACRO 4324 MAIN no FORTRAN 280 . . .4 SHARE$DEBUG no Image 04 SHARE$LIBRTL no Image 04 SHARE$MTHRTL no Image 04 SHARE$SHARE1 no Image  04 SHARE$SHARE2 no Image 0= total modules: 17. bytes allocated: 162280.! DBG> SET MODULE SHARE$SHARE2' DBG> SHOW SYMBOL * IN SHARE$SHARE2B In this example, the SHOW MODULE/SHARE command identifies all? modules in the current image and all shareable images (the= names of the shareable images are prefixed with SHARE$).A The SET MODULE SHARE$SHARE2 command sets the shareable image@ module SHARE$SHARE2. The SHOW SYMBOL command identifies anyA universal symbols defined in the shareable image SHARE2. For9 more information, see the SHOW MODULE/SHARE command. 4.DBG> SET BREAK X/Y:A In this example, the debugger automatically loads the moduleA information when you specify the module name in the command.A Debugger ensures that the module information for module X isC loaded, and then locates the information for the routine named Y. 3 OUTPUT0 Enables or disables a debugger output option. Format( SET OUTPUT output-option[, . . . ] 4 Parameters output-option> Specifies an output option to be enabled or disabled. Valid keywords are as follows:D LOG Specifies that debugger input and output be recorded= in a log file. If you specify the log file by@ the SET LOG command, the debugger writes to thatB file; otherwise, by default the debugger writes to % SYS$DISK[]:DEBUG.LOG.B NOLOG (Default) Specifies that debugger input and output. not be recorded in a log file.@ SCREEN_LOG Specifies that, while in screen mode, the screenC contents be recorded in a log file as the screen isB updated. To log the screen contents, you must alsoB specify SET OUTPUT LOG. See the description of the= LOG option regarding specifying the log file.C NOSCREEN_ (Default) Specifies that the screen contents, while> LOG in screen mode, not be recorded in a log file. TERMINAL. NOTE@ This parameter is not available in the VSIA DECwindows Motif for OpenVMS user interface& to the debugger.; (Default) Specifies that debugger output be* displayed at the terminal. NOTERMINAL.  NOTE@ This parameter is not available in the VSIA DECwindows Motif for OpenVMS user interface& to the debugger.A Specifies that debugger output, except diagnostic; messages, not be displayed at the terminal.@ VERIFY Specifies that the debugger echo, on the currentC output device, each input command string that it isD executing fr !om a command procedure or DO clause. TheD current output device is by default SYS$OUTPUT (yourD terminal) but can be redefined with the logical name DBG$OUTPUT.A NOVERIFY (Default) Specifies that the debugger not displayC each input command string that it is executing from1 a command procedure or DO clause. 4 Description< Debugger output options control the way in which debugger@ responses to comm"ands are displayed and recorded. For details@ about the SET OUTPUT command, see the parameter descriptions. Related commands: @ (Execute Procedure) (SET,SHOW) ATSIGN (SET,SHOW) LOG SET MODE SCREEN SHOW OUTPUT 4 Example& DBG> SET OUTPUT VERIFY,LOG,NOTERMINAL@ This command specifies that the debugger take the following actions:> o Output each command string that it is executing from a/ command procedure or DO clau#se (VERIFY)A o Record debugger output and user input in a log file (LOG)= o Not display output at the terminal, except diagnostic messages (NOTERMINAL) 3 PROCESS> Establishes the visible process or enables/disables dynamic process setting.@ Used only when debugging multiprocess programs (kept debugger only). Format* SET PROCESS [process-spec[, . . . ]] 4 Parameters process-specC Specifies a process currently und $er debugger control. Use any of the following forms:D [%PROCESS_NAME] process- The process name, if that name does notD name contain spaces or lowercase characters.= The process name can include the> asterisk (*) wildcard character.D [%PROCESS_NAME] The process name, if that name contains@ "process-name " spaces or lowercase characters. YouD can also us %e apostrophes (') instead of1 quotation marks (").; %PROCESS_PID process_id The process identifier (PID, a1 hexadecimal number).B [%PROCESS_NUMBER] The number assigned to a process when? process-number it comes under debugger control. AA (or %PROC process- new number is assigned sequentially,A number) starting with 1, to each process. IfB a process i &s terminated with the EXIT? or QUIT command, the number can be@ assigned again during the debuggingA session. Process numbers appear in a@ SHOW PROCESS display. Processes areC ordered in a circular list so they canA be indexed with the built-in symbolsA %PREVIOUS_PROCESS and %NEXT_PROCESS.6 pro 'cess-set-name A symbol defined with theD DEFINE/PROCESS_SET command to represent2 a group of processes.? %NEXT_PROCESS The next process after the visible? process in the debugger's circular* process list.@ %PREVIOUS_PROCESS The process previous to the visible? process in the debugger's circular* ( process list.C %VISIBLE_PROCESS The process whose stack, register set,C and images are the current context forA looking up symbols, register values,C routine calls, breakpoints, and so on.C You can also use the asterisk (*) wildcard character to specify process set all.< Do not specify a process with the /[NO]DYNAMIC qualifier. 4 Qualifiers /DYNAMIC /DYNAM )IC (default) /NODYNAMICC Controls whether dynamic process setting is enabled or disabled.C When dynamic process setting is enabled (/DYNAMIC), whenever theC debugger suspends execution and displays its prompt, the processD in which execution is suspended automatically becomes the visibleB process. When dynamic process setting is disabled (/NODYNAMIC),B the visible process remains unchanged until you specify another0 process with the SET PROCESS/VISIBLE command. */VISIBLEA Makes the specified process the visible process. This switchesB your debugging context to the specified process, so that symbol> lookups and the setting of breakpoints, and so on, are done@ in the context of that process. When using /VISIBLE, you must specify one process. 4 DescriptionC The SET PROCESS command establishes the visible process, defines; the current process set, or defines the visible process.B By default, commands are executed in the co +ntext of the visible@ process (the process that is your current debugging context).B Symbol lookups, the setting of breakpoints, and so on, are done) in the context of the visible process.B Dynamic process setting is enabled by default and is controlled> with /[NO]DYNAMIC. When dynamic process setting is enabled,@ whenever the debugger suspends program execution and displaysB its prompt, the process in which execution is suspended becomes% the visible process automatically,. Related commands: CALL EXIT GO QUIT SHOW PROCESS STEP 4 Example all> SET PROCESS TEST_Y all> SHOW PROCESS, Number Name State Current PC/ * 2 TEST_Y break PROG\%LINE 71 all>D The SET PROCESS TEST_Y command makes process TEST_Y the visibleA process. The SHOW PROCESS command displays information about$ the visible process by default. 3 PROMPTB Changes the debugger prompt s-tring to your personal preference. Format# SET PROMPT [prompt-parameter] 4 Parameters prompt-parameterB Specifies the new prompt string. If the string contains spaces,C semicolons (;), or lowercase characters, you must enclose it inC quotation marks (") or apostrophes ('). If you do not specify a7 string, the current prompt string remains unchanged.@ By default, the prompt string is DBG> when debugging a single process program.A By defa.ult, when debuggging a multiprocess program, the promptD string is the name of the current process set followed by a rightD angle bracket (>). You should not use the SET PROMPT command when# debugging multiprocess programs. 4 Qualifiers /POP /POP /NOPOP (default)A (Applies only to workstations running VWS.) The /POP qualifierB causes the debugger window to pop over other windows and becomeD attached to the keyboard when the debugger prompts for in/put. TheB /NOPOP qualifier disables this behavior (the debugger window isD not popped over other windows and is not attached to the keyboard6 automatically when the debugger prompts for input). 4 DescriptionC The SET PROMPT command enables you to tailor the debugger prompt( string to your individual preference.B If you are debugging a multiprocess program, you should not use the SET PROMPT command.C If you are using the debugger at a workstation, /[NO]POP enables0B you to control whether the debugger window is popped over other3 windows whenever the debugger prompts for input. Related commands: (SET,SHOW) PROCESS 4 Examples 1.DBG> SET PROMPT "$ " $ SET PROMPT "d b g : " d b g : SET PROMPT "DBG> " DBG>C In this example, the successive SET PROMPT commands change theC debugger prompt from "DBG>" to "$", to "d b g :", then back to "DBG>". 3 RADIXC Establishes the radix for the1 entry and display of integer data.B When used with /OVERRIDE, it causes all data to be displayed as' integer data of the specified radix. Format SET RADIX radix 4 Parameters radix? Specifies the radix to be established. Valid keywords are as follows:( BINARY Sets the radix to binary.A DECIMAL Sets the radix to decimal. This is the default forA all languages except BLISS, MACRO-32, and MACRO-642 (Alph2a and Integrity servers only).6 DEFAULT Sets the radix to the language default.' OCTAL Sets the radix to octal.A HEXADECIMAL Sets the default radix to hexadecimal. This is theC default for BLISS, MACRO-32, and MACRO-64 (Alpha and' Integrity servers only). 4 Qualifiers /INPUTB Sets only the input radix (the radix for entering integer data) to the specified radix. /OUTPUT? Sets only the output radix (the radix for3 displaying integer data) to the specified radix. /OVERRIDEC Causes all data to be displayed as integer data of the specified radix. 4 DescriptionC The current radix setting influences how the debugger interprets7 and displays integer data in the following contexts:= o Integer data that you specify in address expressions or language expressions.@ o Integer data that is displayed by the EXAMINE and EVALUATE commands.C The default 4 radix for both data entry and display is decimal forC most languages. The exceptions are BLISS and MACRO, which have a default radix of hexadecimal.; The SET RADIX command enables you to specify a new radix? for data entry or display (the input radix and output radix, respectively).; If you do not specify a qualifier, the SET RADIX commandA changes both the input and output radix. If you specify /INPUT= or /OUTPUT, the command changes the input or output radix, 5 respectively.D Using SET RADIX/OVERRIDE changes only the output radix but causesD all data (not just data that has an integer type) to be displayed* as integer data of the specified radix.B Except when used with /OVERRIDE, the SET RADIX command does notB affect the interpretation or display of noninteger values (such' as real or enumeration type values).9 The EVALUATE, EXAMINE, and DEPOSIT commands have radixD qualifiers (/BINARY, /HEXADECIMAL, and so on) which enabl6e you toC override, for the duration of that command, any radix previously4 established with SET RADIX or SET RADIX/OVERRIDE.C You can also use the built-in symbols %BIN, %DEC, %HEX, and %OCTB in address expressions and language expressions to specify that? an integer literal should be interpreted in binary, decimal, hexadecimal, or octal radix. Related commands: DEPOSIT EVALUATE EXAMINE (SET,SHOW,CANCEL) MODE (SHOW,CANCEL) RADIX7 4 Examples 1.DBG> SET RADIX HEXA This command sets the radix to hexadecimal. This means that,= by default, integer data is interpreted and displayed in hexadecimal radix. 2.DBG> SET RADIX/INPUT OCT? This command sets the radix for input to octal. This meansB that, by default, integer data that is entered is interpreted in octal radix. 3.DBG> SET RADIX/OUTPUT BINA This command sets the radix for output to binary. This meansA 8 that, by default, integer data is displayed in binary radix.$ 4.DBG> SET RADIX/OVERRIDE DECIMAL@ This command sets the override radix to decimal. This meansB that, by default, all data (not just data that has an integer0 type) is displayed as decimal integer data. 3 SCOPEA Establishes how the debugger looks up symbols (variable names,B routine names, line numbers, and so on) when a path-name prefix is not specified. Format" SET SCOPE location9[, . . . ] 4 Parameters location6 Denotes a program region (scope) to be used for theA interpretation of symbols that you specify without a path-name= prefix. A location can be any of the following, unless you specify /CURRENT or /MODULE.> path-name Specifies the scope denoted by the path-name< prefix prefix. A path-name prefix consists of the? names of one or more nesting program elements@ (module, routine, bl :ock, and so on), with each> name separated by a backslash character (\).? When a path-name prefix consists of more thanA one name, list a nesting element to the left ofD the backslash and a nested element to the right ofD the backslash. A common path-name prefix format is( module\routine\block\.D If you specify only a module name and that name isA the same ; as the name of a routine, use /MODULE;> otherwise, the debugger assumes that you are) specifying the routine.B n Specifies the scope denoted by the routine whichA is n levels down the call stack (n is a decimalC integer). A scope specified by an integer changesB dynamically as the program executes. The value 0B denotes the routine that is currently executing,A < the value 1 denotes the caller of that routine,B and so on down the call stack. The default scope@ search list is 0,1,2, . . . ,n, where n is the4 number of calls in the call stack.@ \ Specifies the global scope-that is, the set ofC (backslash) all program locations in which a global symbol isB known. The definition of a global symbol and the= way it is declared depends on the language=.C When you specify more than one location parameter, you establishC a scope search list. If the debugger cannot interpret the symbol= using the first parameter, it uses the next parameter, andC continues using parameters in order of their specification untilA it successfully interprets the symbol or until it exhausts the parameters specified. 4 Qualifiers /CURRENTB Establishes a scope search list that is like the default searchA list (0,1,2, . . . ,n>), numeric scope specified as the commandC parameter. Scope 0 is the PC scope, and n is the number of calls in the call stack.C When using SET SCOPE/CURRENT, note the following conventions and behavior:> o The default scope search list must be in effect when theC command is entered. To restore the default scope search list,% enter the CANCEL SCOPE command.@ o The command parameter specified must be one (and only one)" decimal integer from 0 to n.@? o In screen mode, the command updates the predefined source,< instruction, and register displays SRC, INST, and REG,B respectively, to show the routine on the call stack in which# symbol searches are to start.< o The default scope search list is restored when program execution is resumed. /MODULEB Indicates that the name specified as the command parameter is aC module name and not a routine name. You need to use /MODULE onlyA if you specify a mo @dule name as the command parameter and that4 module name is the same as the name of a routine. 4 DescriptionA By default, the debugger looks up a symbol specified without aC path-name prefix according to the scope search list 0,1,2, . . .= ,n, where n is the number of calls in the call stack. ThisA scope search list is based on the current PC value and changes@ dynamically as the program executes. The default scope searchD list specifies that a symbol lookup such as E AXAMINE X first looksB for X in the routine that is currently executing (scope 0, alsoA known as the PC scope); if no X is visible there, the debuggerD looks in the caller of that routine (scope 1), and so on down theB call stack; if X is not found in scope n, the debugger searches? the rest of the run-time symbol table (RST)-that is, all set; modules and the global symbol table (GST), if necessary.< In most cases, this default scope search list enables you? to resolve ambiBguities in a predictable, natural way that isD consistent with language rules. But if you cannot access a symbol> that is defined multiple times, use either of the following techniques:? o Specify the symbol with a path-name prefix. The path-name@ prefix consists of any nesting program units (for example,D module\routine\block) that are necessary to specify the symbol uniquely. For example: DBG> EXAMINE MOD4\ROUT3\X DBG> TYPE MOD4\27@ o EstaCblish a new default scope (or a scope search list) for@ symbol lookup by using the SET SCOPE command. You can then> specify the symbol without using a path-name prefix. For example: DBG> SET SCOPE MOD4\ROUT3 DBG> EXAMINE X DBG> TYPE 27 4 Description,_Continued...A The SET SCOPE command is useful in those cases where otherwiseC you would need to use a path name repeatedly to specify symbols.D SET SCOPE changes the debugger's language set Dting to the language of the specified scope.A To restore the default scope search list, use the CANCEL SCOPE command.C When the default scope search list is in effect, you can use theB SET SCOPE/CURRENT command to specify that symbol searches startD at a numeric scope other than scope 0, relative to the call stack (for example, scope 2).A When you use the SET SCOPE command, the debugger searches onlyC the program locations you specify explicitly, unless you spec EifyD /CURRENT. Also, the scope or scope search list established with aD SET SCOPE command remains in effect until you restore the defaultD scope search list or enter another SET SCOPE command. However, ifB you specify /CURRENT, the default scope search list is restored) whenever program execution is resumed.D The SET SCOPE command updates a screen-mode source or instruction( display only if you specify /CURRENT.> If a name you specify in a SET SCOPE command is the name of FB both a module and a routine, the debugger sets the scope to theB routine. In such cases, use the SET SCOPE/MODULE command if you' want to set the scope to the module.D If you specify a module name in a SET SCOPE command, the debuggerB sets that module if it is not already set. However, if you wantC only to set a module, use the SET MODULE command rather than the@ SET SCOPE command, to avoid the possibility of disturbing the current scope search list.@ For informatiGon specific to Ada programs, type Help Language_ Support Ada. Related commands: CANCEL ALL SEARCH SET MODULE (SHOW,CANCEL) SCOPE SHOW SYMBOL SYMBOLIZE TYPE 4 Examples 1.DBG> EXAMINE Y0 %DEBUG-W-NOUNIQUE, symbol 'Y' is not unique DBG> SHOW SYMBOL Y data CHECK_IN\Y data INVENTORY\COUNT\Y# DBG> SET SCOPE INVENTORY\COUNT DBG> EXAMINE Y INVENTORY\COUNT\Y: 347.15 DBG> H@ In this example, the first EXAMINE Y command indicates thatC symbol Y is defined multiple times and cannot be resolved fromD the current scope search list. The SHOW SYMBOL command displaysB the different declarations of symbol Y. The SET SCOPE command? directs the debugger to look for symbols without path-nameB prefixes in routine COUNT of module INVENTORY. The subsequent7 EXAMINE command can now interpret Y unambiguously. 3 SEARCH@ Establishes defauIlt qualifiers (/ALL or /NEXT, /IDENTIFIER or# /STRING) for the SEARCH command. Format) SET SEARCH search-default[, . . . ] 4 Parameters search-default@ Specifies a default to be established for the SEARCH command.A Valid keywords (which correspond to SEARCH command qualifiers) are as follows:C ALL Subsequent SEARCH commands are treated as SEARCH/ALL,& rather than SEARCH/NEXT.7 IDENTIFIER Subsequent SEARCH commands are treat Jed as; SEARCH/IDENTIFIER, rather than SEARCH/STRING.A NEXT (Default) Subsequent SEARCH commands are treated as2 SEARCH/NEXT, rather than SEARCH/ALL.A STRING (Default) Subsequent SEARCH commands are treated as; SEARCH/STRING, rather than SEARCH/IDENTIFIER. 4 Description< The SET SEARCH command establishes default qualifiers forC subsequent SEARCH commands. The parameters that you specify withB SET SEARCH have the same name Ks as the qualifiers for the SEARCH@ command. The qualifiers determine whether the SEARCH command:B (1) searches for all occurrences of a string (ALL) or only theB next occurrence (NEXT); and (2) displays any occurrence of theC string (STRING) or only those occurrences in which the string isC not bounded on either side by a character that can be part of an3 identifier in the current language (IDENTIFIER).B You can override the current SEARCH default for the duration ofB aL single SEARCH command by specifying other qualifiers. Use the? SHOW SEARCH command to identify the current SEARCH defaults. Related commands: SEARCH (SET,SHOW) LANGUAGE SHOW SEARCH 4 Example DBG> SHOW SEARCH9 search settings: search for next occurrence, as a string DBG> SET SEARCH IDENTIFIER DBG> SHOW SEARCH> search settings: search for next occurrence, as an identifier DBG> SET SEARCH ALL DBG> SHOW SEARCH> search settings: search for M all occurrences, as an identifier DBG>? In this example, the SET SEARCH IDENTIFIER command directs> the debugger to search for an occurrence of the string inA the specified range but display the string only if it is notA bounded on either side by a character that can be part of an( identifier in the current language.B The SET SEARCH ALL command directs the debugger to search forA (and display) all occurrences of the string in the specified range.N 3 SOURCEC Specifies a directory search list, a directory search method, or- both a list and a method for source files. Format) SET SOURCE directory-spec[, . . . ] 4 Parameters directory-specA Specifies any part of an OpenVMS file specification (typically= a device/directory) that the debugger is to use by default@ when searching for a source file. For any part of a full fileC specification that you do not supply, the debugger uses the fil OeC specification stored in the module's symbol record (that is, the@ file specification that the source file had at compile time).@ If you specify more than one directory in a single SET SOURCE> command, you create a source directory search list (you canB also specify a search list logical name that is defined at your@ process level). In this case, the debugger locates the sourceD file by searching the first directory specified, then the second,A and so on, until it either Plocates the source file or exhausts the list of directories. 4 Qualifiers /DISPLAY= Specifies the directory search list used when the debugger@ displays source code. The default display search directory is the compilation directory. /EDITC Specifies the directory search list used during execution of theD debugger's EDIT command. The default edit search directory is the compilation directory. /EXACT /EXACT (default)@ SpecifiQes the directory search method used. In this case, theA debugger searches for the exact version of the source file, as* indicated in the debugger symbol table. /LATEST@ Specifies the directory search method used. In this case, theD debugger searches for the latest version of the source file, that6 is, the highest-numbered version in your directory. /MODULE /MODULE=module-nameC Specifies the directory search list used only for the designatedD module.R You can append one or more of the qualifiers listed above$ to the SET SOURCE/MODULE command. /ORIGINAL? (Applies to STDL programs only. Requires installation of theC Correlation Facility (a separate layered product) and invocationA of the kept debugger.) Specifies that the debugger display the@ original STDL source file, rather than the intermediate files$ produced during STDL compilation. 4 DescriptionC By default, the debugger expects a source file to be inS the sameA directory it was in at compile time. If a source file has beenA moved to a different directory since compile time, use the SET? SOURCE command to specify a directory search list and search method to locate the file.' Specifying the Directory Search List@ A complete ODS-2 OpenVMS file specification has the following format:= node::device:[directory]file-name.file-type;version-numberB This format reflects the DECnet node name functionality used in TB DECnet Phase IV that shipped with the OpenVMS operating system.> For more information, see the DECnet for OpenVMS Networking Manual.> On OpenVMS systems running Version 6.1 or later and DECnet-> Plus for OpenVMS, a complete file specification can include@ expanded node designations, called full names. Full names areD hierarchically structured DECnet-Plus for OpenVMS node names that@ can be stored in a DECdns naming service. Full names can be a6 maximum of 255 bytes long U, in the following format:0 namespace:.directory ... .directory.node-nameC In this syntax statement, namespace identifies the global naming= service, directory ... .directory defines the hierarchicalA directory path within the naming service, and node-name is the, specific object defining the DECnet node.A For information on full names and suggestions for setting up aD system of names, see the VSI OpenVMS System Manager's Manual. ForB information on DECnet-Plus for Op VenVMS, see the DECnet-Plus for) OpenVMS Introduction and User's Guide.> If the full file specification of a source file exceeds 255@ characters, the debugger cannot locate the file. You can workC around this problem by first defining a logical name "X" (at DCLC level) to expand to your long file specification, and then using the SET SOURCE X command.? A SET SOURCE command with neither the /DISPLAY nor the /EDITB qualifier changes both the display and edit search direct Wories.A When compiling a program with the /DEBUG qualifier, if you useA a rooted-directory logical name to specify the location of theA source file, make sure that it is a concealed rooted-directoryD logical name. If it is not concealed and you move the source fileB to another directory after compilation, you cannot then use theA debugger SET SOURCE command to specify the new location of the source file.C To create a concealed rooted-directory logical name, use the DCXLA command DEFINE with the /TRANSLATION_ATTR=CONCEALED qualifier. 4 Description,_Continued...) Specifying the Directory Search Method@ When you issue a SET SOURCE command, be aware that one of theA two qualifiers -/LATEST or /EXACT-will always be active. These< qualifiers affect the debugger search method. The /LATEST@ qualifier directs the debugger to search for the version last@ created (the highest-numbered version in your directory). TheB /EXACT qualifier di Yrects the debugger to search for the versionC last compiled (the version recorded in the debugger symbol table= created at compile time). For example, a SET SOURCE/LATEST? command might search for SORT.FOR;3 while a SET SOURCE/EXACT' command might search for SORT.FOR;1.B If the debugger locates this version using the directory search? list, it checks that the creation or revision date and time,B file size, record format, and file organization are the same asB the origina Zl compile-time source file. If these characteristicsB match, the debugger concludes that the original source file has% been located in its new directory.A If the debugger cannot locate this version using the directoryD search list, it identifies the file that has the closest revision> date and time (if such a file exists in that directory) and@ issues a NOTORIGSRC message ("original version of source file5 not found") when first displaying the source code.! Specifying [the /EDIT QualifierD The /EDIT qualifier is needed when the files used for the display> of source code are different from the files to be edited byB using the EDIT command. This is the case with Ada programs. For? Ada programs, the (SET, SHOW, CANCEL) SOURCE commands affect< the search of files used for source display (the "copied"@ source files in Ada program libraries); the (SET,SHOW,CANCEL)A SOURCE/EDIT commands affect the search of the source files youC edit when using\ the EDIT command. If you use /MODULE with /EDIT,7 the effect of /EDIT is further qualified by /MODULE.4 For information specific to Ada programs, see the# Language_Support Ada help topic.% Specifying the /ORIGINAL Qualifier= Before you can use the /ORIGINAL qualifier in a SET SOURCEA command, the Correlation Facility (a separate layered product)B must be installed on your system. Refer to Correlation FacilityB documentation for information on creating a correla]tion library before debugging.C Then, invoke the kept debugger and issue the SET SOURCE/ORIGINAL command as follows: $ DEBUG/KEEP DBG> SET SOURCE/ORIGINAL DBG> RUN filename.EXEB After issuing these commands, you can debug STDL source code in? the same way you debug any other supported language program. Related commands: (SHOW,CANCEL) SOURCE 4 Examples 1.DBG> SHOW SOURCE) no directory search list in effect2 DBG> SET SO^URCE [PROJA],[PROJB],[PETER.PROJC] DBG> SHOW SOURCE/ source directory list for all modules,. match the latest source file version: [PROJA] [PROJB] [PETER.PROJC]? In this example, the SET SOURCE command specifies that the= debugger should search directories [PROJA], [PROJB], andC [PETER.PROJC], in that order, for the latest version of source files. 2.DBG> SET SOURCE /EXACT DBG> SHOW SOURCE, _ no directory search list in effect,% match the exact source file DBG> SET SOURCE [JONES] DBG> SHOW SOURCE/ source directory list for all modules,. match the exact source file version: [JONES] DBG> CANCEL SOURCE /EXACT DBG> SHOW SOURCE0 source directory list for all modules,/ match the latest source file version: [JONES]@ In this example, the SET SOURCE/EXACT command establishes aA` search method (exact version) that remains in effect for theD SET SOURCE [JONES] command. The CANCEL SOURCE/EXACT command notD only cancels SET SOURCE/EXACT command, but also affects the SET SOURCE [JONES] command. 3 STEPC Establishes default qualifiers (/LINE, /INTO, and so on) for the STEP command. Format% SET STEP step-default[, . . . ] 4 Parameters BRANCHC Subsequent STEP commands are treated as STEP/BRANCH (step to thea next branch instruction). CALLA Subsequent STEP commands are treated as STEP/CALL (step to the next call instruction). EXCEPTIONB Subsequent STEP commands are treated as STEP/EXCEPTION (step to the next exception). INSTRUCTIOND Subsequent STEP commands are treated as STEP/INSTRUCTION (step to the next instruction).C On VAX processors, you can also specify one or more instructions: (opcode[, . . . ]). The debugger then steps to the next%b instruction in the specified list.A On VAX processors, if you specify a vector instruction, do notB include an instruction qualifier (/UNALIGNED_DATA, /MODIFY, /0,) or /1)) with the instruction mnemonic. INTO? Subsequent STEP commands are treated as STEP/INTO (step into; called routines) rather than STEP/OVER (step over called? routines). When INTO is in effect, you can qualify the types< of routines to step into by using the [NO]JSB, [NO]SHARE,; and [NO]SYScTEM parameters, or by using the STEP/[NO]JSB,8 STEP/[NO]SHARE, and STEP/[NO]SYSTEM command/qualifierD combinations (the latter three take effect only for the immediate STEP command). LINED (Default) Subsequent STEP commands are treated as STEP/LINE (step to the next line). OVERD (Default) Subsequent STEP commands are treated as STEP/OVER (stepD over all called routines) rather than STEP/INTO (step into called routines). RETURNC Subsequent STdEP commands are treated as STEP/RETURN (step to theA return instruction of the routine that is currently executing-C that is, up to the point just prior to transferring control back to the calling routine). SEMANTIC_EVENT7 (Alpha only) Subsequent STEP commands are treated as9 STEP/SEMANTIC_EVENT (step to the next semantic event). SHARE; (Default) If INTO is in effect, subsequent STEP commands? are treated as STEP/INTO/SHARE (step into called routines ine; shareable images as well as into other called routines). NOSHARE@ If INTO is in effect, subsequent STEP commands are treated asD STEP/INTO/NOSHARE (step over called routines in shareable images,! but step into other routines). SILENT? Subsequent STEP commands are treated as STEP/SILENT (after aE step, do not display the "stepped to . . . " message or the source" line for the current location). NOSILENTB (Default) Subsequent STEP commands are trfeated as STEP/NOSILENT; (after a step, display the "stepped to . . . " message). SOURCE@ (Default) Subsequent STEP commands are treated as STEP/SOURCED (after a step, display the source line for the current location).@ Also, subsequent SET BREAK, SET TRACE, and SET WATCH commands= are treated as SET BREAK/SOURCE, SET TRACE/SOURCE, and SET> WATCH/SOURCE, respectively (at a breakpoint, tracepoint, orA watchpoint, display the source line for the current location). gNOSOURCEA Subsequent STEP commands are treated as STEP/NOSOURCE (after aB step, do not display the source line for the current location).@ Also, subsequent SET BREAK, SET TRACE, and SET WATCH commands= are treated as SET BREAK/NOSOURCE, SET TRACE/NOSOURCE, andA SET WATCH/NOSOURCE, respectively (at a breakpoint, tracepoint,@ or watchpoint, do not display the source line for the current location). SYSTEM? (Default) If INTO is in effect, subsequent STEP commands arheC treated as STEP/INTO/SYSTEM (step into called routines in system; space (P1 space) as well as into other called routines). NOSYSTEM@ If INTO is in effect, subsequent STEP commands are treated asA STEP/INTO/NOSYSTEM (step over called routines in system space,! but step into other routines). 4 Description: The SET STEP command establishes default qualifiers for? subsequent STEP commands. The parameters that you specify inA the SET STEP command have the siame names as the qualifiers forC the STEP command. The following parameters affect where the STEP+ command suspends execution after a step: BRANCH CALL EXCEPTION INSTRUCTION LINE RETURN! SEMANTIC_EVENT (Alpha only)B The following parameters affect what output is seen when a STEP command is executed: [NO]SILENT [NO]SOURCEB The following parameters affect what happens at a routine call: INTO OVER j [NO]SHARE [NO]SYSTEMC You can override the current STEP defaults for the duration of aC single STEP command by specifying other qualifiers. Use the SHOW6 STEP command to identify the current STEP defaults.? Enabling screen mode by pressing PF1-PF3 enters the SET STEP; NOSOURCE command as well as the SET MODE SCREEN command.B Therefore, any display of source code in output and DO displays> that would result from a STEP command or from a breakpoint,> tracekpoint, or watchpoint being triggered is suppressed, to0 eliminate redundancy with the source display.  Related commands: SHOW STEP STEP 4 Examples' 1.DBG> SET STEP INSTRUCTION,NOSOURCEC This command causes the debugger to execute the program to the@ next instruction when a STEP command is entered, and not to9 display lines of source code with each STEP command.- 2.DBG> SET STEP LINE,INTO,NOSYSTEM,NOSHARE? This command causes tlhe debugger to execute the program toC the next line when a STEP command is entered, and to step into@ called routines in user space only. The debugger steps over6 routines in system space and in shareable images. 3 TASKD Changes characteristics of one or more tasks of a tasking program' (also called a multithread program).& NOTE; SET TASK and SET THREAD are synonymous commands. They perform identically. Formatm$ SET TASK [task-spec[, . . . ]] 4 Parameters task-spec: Specifies a task value. Use any of the following forms:) o When the event facility is THREADS:C - A task (thread) ID number as declared in the program, or a: language expression that yields a task ID number.B - A task ID number (for example, 2), as indicated in a SHOW TASK display.% o When the event facility is ADA:> - A task (thread) name as declared in t nhe program, or aD language expression that yields a task value. You can use a path name.A - A task ID (for example, %TASK 2), as indicated in a SHOW TASK display.1 o One of the following task built-in symbols:B %ACTIVE_TASK The task that runs when a GO, STEP, CALL, or, EXIT command executes.D %CALLER_TASK (Applies only to Ada programs.) When an acceptB statement executes, the task that called o theA entry associated with the accept statement.< %NEXT_TASK The task after the visible task in theA debugger's task list. The ordering of tasksA is arbitrary but consistent within a single' run of a program.B %PREVIOUS_ The task previous to the visible task in the+ TASK debugger's task list.D %VISIBLE_TASK The task whose call stack and register set areA p the current context for looking up symbols,B register values, routine calls, breakpoints, and so on.D Do not use the asterisk (*) wildcard character. Instead, use theB /ALL qualifier. Do not specify a task with /ALL or /TIME_SLICE.? If you do not specify a task or /ALL with /ABORT, /[NO]HOLD,8 /PRIORITY, or /RESTORE, the visible task is selected. 4 Qualifiers /ABORT@ Marks the specified tasks for terminatiqon. Termination occurs= at the next allowable point after a specified task resumes execution.@ For HP Ada tasks, the effect is identical to executing an AdaA abort statement for the tasks specified and causes these tasksD to be marked as abnormal. Any dependent tasks are also marked for termination.8 For POSIX threads threads, use the following command: PTHREAD tset -c thread-number@ You can get help on POSIX threads debugger commands by typing PTHREAD HELrP.B See the Guide to the POSIX Threads Library for more information* about using the POSIX threads debugger. /ACTIVEC Makes the specified task the active task, which is the task thatD runs when a STEP, GO, CALL, or EXIT command executes. This causes? a task switch to the new active task and makes that task theD visible task. The specified task must be in either the RUNNING or> READY state. When using /ACTIVE, you must specify one task.> For POSIX threads programss or HP Ada on Alpha programs, use% one of the following alternatives:? o For query-type actions, use the SET TASK/VISIBLE command.@ o To gain control of execution, use a strategic placement of breakpoints.4 o Use the PTHREAD tset -a thread-number command.@ You can get help on POSIX threads debugger commands by typing PTHREAD HELP.B See the Guide to the POSIX Threads Library for more information* about using the POSIX threads debugger. /ALL- Atpplies the SET TASK command to all tasks. /HOLD /HOLD /NOHOLD (default). When the event facility is THREADS, use theB PTHREAD tset -h thread-number or the PTHREAD tset -n thread-num command.> Controls whether a specified task is put on hold. The /HOLD+ qualifier puts a specified task on hold.C Putting a task on hold prevents a task from entering the RUNNING; state. A task put on hold is allowed to make other state? transitions; in particula ur, it can change from the SUSPENDED to the READY state.C Putting a task on hold prevents a task from entering the RUNNING; state. A task put on hold is allowed to make other state? transitions; in particular, it can change from the SUSPENDED to the READY state.< A task already in the RUNNING state (the active task) canB continue to execute as long as it remains in the RUNNING state,@ even though it is put on hold. If the task leaves the RUNNINGA state for any reasovn (including expiration of a time slice, ifD time slicing is enabled), it will not return to the RUNNING state* until released from the hold condition.@ You can override the hold condition and force a task into theB RUNNING state with the SET TASK/ACTIVE command even if the task is on hold.= The /NOHOLD qualifier releases a specified task from hold.@ You can get help on POSIX threads debugger commands by typing PTHREAD HELP.B See the Guide to the POSIX Threads Liwbrary for more information* about using the POSIX threads debugger. /PRIORITY /PRIORITY=n6 When the event facility is THREADS, use the PTHREAD! tset -s thread-number command.C Sets the priority of a specified task to n, where n is a decimal@ integer from 0 to 15. This does not prevent the priority from@ later changing in the course of execution, for example, while! executing an Ada rendezvous orC Sets the priority of a specified task to n, where n is xa decimal@ integer from 0 to 15. This does not prevent the priority from@ later changing in the course of execution, for example, while? executing an Ada rendezvous or POSIX threads synchronizationD event. This qualifier does not affect a task's scheduling policy.@ You can get help on POSIX threads debugger commands by typing PTHREAD HELP.B See the Guide to the POSIX Threads Library for more information* about using the POSIX threads debugger. /VISIBLE? Makes y the specified task the visible task, which is the task@ whose call stack and register set are the current context forC looking up symbols, register values, routine calls, breakpoints,B and so on. Commands such as EXAMINE are directed at the visible@ task. The /VISIBLE qualifier does not affect the active task.2 When using /VISIBLE, you must specify one task. 4 DescriptionA The SET TASK command enables you to establish the visible taskA and the active task, control thze execution of tasks, and cause2 task state transitions, directly or indirectly.> To determine the current state of a task, use the SHOW TASKB command. The possible states are RUNNING, READY, SUSPENDED, and TERMINATED. Related commands: DEPOSIT/TASK EXAMINE/TASK SET BREAK/EVENT SET TRACE/EVENT (SET, SHOW) EVENT_FACILITY SHOW TASK|THREAD 4 Examples! 1.DBG> SET TASK/ACTIVE %TASK 3C (Event facility = ADA) This comma{nd makes task 3 (task ID = 3) the active task. 2.DBG> PTHREAD tset -a 3D (Event facility = THREADS) This command makes task 3 (task ID = 3) the active task. 3.DBG> SET TASK %NEXT_TASKA This command makes the next task in the debugger's task listC the visible task. (The /VISIBLE qualifier is a default for the SET TASK command.) 4.DBG> SET TASK/HOLD/ALL! DBG> SET TASK/ACTIVE %TASK 1 DBG> GO . . .! DBG> SET TASK/A|CTIVE %TASK 3 DBG> STEP . . .; In this example, the SET TASK/HOLD/ALL command freezes= the state of all tasks except the active task. Then, SET@ TASK/ACTIVE is used selectively (along with the GO and STEP? commands) to observe the behavior of one or more specified tasks in isolation. 3 TERMINALB Sets the terminal-screen height or width that the debugger uses+ when it formats screen and other output.& }NOTEC This command is not available in the VSI DECwindows Motif for- OpenVMS user interface to the debugger. Format SET TERMINAL 4 Qualifiers /PAGE /PAGE:n? Specifies that the terminal screen height should be set to n/ lines. You can use any value from 18 to 100. /WIDTH /WIDTH:n> Specifies that the terminal screen width should be set to n? columns. You can use any value from 20 to 255. For a VT100-,@ VT200~-, or VT300 series terminal, n is typically either 80 or 132. /WRAP? Tells the debugger to wrap output text in predefined displayA OUT at the column specified by the /WIDTH qualifier. If you doC not specify /WIDTH in the current command, /WRAP defaults to the %WIDTH setting. 4 Description@ The SET TERMINAL command enables you to define the portion ofC the screen that the debugger has available for formatting screen output.> This command is useful with VT100-, VT200-, or VT300-seriesC terminals, where you can set the screen width to typically 80 orB 132 columns. It is also useful with workstations, where you canD modify the size of the terminal-emulator window that the debugger uses.D You must specify at least one qualifier. You can specify all. The4 /PAGE and /WIDTH qualifiers each require a value.> When you enter the SET TERMINAL command, all display windowC definitions are automatically adjusted to reflect the n €ew screenD dimensions. For example, RH1 changes dimensions proportionally to. remain in the top right half of the screen.= Similarly, all "dynamic" display windows are automatically= adjusted to maintain their relative proportions. Note that= all display windows are dynamic unless referenced with the> DISPLAY/NODYNAMIC command. In that case, the display window? retains its current dimensions after subsequent SET TERMINALD commands. However, you can use the DISPLAY command to reconfigure@ the display window (you can also use keypad-key combinations,= such as BLUE-MINUS, to enter predefined DISPLAY commands). Related commands: DISPLAY/[NO]DYNAMIC EXPAND (SET,SHOW,CANCEL) WINDOW SHOW TERMINAL 4 Example DBG> SET TERMINAL/WIDTH:132D This command specifies that the terminal screen width be set to 132 columns. 3 THREADD Changes characteristics of one or more tasks of a tasking program' (al‚so called a multithread program).& NOTE; SET TASK and SET THREAD are synonymous commands. They perform identically. Format$ SET TASK [task-spec[, . . . ]] 4 Parameters task-spec: Specifies a task value. Use any of the following forms:) o When the event facility is THREADS:C - A task (thread) ID number as declared in the program, or a: language expression that yields a task ID number.Bƒ - A task ID number (for example, 2), as indicated in a SHOW TASK display.% o When the event facility is ADA:> - A task (thread) name as declared in the program, or aD language expression that yields a task value. You can use a path name.A - A task ID (for example, %TASK 2), as indicated in a SHOW TASK display.1 o One of the following task built-in symbols:B %ACTIVE_TASK The task that runs when a GO, STEP, CALL, „or, EXIT command executes.D %CALLER_TASK (Applies only to Ada programs.) When an acceptB statement executes, the task that called theA entry associated with the accept statement.< %NEXT_TASK The task after the visible task in theA debugger's task list. The ordering of tasksA is arbitrary but consistent within a single' run of a program.B %PRE …VIOUS_ The task previous to the visible task in the+ TASK debugger's task list.D %VISIBLE_TASK The task whose call stack and register set areA the current context for looking up symbols,B register values, routine calls, breakpoints, and so on.D Do not use the asterisk (*) wildcard character. Instead, use theB /ALL qualifier. Do not specify a task with /ALL or /TIME_SLICE.? If you do not speci†fy a task or /ALL with /ABORT, /[NO]HOLD,8 /PRIORITY, or /RESTORE, the visible task is selected. 4 Qualifiers /ABORT@ Marks the specified tasks for termination. Termination occurs= at the next allowable point after a specified task resumes execution.@ For HP Ada tasks, the effect is identical to executing an AdaA abort statement for the tasks specified and causes these tasksD to be marked as abnormal. Any dependent tasks are also marked for termination‡.8 For POSIX threads threads, use the following command: PTHREAD tset -c thread-number@ You can get help on POSIX threads debugger commands by typing PTHREAD HELP.B See the Guide to the POSIX Threads Library for more information* about using the POSIX threads debugger. /ACTIVEC Makes the specified task the active task, which is the task thatD runs when a STEP, GO, CALL, or EXIT command executes. This causes? a task switch to the new active task and makeˆs that task theD visible task. The specified task must be in either the RUNNING or> READY state. When using /ACTIVE, you must specify one task.> For POSIX threads programs or HP Ada on Alpha programs, use% one of the following alternatives:? o For query-type actions, use the SET TASK/VISIBLE command.@ o To gain control of execution, use a strategic placement of breakpoints.4 o Use the PTHREAD tset -a thread-number command.@ You can get help on POSIX threa‰ds debugger commands by typing PTHREAD HELP.B See the Guide to the POSIX Threads Library for more information* about using the POSIX threads debugger. /ALL- Applies the SET TASK command to all tasks. /HOLD /HOLD /NOHOLD (default). When the event facility is THREADS, use theB PTHREAD tset -h thread-number or the PTHREAD tset -n thread-num command.> Controls whether a specified task is put on hold. The /HOLD+ qualifier puts a specif Šied task on hold.C Putting a task on hold prevents a task from entering the RUNNING; state. A task put on hold is allowed to make other state? transitions; in particular, it can change from the SUSPENDED to the READY state.C Putting a task on hold prevents a task from entering the RUNNING; state. A task put on hold is allowed to make other state? transitions; in particular, it can change from the SUSPENDED to the READY state.< A task already in the RUNNING sta ‹te (the active task) canB continue to execute as long as it remains in the RUNNING state,@ even though it is put on hold. If the task leaves the RUNNINGA state for any reason (including expiration of a time slice, ifD time slicing is enabled), it will not return to the RUNNING state* until released from the hold condition.@ You can override the hold condition and force a task into theB RUNNING state with the SET TASK/ACTIVE command even if the task is on hold.= The /NOŒHOLD qualifier releases a specified task from hold.@ You can get help on POSIX threads debugger commands by typing PTHREAD HELP.B See the Guide to the POSIX Threads Library for more information* about using the POSIX threads debugger. /PRIORITY /PRIORITY=n6 When the event facility is THREADS, use the PTHREAD! tset -s thread-number command.C Sets the priority of a specified task to n, where n is a decimal@ integer from 0 to 15. This does not prevent  the priority from@ later changing in the course of execution, for example, while! executing an Ada rendezvous orC Sets the priority of a specified task to n, where n is a decimal@ integer from 0 to 15. This does not prevent the priority from@ later changing in the course of execution, for example, while? executing an Ada rendezvous or POSIX threads synchronizationD event. This qualifier does not affect a task's scheduling policy.@ You can get help on POSIX threads debugŽger commands by typing PTHREAD HELP.B See the Guide to the POSIX Threads Library for more information* about using the POSIX threads debugger. /VISIBLE? Makes the specified task the visible task, which is the task@ whose call stack and register set are the current context forC looking up symbols, register values, routine calls, breakpoints,B and so on. Commands such as EXAMINE are directed at the visible@ task. The /VISIBLE qualifier does not affect the active task.2 When using /VISIBLE, you must specify one task. 4 DescriptionA The SET TASK command enables you to establish the visible taskA and the active task, control the execution of tasks, and cause2 task state transitions, directly or indirectly.> To determine the current state of a task, use the SHOW TASKB command. The possible states are RUNNING, READY, SUSPENDED, and TERMINATED. Related commands: DEPOSIT/TASK EXAMINE/TASK SET BREAK/EVENT SET TRACE/EVENT (SET, SHOW) EVENT_FACILITY SHOW TASK|THREAD 4 Examples! 1.DBG> SET TASK/ACTIVE %TASK 3C (Event facility = ADA) This command makes task 3 (task ID = 3) the active task. 2.DBG> PTHREAD tset -a 3D (Event facility = THREADS) This command makes task 3 (task ID = 3) the active task. 3.DBG> SET TASK %NEXT_TASKA This command makes the next task in the debugger's task listC the visible task. (The /VISIB‘LE qualifier is a default for the SET TASK command.) 4.DBG> SET TASK/HOLD/ALL! DBG> SET TASK/ACTIVE %TASK 1 DBG> GO . . .! DBG> SET TASK/ACTIVE %TASK 3 DBG> STEP . . .; In this example, the SET TASK/HOLD/ALL command freezes= the state of all tasks except the active task. Then, SET@ TASK/ACTIVE is used selectively (along with the GO and STEP? commands) to observe the behavior of one or more specified tasks in ’isolation. 3 TRACEA Establishes a tracepoint at the location denoted by an address? expression, at instructions of a particular class, or at the" occurrence of specified events. Format. SET TRACE [address-expression[, . . . ]]. [WHEN(conditional-expression)]' [DO(command[; . . . ])] 4 Parameters address-expression@ Specifies an address expression (a program location) at which= a tracepoint is to be set. With “ high-level languages, this> is typically a line number, a routine name, or a label, and? can include a path name to specify the entity uniquely. MoreC generally, an address expression can also be a memory address orC a register and can be composed of numbers (offsets) and symbols,A as well as one or more operators, operands, or delimiters. For> information about the operators that you can use in address. expressions, type Help Address_Expressions.> Do not specify the as”terisk (*) wildcard character. Do not? specify an address expression with the following qualifiers: /ACTIVATING /BRANCH /CALL /EXCEPTION /INSTRUCTION /INTO /LINE /OVER /[NO]SHARE /[NO]SYSTEM /TERMINATINGB The /MODIFY and /RETURN qualifiers are used with specific kinds of address expressions.A If you specify a memory address or an address expression whose< value is not a symbolic location, check • (with the EXAMINE> command) that an instruction actually begins at the byte of@ memory so indicated. If an instruction does not begin at thisA byte, a run-time error can occur when an instruction includingA that byte is executed. When you set a tracepoint by specifyingD an address expression whose value is not a symbolic location, theA debugger does not verify that the location specified marks the beginning of an instruction. conditional-expression: Specifies a c–onditional expression in the currently setB language that is to be evaluated whenever execution reaches theD tracepoint. (The debugger checks the syntax of the expressions inB the WHEN clause when execution reaches the tracepoint, not whenB the tracepoint is set.) If the expression is true, the debuggerA reports that a tracepoint has been triggered. If an action (DOC clause) is associated with the tracepoint, it will occur at this@ time. If the expression is false, a report is n—ot issued, theA commands specified by the DO clause (if one was specified) are4 not executed, and program execution is continued. command@ Specifies a debugger command to be executed as part of the DOD clause when trace action is taken. The debugger checks the syntaxA of the commands in a DO clause when it executes the DO clause," not when the tracepoint is set. 4 Qualifiers /ACTIVATING> Causes the debugger to trace when a new process comes under9 ˜ debugger control. See also the /TERMINATING qualifier. /AFTER /AFTER:nB Specifies that trace action not be taken until the nth time theA designated tracepoint is encountered (n is a decimal integer).A Thereafter, the tracepoint occurs every time it is encounteredA provided that conditions in the WHEN clause (if specified) areA true. The SET TRACE/AFTER:1 command has the same effect as SET TRACE. /BRANCHD Causes the debugger to trace every branch™ instruction encountered9 during program execution. See also the /INTO and /OVER qualifiers. /CALLB Causes the debugger to trace every call instruction encounteredB during program execution, including the return instruction. See' also the /INTO and /OVER qualifiers. /EVENT /EVENT=event-nameB Causes the debugger to trace the specified event (if that eventA is defined and detected by the current event facility). If youA specify an address expressišon with /EVENT, causes the debugger@ to trace whenever the specified event occurs for that addressD expression. You cannot specify an address expression with certain event names.? Event facilities are available for programs that call Ada orD SCAN routines or that use POSIX threads services. To identify theA current event facility and the associated event names, use the SHOW EVENT_FACILITY command. /EXCEPTIONA Causes the debugger to trace every exception that i›s signaled.D The trace action occurs before any application-declared exception handlers are invoked.> As a result of a SET TRACE/EXCEPTION command, whenever your; program generates an exception, the debugger reports the; exception and resignals the exception, thus allowing any5 application-declared exception handler to execute. /INSTRUCTIONB When you do not specify an opcode, causes the debugger to trace: every instruction encountered during program execution.œ+ See also the /INTO and /OVER qualifiers. /INTO? (Default) Applies only to tracepoints set with the followingD qualifiers (that is, when an address expression is not explicitly specified): /BRANCH /CALL /INSTRUCTION /LINE@ When used with those qualifiers, /INTO causes the debugger to@ trace the specified points within called routines (as well asA within the routine in which execution is currently suspended).C The /INTO qualifier is the default and is the opposite of /OVER.B When using /INTO, you can further qualify the trace action with8 the /[NO]JSB, /[NO]SHARE, and /[NO]SYSTEM qualifiers. /LINEA Causes the debugger to trace the beginning of each source line? encountered during program execution. See also the /INTO and /OVER qualifiers. /MODIFYA Causes the debugger to trace when an instruction writes to andC changes the value of a location indicated by a specified addressC ž expression. The address expression is typically a variable name.> The SET TRACE/MODIFY X command is equivalent to SET WATCH X? DO(GO). The SET TRACE/MODIFY command operates under the same restrictions as SET WATCH.A If you specify an absolute address for the address expression,? the debugger might not be able to associate the address with> a particular data object. In this case, the debugger uses aB default length of 4 bytes. You can change this length, however,C by Ÿsetting the type to either WORD (SET TYPE WORD, which changes? the default length to 2 bytes) or BYTE (SET TYPE BYTE, which? changes the default length to 1 byte). The SET TYPE LONGWORD2 command restores the default length of 4 bytes. /OVER@ Applies only to tracepoints set with the following qualifiers9 (that is, when an address expression is not explicitly specified): /BRANCH /CALL /INSTRUCTION /LINE@ When used with those qualifie  rs, /OVER causes the debugger to> trace the specified points only within the routine in whichA execution is currently suspended (not within called routines).= The /OVER qualifier is the opposite of /INTO (which is the default). /RETURN@ Causes the debugger to break on the return instruction of theB routine associated with the specified address expression (whichB can be a routine name, line number, and so on). Breaking on theB return instruction enables you to inspe ¡ct the local environment< (for example, obtain the values of local variables) while= the routine is still active. Note that the view of a localB environment may differ depending on your architecture. On Alpha< processors, this qualifier can be applied to any routine.D The address-expression parameter is an instruction address within? a routine. It can simply be a routine name, in which case it= specifies the routine start address. However, you can alsoC specify another loc¢ation in a routine, so you can see only those@ returns that are taken after a certain code path is followed.A A SET TRACE/RETURN command cancels a previous SET TRACE if you' specify the same address expression. /SHARE /SHARE (default) /NOSHARE; Qualifies /INTO. Use with /INTO and one of the following qualifiers: /BRANCH /CALL /INSTRUCTION /LINE? The /SHARE qualifier permits the debugger to set tracepointsA within £shareable image routines as well as other routines. TheB /NOSHARE qualifier specifies that tracepoints not be set within shareable images. /SILENT /SILENT /NOSILENT (default)B Controls whether the "trace . . . " message and the source line@ for the current location are displayed at the tracepoint. TheC /NOSILENT qualifier specifies that the message is displayed. TheC /SILENT qualifier specifies that the message and source line are: not displayed. Th¤e /SILENT qualifier overrides /SOURCE. /SOURCE /SOURCE /NOSOURCE (default)? Controls whether the source line for the current location isD displayed at the tracepoint. The /SOURCE qualifier specifies thatB the source line is displayed. The /NOSOURCE qualifier specifies? that the source line is not displayed. The /SILENT qualifier? overrides /SOURCE. See also the SET STEP [NO]SOURCE command. /SYSTEM /SYSTEM (default) /NOSYSTEM; ¥ Qualifies /INTO. Use with /INTO and one of the following qualifiers: /BRANCH /CALL /INSTRUCTION /LINE@ The /SYSTEM qualifier permits the debugger to set tracepointsC within system routines (P1 space) as well as other routines. TheC /NOSYSTEM qualifier specifies that tracepoints not be set within system routines. /TEMPORARY@ Causes the tracepoint to disappear after it is triggered (the/ tracepoint does not remain permanently set).¦ /TERMINATING@ (Default) Causes the debugger to trace when a process does anA image exit. The debugger gains control and displays its prompt? when the last image of a one-process or multiprocess program- exits. See also the /ACTIVATING qualifier. 4 DescriptionC When a tracepoint is triggered, the debugger takes the following actions:< 1. Suspends program execution at the tracepoint location.A 2. If you specified /AFTER when you set the tracepoint, che §cks@ the AFTER count. If the specified number of counts has notB been reached, execution is resumed and the debugger does not" perform the remaining steps.A 3. Evaluates the expression in a WHEN clause, if you specified: one when you set the tracepoint. If the value of the@ expression is false, execution is resumed and the debugger+ does not perform the remaining steps.C 4. Reports that execution has reached the tracepoint location byE issuing a ¨"trace . . . " message, unless you specified /SILENT.; 5. Displays the line of source code corresponding to the@ tracepoint, unless you specified /NOSOURCE or /SILENT whenD you set the tracepoint or entered a previous SET STEP NOSOURCE command.@ 6. Executes the commands in a DO clause, if you specified one" when you set the tracepoint. 7. Resumes execution.@ You set a tracepoint at a particular location in your programB by specifying an address expres ©sion with the SET TRACE command.? You set a tracepoint on consecutive source lines, classes ofA instructions, or events by specifying a qualifier with the SET? TRACE command. Generally, you must specify either an addressA expression or a qualifier, but not both. Exceptions are /EVENT and /RETURN.? The /LINE qualifier sets a tracepoint on each line of source code.9 The following qualifiers set tracepoints on classes of< instructions. Using these qualifiers and /LªINE causes the< debugger to trace every instruction of your program as it8 executes and thus significantly slows down execution. /BRANCH /CALL /INSTRUCTION /RETURN /SYSEMULATE (Alpha only)A The following qualifiers set tracepoints on classes of events: /ACTIVATING /EVENT=event-name /EXCEPTION /TERMINATING 4 Description_(Continued...)B The following qualifiers affect what happens at a routine call: « /INTO /OVER /[NO]SHARE /[NO]SYSTEM?The following qualifiers affect what output is displayed when atracepoint is reached: /[NO]SILENT /[NO]SOURCE= The following qualifiers affect the timing and duration of tracepoints: /AFTER:n /TEMPORARYD Use the /MODIFY qualifier to monitor changes at program locations2 (typically changes in the values of variables).: If you set a tracepoint at a location currently used as; a ¬ breakpoint, the breakpoint is canceled in favor of the tracepoint, and conversely.> Tracepoints can be user defined or predefined. User-defined= tracepoints are set explicitly with the SET TRACE command.B Predefined tracepoints, which depend on the type of program youD are debugging (for example, Ada or multiprocess), are established@ automatically when you start the debugger. Use the SHOW TRACEB command to identify all tracepoints that are currently set. Any1 predefined ­tracepoints are identified as such.? User-defined and predefined tracepoints are set and canceled@ independently. For example, a location or event can have bothB a user-defined and a predefined tracepoint. Canceling the user-D defined tracepoint does not affect the predefined tracepoint, and conversely. Related commands:- (ACTIVATE,DEACTIVATE,SHOW,CANCEL) TRACE CANCEL ALL GO SET BREAK (SET,SHOW) EVENT_FACILITY SET STEP [NO]SOURCE® SET WATCH 4 Examples 1.DBG> SET TRACE SUB3? This command causes the debugger to trace the beginning of0 routine SUB3 when that routine is executed. 2.DBG> SET TRACE/BRANCH/CALL; This command causes the debugger to trace every BRANCH> instruction and every CALL instruction encountered during program execution.. 3.DBG> SET TRACE/LINE/INTO/NOSHARE/NOSYSTEM? This command causes the debugger to trace the beginning ofB every s ¯ource line, including lines in called routines (/INTO)= but not in shareable image routines (/NOSHARE) or system routines (/NOSYSTEM).J 4.DBG> SET TRACE/NOSOURCE TEST5\%LINE 14 WHEN (X .NE. 2) DO (EXAMINE Y)@ This command causes the debugger to trace line 14 of moduleC TEST5 when X is not equal to 2. At the tracepoint, the EXAMINE@ Y command is issued. The /NOSOURCE qualifier suppresses the< display of source code at the tracepoint. The syntax of? the condi°tional expression in the WHEN clause is language- dependent./ 5.DBG> SET TRACE/INSTRUCTION WHEN (X .NE. 0)B This command causes the debugger to trace when X is not equalB to 0. The condition is tested at each instruction encounteredB during execution. The syntax of the conditional expression in+ the WHEN clause is language-dependent.0 6.DBG> SET TRACE/SILENT SUB2 DO (SET WATCH K)? This command causes the debugger to trace the beginning of= routine ± SUB2 during execution. At the tracepoint, the DOB clause sets a watchpoint on variable K. The /SILENT qualifierD suppresses the "trace . . . " message and the display of source@ code at the tracepoint. This example shows a convenient way? of setting a watchpoint on a nonstatic (stack or register)< variable. A nonstatic variable is defined only when itsA defining routine (SUB2, in this case) is active (on the call stack)./ 7.DBG> SET TRACE/RETURN ROUT4 DO (E ²XAMINE X)9 This command causes the debugger to trace the returnA instruction of routine ROUT4 (that is, just before execution? returns to the calling routine). At the tracepoint, the DO> clause issues the EXAMINE X command. This example shows aB convenient way of obtaining the value of a nonstatic variableC just before execution leaves that variable's defining routine.$ 8.DBG> SET TRACE/EVENT=TERMINATEDA This command causes the debugger to trace the poi³nt at which9 any task makes a transition to the TERMINATED state. 3 TYPE= Establishes the default type to be associated with programA locations that do not have a symbolic name (and, therefore, doB not have an associated compiler-generated type). When used withC /OVERRIDE, it establishes the default type to be associated with: all locations, overriding any compiler-generated types. Format SET TYPE type-keyword 4 Parameters ASCICD ´ Sets the default type to counted ASCII string with a 1-byte countB field that precedes the string and gives its length. AC is also accepted as a keyword. ASCIDB Sets the default type to ASCII string descriptor. The CLASS andA DTYPE fields of the descriptor are not checked, but the LENGTH> and POINTER fields provide the character length and address@ of the ASCII string. The string is then displayed. AD is also accepted as a keyword. ASCII:nD Sets the de µfault type to ASCII character string (length n bytes).@ The length indicates both the number of bytes of memory to beB examined and the number of ASCII characters to be displayed. IfB you do not specify a value for n, the debugger uses the defaultA value of 4 bytes. The value n is interpreted in decimal radix. ASCIWD Sets the default type to counted ASCII string with a 2-byte countA field that precedes the string and gives its length. This dataD type occurs in PASCAL a¶nd PL/I. AW is also accepted as a keyword. ASCIZD Sets the default type to zero-terminated ASCII string. The endingD zero byte indicates the end of the string. AZ is also accepted as a keyword. BYTE9 Sets the default type to byte integer (length 1 byte). D_FLOAT8 Sets the default type to D_floating (length 8 bytes). DATE_TIME= Sets the default type to date and time. This is a quadwordB integer (length 8 bytes) containing the internal repr·esentationC of date and time. Values are displayed in the format dd-mmm-yyyy= hh:mm:ss.cc. Specify an absolute date and time as follows:! [dd-mmm-yyyy[:]] [hh:mm:ss.cc] EXTENDED_FLOATC (Alpha only) Sets the default type to IEEE X_floating (length 16 bytes). G_FLOAT8 Sets the default type to G_floating (length 8 bytes). INSTRUCTIONC Sets the default type to instruction (variable length, dependingC on the number of instruction operands and the¸ kind of addressing modes used). LONG_FLOAT= (Alpha only) Sets the default type to IEEE S_Floating type& (single precision, length 4 bytes). LONG_LONG_FLOAT= (Alpha only) Sets the default type to IEEE T_Floating type& (double precision, length 8 bytes). LONGWORDC Sets the default type to longword integer (length 4 bytes). This? is the default type for program locations that do not have a9 symbolic name (do not have a compiler-generated type).¹ OCTAWORD? Sets the default type to octaword integer (length 16 bytes). PACKED:nA Sets the default type to packed decimal. The value of n is the> number of decimal digits. Each digit occupies one nibble (4 bits). QUADWORD> Sets the default type to quadword integer (length 8 bytes). TYPE=expressionD Sets the default type to the type denoted by expression (the nameD of a variable or data type declared in the program). This enables/ you to ºspecify an application-declared type. S_FLOAT= (Alpha only) Sets the default type to IEEE S_Floating type& (single precision, length 4 bytes). T_FLOATB On Alpha systems, sets the default type to IEEE T_Floating type& (double precision, length 8 bytes). X_FLOATB On Alpha systems, sets the default type to IEEE X_floating type (length 16 bytes). WORD: Sets the default type to word integer (length 2 bytes). 4 Qualifiers /OVERR»IDED Associates the type specified with all program locations, whether@ or not they have a symbolic name (whether or not they have an' associated compiler-generated type). 4 DescriptionC When you use EXAMINE, DEPOSIT, or EVALUATE commands, the defaultD types associated with address expressions affect how the debugger, interprets and displays program entities.B The debugger recognizes the compiler-generated types associated@ with symbolic address expressions (symb ¼olic names declared in@ your program), and it interprets and displays the contents ofA these locations accordingly. For program locations that do not? have a symbolic name and, therefore, no associated compiler-@ generated type, the default type in all languages is longwordC integer, which is appropriate for debugging 32-bit applications.? The default data type for untyped storage locations has been9 changed from longword (32 bits) to quadword (64 bits).D On Alpha syst ½ems, when debugging applications that use the 64-bit? address space, you should use the SET TYPE QUADWORD command.> The SET TYPE command enables you to change the default type> associated with locations that do not have a symbolic name.B The SET TYPE/OVERRIDE command enables you to set a default typeB for all program locations, both those that do and do not have a symbolic name.A The EXAMINE and DEPOSIT commands have type qualifiers (/ASCII,D /BYTE, /G_FLOAT, and so on)¾ which enable you to override, for theD duration of a single command, the type previously associated with any program location. Related commands: CANCEL TYPE/OVERRIDE DEPOSIT EXAMINE (SET,SHOW,CANCEL) RADIX (SET,SHOW,CANCEL) MODE SHOW TYPE 4 Examples 1.DBG> SET TYPE ASCII:8A This command establishes an 8-byte ASCII character string as@ the default type associated with untyped program locations.$ 2.DBG> SET TY¿PE/OVERRIDE LONGWORDB This command establishes longword integer as the default type? associated with both untyped program locations and program2 locations that have compiler-generated types. 3.DBG> SET TYPE D_FLOAT< This command establishes D_Floating as the default type/ associated with untyped program locations.! 4.DBG> SET TYPE TYPE=(S_ARRAY)A This command establishes the type of the variable S_ARRAY as@ the default type associated with untypeÀd program locations. 3 WATCHA Establishes a watchpoint at the location denoted by an address expression. Format, SET WATCH address-expression[, . . . ]. [WHEN(conditional-expression)]' [DO(command[; . . . ])] 4 Parameters address-expression@ Specifies an address expression (a program location) at which@ a watchpoint is to be set. With high-level languages, this isB typically the name of a program variable anÁd can include a pathD name to uniquely specify the variable. More generally, an address@ expression can also be a memory address or a register and canB be composed of numbers (offsets) and symbols, as well as one orA more operators, operands, or delimiters. For information aboutA the operators that you can use in address expressions, see the) Address_Expressions online help topic.7 Do not specify the asterisk (*) wildcard character. conditional-expressionD SpeciÂfies a conditional expression in the currently set language;C the expression is to be evaluated whenever execution reaches theD watchpoint. (The debugger checks the syntax of the expressions inB the WHEN clause when execution reaches the watchpoint, not whenB the watchpoint is set.) If the expression is true, the debuggerA reports that a watchpoint has been triggered. If an action (DOC clause) is associated with the watchpoint, it will occur at this@ time. If the expression is Ãfalse, a report is not issued, theA commands specified by the DO clause (if one was specified) are4 not executed, and program execution is continued. command@ Specifies a debugger command to be executed as part of the DOD clause when watch action is taken. The debugger checks the syntaxA of the commands in a DO clause when it executes the DO clause," not when the watchpoint is set. 4 Qualifiers /AFTER /AFTER:nB Specifies that watch action not Ä be taken until the nth time theA designated watchpoint is encountered (n is a decimal integer).A Thereafter, the watchpoint occurs every time it is encountered@ provided that conditions in the WHEN clause are true. The SET: WATCH/AFTER:1 command has the same effect as SET WATCH. /INTOA Specifies that the debugger is to monitor a nonstatic variableD by tracing instructions not only within the defining routine, butA also within a routine that is called from the definin Åg routine@ (and any other such nested calls). The SET WATCH/INTO commandD enables you to monitor nonstatic variables within called routinesA more precisely than SET WATCH/OVER; but the speed of execution8 within called routines is faster with SET WATCH/OVER. /OVERA Specifies that the debugger is to monitor a nonstatic variable@ by tracing instructions only within the defining routine, not@ within a routine that is called by the defining routine. As aA result, the dÆebugger executes a called routine at normal speed? and resumes tracing instructions only when execution returns? to the defining routine. The SET WATCH/OVER command provides@ faster execution than SET WATCH/INTO; but if a called routineD modifies the watched variable, execution is interrupted only uponA returning to the defining routine. When you set watchpoints on6 nonstatic variables, SET WATCH/OVER is the default. /SILENT /SILENT /NOSILENT (default)ÇB Controls whether the "watch . . . " message and the source line@ for the current location are displayed at the watchpoint. TheC /NOSILENT qualifier specifies that the message is displayed. TheC /SILENT qualifier specifies that the message and source line are: not displayed. The /SILENT qualifier overrides /SOURCE. /SOURCE /SOURCE (default) /NOSOURCE? Controls whether the source line for the current location isD displayed at the watchpoint. The /SOUÈRCE qualifier specifies thatB the source line is displayed. The /NOSOURCE qualifier specifies? that the source line is not displayed. The /SILENT qualifier? overrides /SOURCE. See also the SET STEP [NO]SOURCE command. /STATIC /STATIC /NOSTATICB Enables you to override the debugger's default determination ofB whether a specified variable (watchpoint location) is static or? nonstatic. The /STATIC qualifier specifies that the debugger> should treat the Évariable as a static variable, even though> it might be allocated in P1 space. This causes the debugger? to monitor the location by using the faster write-protectionA method rather than by tracing every instruction. The /NOSTATICB qualifier specifies that the debugger should treat the variableC as a nonstatic variable, even though it might be allocated in P0D space, and causes the debugger to monitor the location by tracing= every instruction. Be careful when using these qualifÊiers. /TEMPORARY@ Causes the watchpoint to disappear after it is triggered (the/ watchpoint does not remain permanently set). 4 Description> When an instruction causes the modification of a watchpoint6 location, the debugger takes the following actions:; 1. Suspends program execution after that instruction has completed execution.A 2. If you specified /AFTER when you set the watchpoint, checks@ the AFTER count. If the specified number of counts h Ëas notA been reached, execution continues and the debugger does not" perform the remaining steps.A 3. Evaluates the expression in a WHEN clause, if you specified: one when you set the watchpoint. If the value of the? expression is false, execution continues and the debugger+ does not perform the remaining steps.@ 4. Reports that execution has reached the watchpoint location7 ("watch of . . . ") unless you specified /SILENT.D 5. Reports the old (u Ìnmodified) value at the watchpoint location.B 6. Reports the new (modified) value at the watchpoint location.< 7. Displays the line of source code at which execution is? suspended, unless you specified /NOSOURCE or /SILENT whenD you set the watchpoint or entered a previous SET STEP NOSOURCE command.@ 8. Executes the commands in a DO clause, if you specified oneA when you set the watchpoint. If the DO clause contains a GOD command, execution continues and Í the debugger does not perform the next step. 9. Issues the prompt.@ For high-level language programs, the address expressions youC specify with the SET WATCH command are typically variable names.? If you specify an absolute memory address that is associated> with a compiler-generated type, the debugger symbolizes theA address and uses the length in bytes associated with that typeB to determine the length in bytes of the watchpoint location. IfB you specify an ab Îsolute memory address that the debugger cannotC associate with a compiler-generated type, the debugger watches 4D bytes of memory (by default), beginning at the byte identified byB the address expression. You can change this length, however, byD setting the type to either WORD (SET TYPE WORD, which changes theC default length to 2 bytes) or BYTE (SET TYPE BYTE, which changes@ the default length to 1 byte). SET TYPE LONGWORD restores the default length of 4 bytes.4 You can Ï set a watchpoint on a range, for example, SET WATCH 30000:300018C The debugger establishes a series of longword watches that cover the range.@ You can set watchpoints on aggregates (that is, entire arrays? or records). A watchpoint set on an array or record triggersB if any element of the array or record changes. Thus, you do notA need to set watchpoints on individual array elements or record> components. Note, however, that you cannot set an aggregate" watchpoÐint on a variant record.= You can also set a watchpoint on a record component, on anC individual array element, or on an array slice (a range of array@ elements). A watchpoint set on an array slice triggers if anyB element within that slice changes. When setting the watchpoint,- follow the syntax of the current language. 4 Description,_Continued...= The following qualifiers affect what output is seen when a watchpoint is reached: /[NO]SILENT /[NOÑ]SOURCE= The following qualifiers affect the timing and duration of watchpoints: /AFTER:n /TEMPORARY> The following qualifiers apply only to nonstatic variables: /INTO /OVERD The following qualifier overrides the debugger's determination of- whether a variable is static or nonstatic: /[NO]STATIC& NOTE Related commands:0 (ACTIVATE,DEACTIVATE,SHOW,CANCEL) WATCH MONÒITOR SET BREAK SET STEP [NO]SOURCE SET TRACE #4 Static_and_Nonstatic_Watchpoints# Static and Nonstatic Watchpoints@ The technique for setting a watchpoint depends on whether the# variable is static or nonstatic.? A static variable is associated with the same memory address< throughout execution of the program. You can always set a8 watchpoint on a static variable throughout execution.> A nonstatic variable is allocated on the call s Ótack or in aD register and has a value only when its defining routine is active@ (on the call stack). Therefore, you can set a watchpoint on a@ nonstatic variable only when execution is currently suspendedB within the scope of the defining routine (including any routineC called by the defining routine). The watchpoint is canceled when@ execution returns from the defining routine. With a nonstatic@ variable, the debugger traces every instruction to detect any: changes in the va Ôlue of a watched variable or location.? Another distinction between static and nonstatic watchpointsB is speed of execution. To watch a static variable, the debuggerC write-protects the page containing the variable. If your programA attempts to write to that page, an access violation occurs and> the debugger handles the exception, determining whether theC watched variable was modified. Except when writing to that page,( the program executes at normal speed.; To watch a Õnonstatic variable, the debugger traces every@ instruction in the variable's defining routine and checks theB value of the variable after each instruction has been executed.B Since this significantly slows execution, the debugger issues a/ message when you set a nonstatic watchpoint.? As explained in the next paragraphs, /[NO]STATIC, /INTO, andD /OVER enable you to exercise some control over speed of execution- and other factors when watching variables.D The debugger de Ötermines whether a variable is static or nonstaticC by checking how it is allocated. Typically, a static variable isD in P0 space (0 to 3FFFFFFF, hexadecimal); a nonstatic variable isD in P1 space (40000000 to 7FFFFFFF) or in a register. The debugger@ issues a warning if you try to set a watchpoint on a variableC that is allocated in P1 space or in a register when execution isD not currently suspended within the scope of the defining routine.A The /[NO]STATIC qualifiers enable × you to override this default@ behavior. For example, if you have allocated nonstack storageC in P1 space, use /STATIC when setting a watchpoint on a variableD that is allocated in that storage area. This enables the debugger< to use the faster write-protection method of watching theA location instead of tracing every instruction. Conversely, if,C for example, you have allocated your own call stack in P0 space,@ use /NOSTATIC when setting a watchpoint on a variable that isC Ø allocated on that call stack. This enables the debugger to treat, the watchpoint as a nonstatic watchpoint.9 You can also control the execution speed for nonstatic; watchpoints in called routines by using /INTO and /OVER.A On Alpha processors, both static and nonstatic watchpoints areB available. With static watchpoints, the debugger write-protects> the page of memory in which the watched variable is stored.A Static watchpoints, therefore, would interfere with the system ÙA service itself if not for the debugger's use of system service interception (SSI).C If a static watchpoint is in effect then, through system service@ interception, the debugger deactivates the static watchpoint,C asynchronous traps (ASTs), and thread switching, just before the@ system service call. The debugger reactivates them just afterA the system service call completes, putting the watchpoint, AST> enabling, and thread switching back to their original state@ and Ú, finally, checking for any watchpoint hits. This behavior@ is designed to allow the system service to run as it normally@ would (that is, without write-protected pages) and to preventC the AST code or a different thread from potentially changing the@ watchpointed location while the watchpoint is deactivated. BeD aware of this behavior if, for example, your application tests to see if ASTs are enabled.B An active static watchpoint can cause a system service to fail,= likel Ûy with an ACCVIO status, if the system service is not? supported by the system service interception (SSI) vehicle (C SYS$SSISHR on OpenVMS Alpha systems). Any system service that isB not in SYS$PUBLIC_VECTORS is unsupported by SSI, including UserC Written System Services (UWSS) and any loadable system services, such as $MOUNT.B When a static watchpoint is active, the debugger write-protectsC the page containing the variable to be watched. A system serviceB call not suppÜorted by SSI can fail if it tries to write to that page of user memory.5 To avoid this failure, do either of the following:? o Deactivate the static watchpoint before the service call.@ When the call completes, check the watchpoint manually and reactivate it.D o Use nonstatic watchpoints. Note that nonstatic watchpoints can slow execution.A If a watched location changes during a system service routine,@ you will be notified, as usual, that the watc Ýhpoint occurred.D Note that, on rare occasions, stack may show one or more debuggerA frames on top of the frame or frames for your program. To workA around this problem, enter one or more STEP/RETURN commands to get back to your program.= System service interception is on by default, but on Alpha; processors only, you can disable interception prior to a6 debugging session by issuing the following command:" $ DEFINE SSI$AUTO_ACTIVATE OFF< To reenable system servicÞe interception, issue one of the following commands:! $ DEFINE SSI$AUTO_ACTIVATE ON $ DEASSIGN SSI$AUTO_ACTIVATE 4 Global_Section_Watchpoints? On Alpha processors, you can set watchpoints on variables orC arbitrary program locations in global sections. A global section@ is a region of memory that is shared among all processes of aB multiprocess program. A watchpoint that is set on a location inC a global section (a global section watchpoint) triggers when an ßy2 process modifies the contents of that location.> You set a global section watchpoint just as you would set aC watchpoint on a static variable. However, because of the way theC debugger monitors global section watchpoints, note the followingD point. When setting watchpoints on arrays or records, performanceA is improved if you specify individual elements rather than the/ entire structure with the SET WATCH command.B If you set a watchpoint on a location that is not yàet mapped to@ a global section, the watchpoint is treated as a conventional> static watchpoint. When the location is subsequently mapped? to a global section, the watchpoint is automatically treatedA as a global section watchpoint and an informational message isB issued. The watchpoint is then visible from each process of the multiprocess program. Examples 1.DBG> SET WATCH MAXCOUNTB This command establishes a watchpoint on the variable MAXCOUNT. 2.DBG> SET áWATCH ARR DBG> GO . . .) watch of SUBR\ARR at SUBR\%LINE 12+8 old value: (1): 7 (2): 12 (3): 3 new value: (1): 7 (2): 12 (3): 28 break at SUBR\%LINE 14 DBG>> In this example, the SET WATCH command sets a watchpoint onB the three-element integer array, ARR. Execution is then resumedB with the GO command. The watchpoint triggâers whenever any array< element changes. In this case, the third element changed. 3.DBG> SET WATCH ARR(3)D This command sets a watchpoint on element 3 of array ARR (Fortran< array syntax). The watchpoint triggers whenever element 3 changes. 4.DBG> SET WATCH P_ARR[3:5]? This command sets a watchpoint on the array slice consisting? of elements 3 to 5 of array P_ARR (Pascal array syntax). The= watchpoint triggers whenever any of these elements change.% 5.DBG ã> SET WATCH P_ARR[3]:P_ARR[5]C This command sets a separate watchpoint on each of elements 3 toC 5 of array P_ARR (Pascal array syntax). Each watchpoint triggers' whenever its target element changes.0 6.DBG> SET TRACE/SILENT SUB2 DO (SET WATCH K)= In this example, variable K is a nonstatic variable and is> defined only when its defining routine, SUB2, is active (on> the call stack). The SET TRACE command sets a tracepoint on? SUB2. When the tracepoint is triggered du äring execution, theD DO clause sets a watchpoint on K. The watchpoint is then canceledB when execution returns from routine SUB2. The /SILENT qualifierB suppresses the "trace . . . " message and the display of source code at the tracepoint. 7.DBG> gI %DEBUG-I-ASYNCSSWAT, possible asynchronous system service and staticB watchpoint collision break at LARGE_UNION\main\%LINE 24192+60 DBG> sho callL module name routine name line rel PC åabs PCS *LARGE_UNION main 24192 00000000000003A0 00000000000303A0S *LARGE_UNION __main 24155 0000000000000110 0000000000030110S FFFFFFFF80B90630 FFFFFFFF80B90630 DBG> ex/sour %line 24192 module LARGE_UNIONT 24192: sstatus = sys$getsyi (EFN$C_ENF, &sysid, 0, &syi_ile, &myiosb, 0, 0);@ In this example, an asynchronous write by SYS$QIO to its IOSB@ output parameter fails ifæ that IOSB is being watched directlyB or even if it simply lives on the same page as an active static watchpoint.C Debugger notices this problem and warns the user about potential@ collisions between static watchpoints and asynchronous system services. 3 WINDOWD Creates a screen window definition. This command is not available@ in the VSI DECwindows Motif for OpenVMS user interface to the debugger. Format SET WINDOW window-name* ç AT (start-line,line-count. [,start-column,column-count]) 4 Parameters window-nameA Specifies the name of the window you are defining. If a windowD definition with that name already exists, it is canceled in favor of the new definition. start-line> Specifies the starting line number of the window. This lineA displays the window title, or header line. The top line of the screen is line 1. line-countA Specifies the number èof text lines in the window, not countingC the header line. The value must be at least 1. The sum of start-A line and line-count must not exceed the current screen height. start-columnB Specifies the starting column number of the window. This is theB column at which the first character of the window is displayed.1 The leftmost column of the screen is column 1. column-countA Specifies the number of characters per line in the window. The@ value must be at leas ét 1. The sum of start-column and column-2 count must not exceed the current screen width. 4 DescriptionA A screen window is a rectangular region on the terminal screen? through which you can view a display. The SET WINDOW command? establishes a window definition by associating a window nameD with a screen region. You specify the screen region in terms of aD starting line and height (line count) and, optionally, a starting= column and width (column count). If you do not êspecify theA starting column and column count, the starting column defaultsB to column 1 and the column count defaults to the current screen width.C You can specify a window region in terms of expressions that use) the built-in symbols %PAGE and %WIDTH.A You can use the names of any windows you have defined with theB SET WINDOW command in a DISPLAY command to position displays on the screen.C Window definitions are dynamic-that is, window dimensions expandB ë and contract proportionally when a SET TERMINAL command changes the screen width or height. Related commands: DISPLAY (SHOW,CANCEL) DISPLAY (SET,SHOW) TERMINAL (SHOW,CANCEL) WINDOW 4 Examples% 1.DBG> SET WINDOW ONELINE AT (1,1)B This command defines a window named ONELINE at the top of theC screen. The window is one line deep and, by default, spans the width of the screen.* 2.DBG> SET WINDOW MIDDLE AT (9,4,30,20)D ì This command defines a window named MIDDLE at the middle of theB screen. The window is 4 lines deep starting at line 9, and 20( columns wide starting at column 30.@ 3.DBG> SET WINDOW FLEX AT (%PAGE/4,%PAGE/2,%WIDTH/4,%WIDTH/2)D This command defines a window named FLEX that occupies a regionC around the middle of the screen and is defined in terms of the6 current screen height (%PAGE) and width (%WIDTH). 2 SHOW 3 ABORT_KEY> Identifies the Ctrl-keyí sequence currently defined to abort> the execution of a debugger command or to interrupt program execution.& NOTEC This command is not available in the VSI DECwindows Motif for- OpenVMS user interface to the debugger. Format SHOW ABORT_KEY 4 DescriptionC By default, the Ctrl/C sequence, when entered within a debugging: session, aborts the execution of a debugger command andB interrupts program execution. Theî SET ABORT_KEY command enablesA you to assign the abort function to another Ctrl-key sequence.> The SHOW ABORT_KEY command identifies the Ctrl-key sequence. currently in effect for the abort function. Related commands: Ctrl/C SET ABORT_KEY 4 Example DBG> SHOW ABORT_KEY Abort Command Key is CTRL_C DBG> SET ABORT_KEY = CTRL_P DBG> SHOW ABORT_KEY Abort Command Key is CTRL_P DBG>A In this example, the first SHOW ABORT_KEY command identifiesCï the default abort command key sequence, Ctrl/C. The SET ABORT_? KEY = CTRL_P command assigns the abort-command function to? Ctrl/P, as confirmed by the second SHOW ABORT_KEY command. 3 ASTD Indicates whether delivery of asynchronous system traps (ASTs) is enabled or disabled. Format SHOW AST 4 Description= The SHOW AST command indicates whether delivery of ASTs isB enabled or disabled. The command does not identify an AST whoseB delivðery is pending. The delivery of ASTs is enabled by defaultD and with the ENABLE AST command. The delivery of ASTs is disabled with the DISABLE AST command. Related commands: (ENABLE,DISABLE) AST 4 Example DBG> SHOW AST ASTs are enabled DBG> DISABLE AST DBG> SHOW AST ASTs are disabled DBG>C The SHOW AST command indicates whether the delivery of ASTs is enabled. 3 ATSIGN= Identifies the default file specification established withñ; the last SET ATSIGN command. The debugger uses this fileC specification when processing the execute procedure (@) command. Format SHOW ATSIGN 4 Description Related commands: @ (Execute Procedure) SET ATSIGN 4 Examples 1.DBG> SHOW ATSIGN@ No indirect command file default in effect, using DEBUG.COM DBG>> This example shows that if you did not use the SET ATSIGN> command, the debugger assumes command procedures òhave the5 default file specification SYS$DISK:[]DEBUG.COM.+ 2.DBG> SET ATSIGN USER:[JONES.DEBUG].DBG DBG> SHOW ATSIGN< Indirect command file default is USER:[JONES.DEBUG].DBG DBG>C In this example, the SHOW ATSIGN command indicates the default= file specification for command procedures, as previously- established with the SET ATSIGN command. 3 BREAK* Displays information about breakpoints. Format SHOW BREAK 4 Qualifióers /PREDEFINED5 Displays information about predefined breakpoints. /USER7 Displays information about user-defined breakpoints. 4 Description@ The SHOW BREAK command displays information about breakpointsC that are currently set, including any options such as WHEN or DOA clauses, /AFTER counts, and so on, and whether the breakpoints are deactivated.? By default, SHOW BREAK displays information about both user-B defined and predefined breakp ôoints (if any). This is equivalentC to entering the SHOW BREAK/USER/PREDEFINED command. User-defined= breakpoints are set with the SET BREAK command. PredefinedA breakpoints are set automatically when you start the debugger,< and they depend on the type of program you are debugging.D If you established a breakpoint using SET BREAK/AFTER:n, the SHOWB BREAK command displays the current value of the decimal integerA n, that is, the originally specified integer value minus 1 forõ? each time the breakpoint location was reached. (The debuggerB decrements n each time the breakpoint location is reached until> the value of n is 0, at which time the debugger takes break action.)< On Alpha systems, the SHOW BREAK command does not displayB individual instructions when the break is on a particular class? of instruction (as with SET BREAK/CALL or SET BREAK/RETURN). Related commands:, (ACTIVATE,CANCEL,DEACTIVATE,SET) BREAK 4 Examplesö 1.DBG> SHOW BREAK breakpoint at SUB1\LOOP breakpoint at MAIN\MAIN+1F, do (EX SUB1\D ; EX/SYMBOLIC PSL; GO)$ breakpoint at routine SUB2\SUB2 /after: 2 DBG>? The SHOW BREAK command identifies all breakpoints that areC currently set. This example indicates user-defined breakpoints= that are triggered whenever execution reaches SUB1\LOOP,, MAIN\MAIN, and SUB2\SUB2, respectively. 2.DBG> SHOW BREAK/PREDEFINED> predefined brea ÷kpoint on Ada event "DEPENDENTS_EXCEPTION" for any value> predefined breakpoint on Ada event "EXCEPTION_TERMINATED" for any value DBG>@ This command identifies the predefined breakpoints that areA currently set. The example shows two predefined breakpoints,B which are associated with Ada tasking exception events. TheseB breakpoints are set automatically by the debugger for all AdaD programs and for any mixed language program that is linked wi øth an Ada module. 3 CALLS1 Identifies the currently active routine calls. Format SHOW CALLS [integer] 4 Parameters integerB A decimal integer that specifies the number of routine calls toD be identified. If you omit the parameter, the debugger identifies2 all routine calls for which it has information. 4 Qualifiers /IMAGEB Displays the image name for each active call on the call stack. 4 DescriptionC The SHO ùW CALLS command shows a traceback that lists the sequence< of active routine calls that lead to the routine in whichD execution appears suspended. Each recursive routine call is shownA in the display, that is, you can use the SHOW CALLS command to" examine the chain of recursion.B SHOW CALLS displays one line of information for each call frameA on the call stack, starting with the most recent call. The topA line identifies the currently executing routine, the next lineB i údentifies its caller, the following line identifies the caller of the caller, and so on.A Even if your program contains no routine calls, the SHOW CALLSD command displays an active call because your program has at least; one stack frame built for it when it is first activated.= On Alpha and Integrity server processors, you also usually@ see a system and sometimes a DCL base frame. Note that if the@ SHOW CALLS display shows no active calls, either your program? has termiûnated or the call stack has been corrupted. As your? program executes, whenever a call is made to a routine a new> call frame is built on the stack(s) or in the register set.B Each call frame stores information about the calling or currentB routine. For example, the frame PC value enables the SHOW CALLSC command to symbolize to module and routine information. On AlphaC processors, a routine invocation results in either a stack frame@ procedure (with a call frame on the memory üstack), a registerB frame procedure (with a call frame stored in the register set),4 or a null frame procedure (without a call frame).B On Integrity server processors, a routine invocation can resultB in a memory stack frame and/or a register stack frame. That is,A there two stacks on Integrity servers, register and memory. AnB Integrity server routine invocation could result in call framesB on one or the other or both of those stacks. Also, an IntegrityC server leaf routineý invocation (that does not itself make calls)@ can result in a null frame procedure, without a call frame on= either stack. SHOW CALLS provides one line of information,> regardless of the which stack or register results. (See the examples below.) 4 Description,_Continued...B The following information is provided for each line of the SHOW CALLS display:D o The name of the enclosing module. An asterisk (*) to the left8 of a module name indicates that the mo þdule is set.A o The name of the calling routine, provided the module is set= (the first line shows the currently executing routine).> o The line number where the call was made in that routine,? provided the module is set (the first line shows the line. number at which execution is suspended).< o The value of the PC in the calling routine at the time@ that control was transferred to the called routine. On VAXD processors, the PC value is shown as a mem ÿory address relativeD to the nearest preceding symbol value (for example, a routine)D and also as an absolute address. On Alpha and Integrity serverA processors, the PC is shown as a memory address relative toB the first code address in the module and also as an absolute address.D When you specify the /IMAGE qualifier, the debugger first doesC a SET IMAGE command for each image that has debug information< (that is, it was linked using the /DEBUG or /TRACEBACK? qualifier). The debugger then displays the image name forA each active call on the calls stack. The output display hasD been expanded and displays the image name in the first column.? The debugger suppresses the share$image_name module name,C because that information is provided by the /IMAGE qualifier.C The SET IMAGE command lasts only for the duration of the SHOWD CALLS/IMAGE command. The debugger restores the set image state4 when the SHOW CALLS/IMAGE command is complete. Related commands: SHOW SCOPE SHOW STACK 4 Examples 1.DBG> SHOW CALLS@ module name routine name line rel PC abs PCF *MAIN FFFF 31 00000000000002B8 00000000000203C4* -the above appears to be a null frameH in the same scope as the frame belowF *MAIN MAIN 13 00000000000000A8 00000000000200A8F  0000000000000000 FFFFFFFF8255A1F8? This example has been reformatted for Help, and may appearD slightly different from the actual output display. This exampleC is on an Alpha system. Note that sections of routine prologues@ and epilogues appear to the debugger to be null frames. TheC portion of the prologue before the change in the frame pointerB (FP) and the portion of the epilogue after restoration of theB FP each look like a null frame, and are rep orted accordingly. 2.DBG> SHOW CALLSL module name routine name line rel PC abs PCR *MAIN FFFF 18 0000000000000190 0000000000010190R *MAIN MAIN 14 0000000000000180 0000000000010180R FFFFFFFF80C2A200 FFFFFFFF80C2A200? This example has been reformatted for Help, and may appearD slightly different from the actual output display. This exampleB is on Integrity servers. Note that Integrity server prologues5 do not appear to be null frames to the debugger. 3 DEFINEA Identifies the default (/ADDRESS, /COMMAND, /PROCESS_GROUP, or6 /VALUE) currently in effect for the DEFINE command. Format SHOW DEFINE 4 Description? The default qualifier for the DEFINE command is the one lastB established with the SET DEFINE command. If you did not enter a9 SET DEFINE command, the default qualifier is /ADDRESS.@ To identify a symbol defined with the DEFINE command, use the SHOW SYMBOL/DEFINED command. Related commands: DEFINE DEFINE/PROCESS_SET DELETE SET DEFINE SHOW SYMBOL/DEFINED 4 Example DBG> SHOW DEFINE# Current setting is: DEFINE/ADDRESS DBG>> This command indicates that the DEFINE command is set for definition by address. 3 DISPLAY3 Identifies one or more existing screen displays.&  NOTEC This command is not available in the VSI DECwindows Motif for- OpenVMS user interface to the debugger. Format+ SHOW DISPLAY [display-name[, . . . ]] 4 Parameters display-nameA Specifies the name of a display. If you do not specify a name,D or if you specify the asterisk (*) wildcard character by itself,? all display definitions are listed. You can use the wildcard@ within a display name. Do not specify a display name with the /ALL qualifier. 4 Qualifiers /ALL! Lists all display definitions. 4 DescriptionA The SHOW DISPLAY command lists all displays according to their? order in the display list. The most hidden display is listedB first, and the display that is on top of the display pasteboard is listed last.= For each display, the SHOW DISPLAY command lists its name,? maximum size, screen window, and display kind (including anyA debug command list). It also identifies whether the display is? removed from the pasteboard or is dynamic (a dynamic displayD automatically adjusts its window dimensions if the screen size is* changed with the SET TERMINAL command). Related commands: DISPLAY EXTRACT/SCREEN_LAYOUT (CANCEL) DISPLAY (SET,CANCEL,SHOW) WINDOW SHOW SELECT 4 Example DBG> SHOW DISPLAY& display SRC at H1, size = 64, dynamic6 kind = SOURCE (EXAMINE/SOURCE .%SOU RCE_SCOPE\%PC)0 display INST at H1, size = 64, removed, dynamic4 kind = INSTRUCTION (EXAMINE/INSTRUCTION .0\%PC)A display REG at RH1, size = 64, removed, dynamic, kind = REGISTER7 display OUT at S45, size = 100, dynamic, kind = OUTPUTA display EXSUM at Q3, size = 64, dynamic, kind = DO (EXAMINE SUM)9 display PROMPT at S6, size = 64, dynamic, kind = PROGRAM DBG>C The SHOW DISPLAY command lists all displays currently defined.? In this example, they include the five predefin ed displays? (SRC, INST, REG, OUT, and PROMPT), and the user-defined DO> display EXSUM. Displays INST and REG are removed from theD display pasteboard: the DISPLAY command must be used to display them on the screen. 3 EDITORD Indicates the action taken by the EDIT command, as established by the SET EDITOR command. Format SHOW EDITOR 4 Description Related commands: EDIT SET EDITOR 4 Examples 1.DBG> SHOW EDI TOR- The editor is SPAWNed, with command line# "EDT/START_POSITION=(n,1)" DBG>? In this example, the EDIT command spawns the EDT editor in@ a subprocess. The /START_POSITION qualifier appended to the@ command line indicates that the editing cursor is initiallyD positioned at the beginning of the line that is centered in the' debugger's current source display.! 2.DBG> SET EDITOR/CALLABLE_TPU DBG> SHOW EDITOR8 The editor is CALLABLE_ TPU, with command line "TPU" DBG>@ In this example, the SHOW EDITOR command indicates that the> EDIT command invokes the callable version of the VSI Text> Processing Utility (TPU). The editing cursor is initially2 positioned at the beginning of source line 1. 3 EVENT_FACILITYA Identifies the current event facility and the associated event names.< Event facilities are available for programs that call AdaB routines or that use POSIX threads services . On VAX processors,B event facilities are also available for programs that call SCAN routines. Format SHOW EVENT_FACILITY 4 DescriptionA The current event facility (ADA, THREADS, or SCAN) defines the@ eventpoints that you can set with the SET BREAK/EVENT and SET TRACE/EVENT commands.= The SHOW EVENT_FACILITY command identifies the event names< associated with the current event facility. These are theB keywords that you can specify with the (SET,CANCEL) BREAK/EVENT) and (SET,CANCEL) TRACE/EVENT commands. Related commands: (SET,CANCEL) BREAK/EVENT SET EVENT_FACILITY (SET,CANCEL) TRACE/EVENT SHOW BREAK SHOW TASK SHOW TRACE 4 Example DBG> SHOW EVENT_FACILITY event facility is THREADS . . .= This command identifies the current event facility to beA THREADS (POSIX threads) and lists the associated event names= that can be used with SET BREAK/EVENT or SET TRACE/EVENT commands. 3 EXIT_HANDLERS? Identifies the exit handlers that have been declared in your program. Format SHOW EXIT_HANDLERS 4 DescriptionA The exit handler routines are displayed in the order that they@ are called (that is, last in, first out). The routine name isA displayed symbolically, if possible. Otherwise, its address is= displayed. The debugger's exit handlers are not displayed. 4 Example DBG> SHOW EXIT_HANDLERS exit handler at STACKS\CLEANUP DBG>D This command identifies the exit handler routine CLEANUP, which" is declared in module STACKS. 3 IMAGEA Displays information about one or more images that are part of your running program. Format SHOW IMAGE [image-name] 4 Parameters image-nameC Specifies the name of an image to be included in the display. If@ you do not specify a name, or if you specify the asterisk (*)C wildcard character by itself, all images are listed. You can use% the wildcard within an image name. 4 Qualifiers /FULL: Displays complete information for a running image. This; information includes all of the image sections and their addresses. 4 Description= The SHOW IMAGE command displays the following information: o Name of the image* o Start and end addresses of the image? o Whether the image has been set with the SET IMAGE command2 (loaded into the run-time symbol table, RST)B o Current image that is your debugging context (marked with an asterisk (*))4 o Total number of images selected in the displayA o Approximate number of bytes allocated for the RST and other internal structuresC o A summary of the address space occupied by the images in your processB On Integrity servers and Alpha, if you specify an image name or@ use the /FULL qualifier, the image sections for the image are also displayed.D On Integrity servers, the /ALL qualifier displays all the images,? including those for which the Debugger is unable to complete> processing. In that case, the debugger shows the image name$ without the base and end address.? In the following example, the Debugger is unable to complete/ processing for the SYS$PUBLIC_VECTORS image: DBG> SHOW IMAGE/ALLH image name set base address end addressM CMA$TIS_SHR no 000000007B54A000 000000007B5694EFM *C_MAIN yes 0000000000010000 00000000000400F7M C_SHARED_AV no 0000000000042000 00000000000A20DFM DBGTBKMSG no 000000000068A000 0000000000697D03M DCL no 000000007ADCC000 000000007AEF7217M DEBUG no 00000000002DC000 000000000062F037M DECC$MSG no 000000000067E000 0000000000681F5FM DECC$SHR no 000000007B8F6000 000000007B95803FM DPML$SHR no 000000007B6DC000 000000007B738C97M LIBOTS no 000000007B37C000 000000007B38D9B7M LIBRTL no 000000007B34A000 000000007B37A06FM SHRIMGMSG no 0000000000682000 000000000068881C" SYS$PUBLIC_VECTORS noM SYS$SSISHR no 0000000000630000 00000000006442F7M SYS$SSISHRP no 0000000000646000 00000000006501F7M TIE$SHARE no 00000000000A4000 00000000002A87CFC SHOW IMAGE does not display all of the memory ranges of an imageA installed using the /RESIDENT qualifier. Instead, this command) displays only the process data region. Related commands: (SET,CANCEL) IMAGE (SET,SHOW) MODULE 4 Example DBG> SHOW IMAGE SHARE*: image name set base address end address7 *SHARE yes 00000200 00000FFF7 SHARE1 no 00001000 000017FF7 SHARE2 yes 00018C00 000191FF7 SHARE3 no 00019200 000195FF7 SHARE4 no 00019600 0001B7FF. total images: 5 bytes allocated: 33032 DBG>? This SHOW IMAGE command identifies all of the images whose= names start with SHARE and which are associated with the? program. Images SHARE and SHARE2 are set. The asterisk (*)+ identifies SHARE as the current image. 3 KEY= Displays the debugger predefined key definitions and those% created by the DEFINE/KEY command.& NOTEC This command is not available in the VSI DECwindows Motif for- OpenVMS user interface to the debugger. Format SHOW KEY [key-name] 4 Parameters key-nameA Specifies a function key whose definition is displayed. Do notB use the asterisk (*) wildcard character. Instead, use the /ALL@ qualifier. Do not specify a key name with /ALL or /DIRECTORY." Valid key names are as follows: Key LK2012 Name Keyboard VT100-type VT52-type- PF1 PF1 PF1 Blue, PF2 PF2 PF2 Red. PF3 PF3 PF3 Black PF4 PF4 PF43  KP0-KP9 Keypad 0-9 Keypad 0-9 Keypad 0-9! PERIOD Keypad Keypad% period (.) period (.)' COMMA Keypad comma Keypad comma (,) (,). ENTER Enter ENTER ENTER E1 Find E2 Insert Here E3 Remove E4 Select E5 Prev Screen E6 Next Screen HELP Help DO Do F6-F20 F6-F20 4 Qualifiers /ALLB Displays all key definitions for the current state, by default,+ or for the states specified with /STATE. /BRIEF@ Displays only the key definitions (by default, all qualifiersA associated with a key definition are also shown, including any specified state). /DIRECTORY@ Displays the names of all the states for which keys have been@ defined. Do not specify other qualifiers with this qualifier. /STATE$ /STATE=(state-name [, . . . ]) /NOSTATE (default); S elects one or more states for which a key definition isC displayed. The /STATE qualifier displays key definitions for theC specified states. You can specify predefined key states, such asD DEFAULT and GOLD, or user-defined states. A state name can be anyC appropriate alphanumeric string. The /NOSTATE qualifier displays. key definitions for the current state only. 4 DescriptionC Keypad mode must be enabled (SET MODE KEYPAD) before you can use3 this command. Keypad mode is enabled by default.B By default, the current key state is the DEFAULT state. You canA change the current state by using the SET KEY/STATE command orD by pressing a key that causes a state change (that is, a key that9 was defined with DEFINE/KEY/LOCK_STATE or /SET_STATE). Related commands: DEFINE/KEY DELETE/KEY SET KEY 4 Examples 1.DBG> SHOW KEY/ALLB This command displays all the key definitions for the current state.!  2.DBG> SHOW KEY/STATE=BLUE KP8 GOLD keypad definitions:3 KP8 = "Scroll/Top" (noecho,terminate,nolock) DBG>A This command displays the definition for keypad key 8 in the BLUE state. 3.DBG> SHOW KEY/BRIEF KP8 DEFAULT keypad definitions: KP8 = "Scroll/Up" DBG>A This command displays the definition for keypad key 8 in the current state. 4.DBG> SHOW KEY/DIRECTORY MOVE_GOLD MOVE_BLUE MOVE GOLD  EXPAND_GOLD EXPAND_BLUE EXPAND DEFAULT CONTRACT_GOLD CONTRACT_BLUE CONTRACT BLUE DBG>A This command displays the names of the states for which keys have been defined. 3 LANGUAGE# Identifies the current language. Format SHOW LANGUAGE 4 Description= The current language is the language last established with@ the SET LANGUAGE command. If you did not enter a SET LANGUAGED command, the curren t language is, by default, the language of the& module containing the main program. Related command: SET LANGUAGE 4 Example DBG> SHOW LANGUAGE language: BASIC DBG>> This command displays the name of the current language as BASIC. 3 LOG> Indicates whether the debugger is writing to a log file and# identifies the current log file. Format SHOW LOG 4 DescriptionA The current log file is the log file last establish!ed by a SETC LOG command. By default, if you did not enter a SET LOG command,9 the current log file is the file SYS$DISK:[]DEBUG.LOG. Related commands: SET LOG SET OUTPUT [NO]LOG SET OUTPUT [NO]SCREEN_LOG 4 Examples 1.DBG> SHOW LOG not logging to DEBUG.LOG DBG>> This command displays the name of the current log file asC DEBUG.LOG (the default log file) and reports that the debugger is not writing to it. 2.DBG"> SET LOG PROG4 DBG> SET OUTPUT LOG DBG> SHOW LOG+ logging to USER$:[JONES.WORK]PROG4.LOG DBG>> In this example, the SET LOG command establishes that the: current log file is PROG4.LOG (in the current default? directory). The SET OUTPUT LOG command causes the debuggerB to log debugger input and output into that file. The SHOW LOGB command confirms that the debugger is writing to the log file1 PROG4.COM in your current default directory. # 3 MARGINSD Identifies the current source-line margin settings for displaying source code.& NOTEC This command is not available in the VSI DECwindows Motif for- OpenVMS user interface to the debugger. Format SHOW MARGINS 4 Description; The current margin settings are the margin settings last? established with the SET MARGINS command. By default, if youC did not enter a SET MARGINS command, the left margin $is set to 1& and the right margin is set to 255. Related command: SET MARGINS 4 Examples 1.DBG> SHOW MARGINS' left margin: 1 , right margin: 255 DBG>D This command displays the default margin settings of 1 and 255. 2.DBG> SET MARGINS 50 DBG> SHOW MARGINS& left margin: 1 , right margin: 50 DBG>C This command displays the default left margin setting of 1 and- the modified right margin setting of 50. 3.DBG%> SET MARGINS 10:60 DBG> SHOW MARGINS' left margin: 10 , right margin: 60 DBG>B This command displays both margin settings modified to 10 and 60. 3 MODE> Identifies the current debugger modes (screen or no screen,8 keypad or nokeypad, and so on) and the current radix. Format SHOW MODE 4 DescriptionA The current debugger modes are the modes last established withD the SET MODE command. By default, if you did not enter a SET MO&DE0 command, the current modes are the following: DYNAMIC NOG_FLOAT (D_float) INTERRUPT KEYPAD LINE NOSCREEN SCROLL NOSEPARATE SYMBOLIC Related commands: (SET,CANCEL) MODE (SET,SHOW,CANCEL) RADIX 4 Example DBG> SHOW MODE8 modes: symbolic, line, d_float, screen, scroll, keypad,. dynamic, interrupt, no separate window input radix :decimal output radix:decimal DBG>A The SHO'W MODE command displays the current modes and current input and output radix. 3 MODULE? Displays information about the modules in the current image. Format SHOW MODULE [module-name] 4 Parameters module-nameC Specifies the name of a module to be included in the display. If@ you do not specify a name, or if you specify the asterisk (*)@ wildcard character by itself, all modules are listed. You canC use a wildcard within a module name. (Shareable image modules are' selected only if you specify /SHARE. 4 Qualifiers /RELATED /RELATED /NORELATED (default); (Applies to Ada programs.) Controls whether the debugger; includes, in the SHOW MODULE display, any module that isA related to a specified module through a with-clause or subunit relationship.> The SHOW MODULE/RELATED command displays related modules as< well as those specified. The display identifies the exact@ relatio)nship. By default (/NORELATED), no related modules areB selected for display (only the modules specified are selected). /SHARE /SHARE /NOSHARE (default)= Controls whether the debugger includes, in the SHOW MODULE@ display, any shareable images that have been linked with your@ program. By default (/NOSHARE) no shareable image modules are selected for display.A The debugger creates dummy modules for each shareable image inB your program. The names of th *ese shareable "image modules" haveD the prefix SHARE$. The SHOW MODULE/SHARE command identifies theseA shareable image modules, as well as the modules in the current image.? Setting a shareable image module loads the universal symbols@ for that image into the run-time symbol table so that you can? reference these symbols from the current image. However, youA cannot reference other (local or global) symbols in that imageB from the current image. This feature overlaps the+ effect of the+ newer SET IMAGE and SHOW IMAGE commands. 4 DescriptionC The SHOW MODULE command displays the following information about, one or more modules selected for display: o Name of the moduleC o Programming language in which the module is coded, unless all, modules are coded in the same languageB o Whether the module has been set with the SET MODULE command.A That is, whether the symbol records of the module have been< loaded into the ,debugger's run-time symbol table (RST)@ o Space (in bytes) required in the RST for symbol records in that module5 o Total number of modules selected in the display> o Number of bytes allocated for the RST and other internal= structures (the amount of heap space in use in the main debugger's process)& NOTE@ The current image is either the main image (by default) orB the image established as the current image by -a previous SET IMAGE command.6 For information specific to Ada programs, type Help Language_Support Ada. Related commands: (SET,SHOW,CANCEL) IMAGE SET MODE [NO]DYNAMIC (SET) MODULE (SET,SHOW,CANCEL) SCOPE SHOW SYMBOL 4 Examples 1.DBG> SHOW MODULE) module name symbols size( TEST yes 432( SCREEN_IO no 2807 total PASCAL modules: 2. bytes allocated.: 2740. DBG>C In this example, the SHOW MODULE command, without a parameter,A displays information about all of the modules in the currentB image, which is the main image by default. This example shows= the display format when all modules have the same sourceA language. The symbols column shows that module TEST has been' set, but module SCREEN_IO has not.# 2.DBG> SHOW MODULE FOO,MAIN,SUB*4 module name symbols language size3 F /OO yes MACRO 4323 MAIN no FORTRAN 2803 SUB1 no FORTRAN 1643 SUB2 no FORTRAN 2042 total modules: 4. bytes allocated: 60720. DBG>B In this example, the SHOW MODULE command displays information? about the modules FOO and MAIN, and all modules having the? prefix SUB. This example shows the display format when the2 modules do not have the 0 same source language. 3.DBG> SHOW MODULE/SHARE4 module name symbols language size4 FOO yes MACRO 4324 MAIN no FORTRAN 280 . . .4 SHARE$DEBUG no Image 04 SHARE$LIBRTL no Image 04 SHARE$MTHRTL no Image 04 SHARE$SHARE1 no Image 04 SHARE$SHARE2 no Image 0 14 total modules: 17. bytes allocated: 162280.! DBG> SET MODULE SHARE$SHARE2' DBG> SHOW SYMBOL * IN SHARE$SHARE2B In this example, the SHOW MODULE/SHARE command identifies allA of the modules in the current image and all of the shareable@ images (the names of the shareable images are prefixed withC SHARE$. The SET MODULE SHARE$SHARE2 command sets the shareableB image module SHARE$SHARE2. The SHOW SYMBOL command identifiesA any universal symbols d2efined in the shareable image SHARE2. 3 OUTPUT) Identifies the current output options. Format SHOW OUTPUT 4 DescriptionC The current output options are the options last established withA the SET OUTPUT command. By default, if you did not enter a SET? OUTPUT command, the output options are: NOLOG, NOSCREEN_LOG, TERMINAL, NOVERIFY. Related commands: SET LOG SET MODE SCREEN SET OUTPUT 4 Example DBG> SHOW OUTPU3T noverify, terminal, screen_log,- logging to USER$:[JONES.WORK]DEBUG.LOG;9 DBG>= This command shows the following current output options:C o Debugger commands read from debugger command procedures are# not echoed on the terminal.; o Debugger output is being displayed on the terminal.= o The debugging session is being logged to the log file& USER$:[JONES.WORK]DEBUG.LOG;9.D o The screen contents are logged as they are updated in sc4reen mode. 3 PROCESS@ Displays information about processes that are currently under debugger control. Format+ SHOW PROCESS [process-spec[, . . . ]] 4 Parameters process-specC Specifies a process currently under debugger control. Use any of the following forms:D [%PROCESS_NAME] process- The process name, if that name does notD name contain spaces or lowercase characters.= The p 5rocess name can include the> asterisk (*) wildcard character.D [%PROCESS_NAME] The process name, if that name contains@ "process-name " spaces or lowercase characters. YouD can also use apostrophes (') instead of1 quotation marks (").; %PROCESS_PID process_id The process identifier (PID, a1 hexadecimal number).B [%PROCESS_NUMBER] The number 6assigned to a process when? process-number it comes under debugger control. AA (or %PROC process- new number is assigned sequentially,A number) starting with 1, to each process. IfB a process is terminated with the EXIT? or QUIT command, the number can be@ assigned again during the debuggingA session. Process numbers appear in a@ 7 SHOW PROCESS display. Processes areC ordered in a circular list so they canA be indexed with the built-in symbolsA %PREVIOUS_PROCESS and %NEXT_PROCESS.6 process-set-name A symbol defined with theD DEFINE/PROCESS_SET command to represent2 a group of processes.? %NEXT_PROCESS The next process after the visible 8? process in the debugger's circular* process list.@ %PREVIOUS_PROCESS The process previous to the visible? process in the debugger's circular* process list.C %VISIBLE_PROCESS The process whose stack, register set,C and images are the current context forA looking up symbols, register values,C 9 routine calls, breakpoints, and so on.D You can also use the asterisk (*) wildcard character or the /ALLD qualifier to specify all processes. Do not specify a process withA /ALL or /DYNAMIC. If you do not specify a process or /ALL with@ /BRIEF, /FULL, or /[NO]HOLD, the visible process is selected. 4 Qualifiers /ALL; Selects all processes known to the debugger for display. /BRIEFC (Default) Displays only one line of information for e:ach process selected for display. /DYNAMIC@ Shows whether dynamic process setting is enabled or disabled.B Dynamic process setting is enabled by default and is controlled, with the SET PROCESS/[NO]DYNAMIC command. /FULL= Displays maximum information for each process selected for display. /VISIBLE6 (Default). Selects the visible process for display. 4 Description@ The SHOW PROCESS command displays information about specified7 processes ; and any images running in those processes.D The SHOW PROCESS/FULL command also displays information about theA availability and use of the vector processor. This information< is useful if you are debugging a program that uses vector instructions.B A process can first appear in a SHOW PROCESS display as soon asB it comes under debugger control. A process can no longer appearC in a SHOW PROCESS display if it is terminated through an EXIT or QUIT command.@ By defaul <t (/BRIEF), one line of information is displayed for) each process, including the following:C o The process number assigned by the debugger. A process number@ is assigned sequentially, starting with process 1, to each@ process that comes under debugger control. If a process isB terminated by an EXIT or QUIT command, its process number isC not reused during that debugging session. The visible process= is marked with an asterisk (*) in the leftmost column.= o The process name.3 o The current debugging state for that process.B o The location (symbolized, if possible) at which execution of- the image is suspended in that process.C The SHOW PROCESS/FULL command gives additional information about processes (see the examples). Related commands: CONNECT Ctrl/C DEFINE/PROCESS_SET EXIT QUIT SET PROCESS 4 Examples 1.all> SHOW PROCESS4 Number Name > State Current PC9 * 2 _WTA3: break SCREEN\%LINE 47 all>> By default, the SHOW PROCESS command displays one line of? information about the visible process (which is identifiedC with an asterisk (*) in the leftmost column). The process hasD the process name _WTA3:. It is the second process brought under@ debugger control (process number 2). It is on hold, and theA image's execution is suspended at a breakpoint at line 47 of ? module SCREEN. 2.all> SHOW PROCESS TEST_32 Number Name State Current PC7 7 TEST_3 watch of TEST_3\ROUT4\COUNT; TEST_3\%LINE 54 all>? This SHOW PROCESS command displays one line of informationD about process TEST_3. The image is suspended at a watchpoint of variable COUNT. 3.all> SHOW PROCESS/DYNAMIC' Dynamic process setting is enabled all>D This command @indicates that dynamic process setting is enabled. 3 RADIXD Identifies the current radix for the entry and display of integerA data or, if you specify /OVERRIDE, the current override radix. Format SHOW RADIX 4 Qualifiers /OVERRIDE) Identifies the current override radix. 4 DescriptionA The debugger can interpret and display integer data in any one@ of four radixes: binary, decimal, hexadecimal, and octal. TheA current radix for the A entry and display of integer data is the5 radix last established with the SET RADIX command.B If you did not enter a SET RADIX command, the default radix forA both data entry and display is decimal for most languages. The@ exceptions are BLISS and MACRO, which have a default radix of hexadecimal.@ The current override radix for the display of all data is the> override radix last established with the SET RADIX/OVERRIDEB command. If you did not enter a SET RADIX/OVERRIDBE command, the override radix is "none". Related commands: DEPOSIT EVALUATE EXAMINE (SET,CANCEL) RADIX 4 Examples 1.DBG> SHOW RADIX input radix: decimal output radix: decimal DBG>@ This command identifies the input radix and output radix as decimal. 2.DBG> SET RADIX/OVERRIDE HEX DBG> SHOW RADIX/OVERRIDE' output override radix: hexadecimal DBG>= In this example, the SET RADIX/OVERCRIDE command sets the> override radix to hexadecimal and the SHOW RADIX/OVERRIDEC command indicates the override radix. This means that commandsB such as EXAMINE display all data as hexadecimal integer data. 3 SCOPE> Identifies the current scope search list for symbol lookup. Format SHOW SCOPE 4 Description? The current scope search list designates one or more programB locations (specified by path names or other special characters)A to be u Dsed in the interpretation of symbols that are specified2 without pathname prefixes in debugger commands.> The current scope search list is the scope search list lastA established with the SET SCOPE command. By default, if you didB not enter a SET SCOPE command, the current scope search list is 0,1,2, . . . ,n.= The default scope search list specifies that, for a symbol? without a pathname prefix, a symbol lookup such as EXAMINE X? first looks for X in the routine that E is currently executingA (scope 0); if no X is visible there, the debugger looks in theC caller of that routine (scope 1), and so on down the call stack;B if X is not found in scope n, the debugger searches the rest ofC the run-time symbol table (RST)-that is, all set modules and the+ global symbol table (GST), if necessary.< If you used a decimal integer in the SET SCOPE command to@ represent a routine in the call stack, the SHOW SCOPE commandB displays the name of the Froutine represented by the integer, if possible. Related commands: (SET,CANCEL) SCOPE 4 Examples 1.DBG> CANCEL SCOPE DBG> SHOW SCOPE scope:0 * 0 [ = EIGHTQUEENS\TRYCOL\REMOVEQUEEN ],$ 1 [ = EIGHTQUEENS\TRYCOL ],& 2 [ = EIGHTQUEENS\TRYCOL 1 ],& 3 [ = EIGHTQUEENS\TRYCOL 2 ],& 4 [ = EIGHTQUEENS\TRYCOL 3 ],& 5 [ = EIGHTQUEENS\TRYCOL 4 ], 6 [ = EIGHTQUEENS ] DBG> SET SCOPE/CURRENT 2 DBGG> SHOW SCOPE scope:0 0 [ = EIGHTQUEENS\TRYCOL\REMOVEQUEEN ],$ 1 [ = EIGHTQUEENS\TRYCOL ],& * 2 [ = EIGHTQUEENS\TRYCOL 1 ],& 3 [ = EIGHTQUEENS\TRYCOL 2 ],& 4 [ = EIGHTQUEENS\TRYCOL 3 ],& 5 [ = EIGHTQUEENS\TRYCOL 4 ], 6 [ = EIGHTQUEENS ] DBG>? The CANCEL SCOPE command restores the default scope searchC list, which is displayed by the (first) SHOW SCOPE command. InA this example, execution is suspended at rou Htine REMOVEQUEEN,B after several recursive calls to routine TRYCOL. The asteriskC (*) indicates that the scope search list starts with scope 0,> the scope of the routine in which execution is suspended.@ The SET SCOPE/CURRENT command resets the start of the scopeB search list to scope 2. Scope 2 is the scope of the caller ofA the routine in which execution is suspended. The asterisk inA the output of the (second) SHOW SCOPE command indicates that3 the scoIpe search list now starts with scope 2.+ 2.DBG> SET SCOPE 0,STACKS\R2,SCREEN_IO,\ DBG> SHOW SCOPE scope: 0, [= TEST ], STACKS\R2, SCREEN_IO, \ DBG>@ In this example, the SET SCOPE command directs the debugger? to look for symbols without pathname prefixes according toA the following scope search list. First the debugger looks inA the PC scope (denoted by 0, which is in module TEST). If the@ debugger cann Jot find a specified symbol in the PC scope, it@ then looks in routine R2 of module STACKS; if necessary, itC then looks in module SCREEN_IO, and then finally in the globalD symbol table (denoted by the global scope (\)). The SHOW SCOPE@ command identifies the current scope search list for symbolB lookup. No asterisk is shown in the SHOW SCOPE display unlessC the default scope search list is in effect or you have entered! a SET SCOPE/CURRENT command. 3 SEAKRCHC Identifies the default qualifiers (/ALL or /NEXT, /IDENTIFIER or7 /STRING) currently in effect for the SEARCH command. Format SHOW SEARCH 4 Description@ The default qualifiers for the SEARCH command are the defaultB qualifiers last established with the SET SEARCH command. If youA did not enter a SET SEARCH command, the default qualifiers are /NEXT and /STRING. Related commands: SEARCH (SET,SHOW) LANGUAGE SET SEARCH L 4 Example DBG> SHOW SEARCH9 search settings: search for next occurrence, as a string DBG> SET SEARCH IDENT DBG> SHOW SEARCH> search settings: search for next occurrence, as an identifier DBG> SET SEARCH ALL DBG> SHOW SEARCH> search settings: search for all occurrences, as an identifier DBG>@ In this example, the first SHOW SEARCH command displays theA default settings for the SET SEARCH command. By default, theB debugger searches for and displays the next occ Murrence of the string.? The second SHOW SEARCH command indicates that the debuggerA searches for the next occurrence of the string, but displays= the string only if it is not bounded on either side by a? character that can be part of an identifier in the current language.> The third SHOW SEARCH command indicates that the debugger= searches for all occurrences of the string, but displaysA the strings only if they are not bounded on either side by Na? character that can be part of an identifier in the current language. 3 SELECT= Identifies the displays currently selected for each of theB display attributes: error, input, instruction, output, program, prompt, scroll, and source.& NOTEC This command is not available in the VSI DECwindows Motif for- OpenVMS user interface to the debugger. Format SHOW SELECT 4 Description8 The display attriObutes have the following properties:> o A display that has the error attribute displays debugger diagnostic messages.A o A display that has the input attribute echoes your debugger input.? o A display that has the instruction attribute displays the? decoded instruction stream of the routine being debugged.B The display is updated when you enter an EXAMINE/INSTRUCTION command.C o A display that has the output attribute displays any debugger5 P output that is not directed to another display.? o A display that has the program attribute displays programB input and output. Currently only the PROMPT display can have the program attribute.C o A display that has the prompt attribute is where the debuggerD prompts for input. Currently, only the PROMPT display can have the PROMPT attribute.D o A display that has the scroll attribute is the default display0 for the SCROLL, MOVE, and EXPAND cQommands.A o A display that has the source attribute displays the sourceB code of the module being debugged, if available. The displayA is updated when you enter a TYPE or EXAMINE/SOURCE command. Related commands: SELECT SHOW DISPLAY 4 Example DBG> SHOW SELECT display selections: scroll = SRC input = none output = OUT error = PROMPT source = SRC instruction = none program = PROMPT promptR = PROMPT DBG>> The SHOW SELECT command identifies the displays currentlyB selected for each of the display attributes. These selections$ are the defaults for languages. 3 SOURCEB Identifies the source directory search lists and search methods currently in effect. Format SHOW SOURCE 4 Qualifiers /DISPLAYD Identifies the search list used when the debugger displays source code. /EDIT@ Identifies the search list to S be used during execution of the debugger's EDIT command. 4 DescriptionA The SET SOURCE/MODULE=module-name command establishes a source@ directory search list for a particular module. The SET SOURCE= command establishes a source directory search list for allB modules not explicitly mentioned in a SET SOURCE/MODULE=module-? name command. When you have used those commands, SHOW SOURCEC identifies the source directory search list associated with each search category T.@ If a source directory search list has not been established byA using the SET SOURCE or SET SOURCE/MODULE=module-name command,B the SHOW SOURCE command indicates that no directory search listB is currently in effect. In this case, the debugger expects eachD source file to be in the same directory that it was in at compileA time (the debugger also checks that the version number and theC creation date and time of a source file match the information in the debugger's symb Uol table).D The /EDIT qualifier is needed when the files used for the displayD of source code are different from the files to be edited by using@ the EDIT command. This is the case with Ada programs. For AdaB programs, the SHOW SOURCE command identifies the search list of@ files used for source display (the copied source files in AdaB program libraries); the SHOW SOURCE/EDIT command identifies the@ search list for the source files you edit when using the EDIT command.4 V For information specific to Ada programs, see the# Language_Support Ada help topic. Related commands: (SET,CANCEL) SOURCE 4 Examples 1.DBG> SHOW SOURCE( no directory search list in effect,- match the latest source file version7 DBG> SET SOURCE [PROJA],[PROJB],DISK:[PETER.PROJC] DBG> SHOW SOURCE2 source directory search list for all modules,. match the latest source file version: [PROJA] [PROJB]W DISK:[PETER.PROJC] DBG>D In this example, the SET SOURCE command directs the debugger toD search the directories [PROJA],[PROJB], and DISK:[PETER.PROJC].@ By default, the debugger searches for the latest version of source files.: 2.DBG> SET SOURCE/MODULE=CTEST/EXACT [], DISK$2:[PROJD] DBG> SHOW SOURCE, source directory search list for CTEST,- match the exact source file version: [] DISK$2:[PROJD]8 X source directory search list for all other modules,* match the latest source file version: [PROJA] [PROJB] DISK:[PETER.PROJC] DBG>A In this example, the SET SOURCE command directs the debugger? to search the current default directory ([]) and directoryB DISK$2:[PROJD] for source files to use with the module CTEST.? The /EXACT qualifier specifies that the search will locateC the exact version of the CTEST source filesY found in the debug symbol table. 3 STACK> Displays information on the currently active routine calls. Format SHOW STACK [integer] 4 Parameters integer= Specifies the number of frames to display. If you omit the> parameter, the debugger displays information about all call frames. 4 Qualifiers /START_LEVEL /START_LEVEL=nC Directs SHOW STACK to begin displaying information at call frameC level n. For examplZe, to see stack information for only frame 3, enter the following command: DBG> SHOW STACK/START=3 1= To see details for the 4th and 5th stack frames, enter the following command: DBG> SHOW STACK/START=4 2 4 DescriptionC For each call frame, the SHOW STACK command displays informationC such as stack pointers, condition handler, saved register valuesD (Alpha), local register allocation (Integrity servers). Note that@ an argument passed through a re[gister or an argument list mayC contain the addresses of the actual argument. In such cases, useB the EXAMINE address-expression command to display the values of these arguments.A On Alpha and Integrity server processors, a routine invocation can result in:> o A stack frame procedure, with a call frame on the memory stack,A o A register frame procedure, with a call frame stored in the> register set (Alpha) or on the register stack (Integrity serv\ers), or2 o A null frame procedure, without a call frame; The SHOW STACK command provides information on all three@ procedures: stack frame, register frame, and null frame. (See the examples below.) Related command: SHOW CALLS 4 Examples Alpha example: DBG> SHOW STACK invocation block 0 FP: 000000007F907AD03 Detected what appears to be a NULL frameM NULL frames operate in the same invocation ]context as their caller8 NULL Procedure Descriptor (0000000000010050):+ Flags: 3089@ KIND: PDSC$K_KIND_FP_STACK (09)+ Signature Offset 00000 Entry Address: MAIN\FFFF3 Procedure Descriptor (0000000000010000):+ Flags: 3089@ KIND: PDSC$K_KIND_FP_STACK (09)$ FP is Base Register+ ^ Rsa Offset: 0008+ Signature Offset 0000+ Entry Address: MAIN7 Ireg Mask: 20000004 ? RA Saved @ 000000007F907AD8: FFFFFFFF8255A1F8? R2 Saved @ 000000007F907AE0: 000000007FFBF880? FP Saved @ 000000007F907AE8: 000000007F907B30/ Freg Mask: 00000000/ Size: 00000020 invocation bl _ock 1 FP: 000000007F907B303 Procedure Descriptor (FFFFFFFF8255D910):+ Flags: 3099@ KIND: PDSC$K_KIND_FP_STACK (09) Handler Valid$ FP is Base Register+ Rsa Offset: 0048+ Signature Offset 00012 Entry Address: -2108317536> Ireg Mask: 20002084 ? R `A Saved @ 000000007F907B78: 000000007FA28160? R2 Saved @ 000000007F907B80: 0000000000000000? R7 Saved @ 000000007F907B88: 000000007FF9C9E0? R13 Saved @ 000000007F907B90: 000000007FA00900? FP Saved @ 000000007F907B98: 000000007F907BB0/ Freg Mask: 00000000/ Size: 000000702 Condition Handler: -2108303104 DBG>B In the above example, a note that sections of routine prologues@ and epilogues appear to the debugger to be null frames. TheC portion of the prologue before the change in the frame pointerB (FP) and the portion of the epilogue after restoration of theB FP each look like a null frame, and are reported accordingly.C Integrity servers example-The following abbreviations are used in the example:- GP-Global data segement Pointer (%R1)B PC-Program Counter (Instruction Pointer b+ instruction slot number)' SP-Stack Pointer (memory stack)2 BSP-Backing Store Pointer (register stack) CFM-Current Frame Marker DBG> SHOW STACKA Invocation block 0 Invocation handle 000007FDC0000270' GP: 0000000000240000 PC: MAIN\FFFF) In prologue region$ RETURN PC: MAIN\%LINE 15' SP: 000000007AD13B40! Is memory stack frame:/ c previous SP: 000000007AD13B40' BSP: 000007FDC0000270# Is register stack frame:/ previous BSP: 000007FDC0000248' CFM: 0000000000000005- No locals Outs R32 : R36A Invocation block 1 Invocation handle 000007FDC0000248' GP: 0000000000240000$ PC: MAIN\%LINE 15( RETURN PC: 0FFFFFFFF80C2A200' SP: 000000007AD13B40! d Is memory stack frame:/ previous SP: 000000007AD13B70' BSP: 000007FDC0000248# Is register stack frame:/ previous BSP: 000007FDC0000180' CFM: 000000000000028A5 Ins/Locals R32 : R36 Outs R37 : R41A Invocation block 2 Invocation handle 000007FDC0000180( GP: 0FFFFFFFF844DEC00( PC: 0FFFFFFFF80C2A200, RETURN PC: SHARE$DCL_CODE0+5AB9F' e SP: 000000007AD13B70! Is memory stack frame:/ previous SP: 000000007AD13BC0' BSP: 000007FDC0000180# Is register stack frame:/ previous BSP: 000007FDC00000B8 Has handler:8 function value: 0FFFFFFFF842DFBD0' CFM: 0000000000000C205 Ins/Locals R32 : R55 Outs R56 : R63 DBG>; See VSI OpenVMS Calling Standard for more inforfmation. 3 STEPD Identifies the default qualifiers (/INTO, /INSTRUCTION, /NOSILENT7 and so on) currently in effect for the STEP command. Format SHOW STEP 4 Description> The default qualifiers for the STEP command are the defaultB qualifiers last established by the SET STEP command. If you didB not enter a SET STEP command, the default qualifiers are /LINE,! /OVER, /NOSILENT, and /SOURCE.? Enabling screen mode by pressing PF1-PF3 enters the SET SgTEP> NOSOURCE command as well as the SET MODE SCREEN command (toA eliminate redundant source display in output and DO displays).D In that case, the default qualifiers are /LINE, /OVER, /NOSILENT, and /NOSOURCE. Related commands: STEP SET STEP 4 Example9 DBG> SET STEP INTO,NOSYSTEM,NOSHARE,INSTRUCTION,NOSOURCE DBG> SHOW STEPF step type: nosystem, noshare, nosource, nosilent, into routine calls, by instruction DBG>> In this exahmple, the SHOW STEP command indicates that the) debugger take the following actions:D o Steps into called routines, but not those in system space or in shareable images o Steps by instruction< o Does not display lines of source code while stepping 3 SYMBOLD Displays information about the symbols in the debugger's run-time, symbol table (RST) for the current image.& NOTE@ The current image is either the imain image (by default) orB the image established as the current image by a previous SET IMAGE command. Format< SHOW SYMBOL symbol-name[, . . . ] [IN scope[, . . . ]] 4 Parameters symbol-name> Specifies a symbol to be identified. A valid symbol name is< a single identifier or a label name of the form %LABEL n,= where n is an integer. Compound names such as RECORD.FIELD? or ARRAY[1,2] are not valid. If you specify the asterisk (*)D wildcar jd character by itself, all symbols are listed. You can use% the wildcard within a symbol name. scopeB Specifies the name of a module, routine, or lexical block, or aC numeric scope. It has the same syntax as the scope specificationB in a SET SCOPE command and can include path-name qualification.D All specified scopes must be in set modules in the current image.A The SHOW SYMBOL command displays only those symbols in the RST? for the current image that both match thek specified name and@ are declared within the lexical entity specified by the scopeA parameter. If you omit this parameter, all set modules and the? global symbol table (GST) for the current image are searched? for symbols that match the name specified by the symbol-name parameter. 4 Qualifiers /ADDRESSC Displays the address specification for each selected symbol. The@ address specification is the method of computing the symbol'sD address. It can merely lbe the symbol's memory address, but it canD also involve indirection or an offset from a register value. SomeD symbols have address specifications too complicated to present inC any understandable way. These address specifications are labeled$ "complex address specifications."B On Alpha processors, the command SHOW SYMBOL/ADDRESS procedure-? name displays both the code address and procedure descriptor? address of a specified routine, entry point, or Ada package. /DEFINmEDD Displays symbols you have defined with the DEFINE command (symbol4 definitions that are in the DEFINE symbol table). /DIRECT@ Displays only those symbols that are declared directly in the? scope parameter. Symbols declared in lexical entities nestedD within the scope specified by the scope parameters are not shown. /FULLD Displays all information associated with the /ADDRESS, /TYPE, and /USE_CLAUSE qualifiers.D For C++ modules, if symbol-name is a nclass, SHOW SYMBOL/FULL also( displays information about the class. /LOCALB Displays symbols that are defined with the DEFINE/LOCAL command< (symbol definitions that are in the DEFINE symbol table). /TYPE; Displays data type information for each selected symbol. /USE_CLAUSE? (Applies to Ada programs.) Identifies any Ada package that aA specified block, subprogram, or package names in a use clause.C If the symbol specified is a package, also identifioes any block,B subprogram, package, and so on, that names the specified symbol in a use clause. 4 DescriptionA The SHOW SYMBOL command displays information that the debuggerB has about a given symbol in the current image. This information> might not be the same as what the compiler had or even what= you see in your source code. Nonetheless, it is useful forD understanding why the debugger might act as it does when handling symbols.@ By default, the SHOW SYMBpOL command lists all of the possibleB declarations or definitions of a specified symbol that exist inA the RST for the current image (that is, in all set modules and? in the GST for that image). Symbols are displayed with their? path names. A path name identifies the search scope (module,D nested routines, blocks, and so on) that the debugger must followA to reach a particular declaration of a symbol. When specifying> symbolic address expressions in debugger commands, use pathqD names only if a symbol is defined multiple times and the debugger cannot resolve the ambiguity.? The /DEFINED and /LOCAL qualifiers display information about@ symbols defined with the DEFINE command (not the symbols that? are derived from your program). The other qualifiers display9 information about symbols defined within your program.6 For information specific to Ada programs, type Help Language_Support Ada. Related commands: DEFINE DELETE r SET MODE [NO]LINE SET MODE [NO]SYMBOLIC SHOW DEFINE SYMBOLIZE 4 Examples 1.DBG> SHOW SYMBOL I data FORARRAY\I DBG>C This command shows that symbol I is defined in module FORARRAY4 and is a variable (data) rather than a routine.' 2.DBG> SHOW SYMBOL/ADDRESS INTARRAY1 data FORARRAY\INTARRAY1& descriptor address: 0009DE8B DBG>B This command shows that symbol INTARRAY1 is defined in module3 FORARsRAY and has a memory address of 0009DE8B. 3.DBG> SHOW SYMBOL *PL*? This command lists all the symbols whose names contain the string "PL". 4.DBG> SHOW SYMBOL/TYPE COLOR data SCALARS\MAIN\COLOR> enumeration type (primary, 3 elements), size: 4 bytesA This command shows that the variable COLOR is an enumeration type.$ 5.DBG> SHOW SYMBOL/TYPE/ADDRESS *= This command displays all information about all symbols.' 6.DBG> SHOW SYMBOL * tIN MOD3\COUNTER routine MOD3\COUNTER data MOD3\COUNTER\X data MOD3\COUNTER\Y DBG>? This command lists all the symbols that are defined in the1 scope denoted by the path name MOD3\COUNTER.% 7.DBG> DEFINE/COMMAND SB=SET BREAK DBG> SHOW SYMBOL/DEFINED SB defined SB bound to: SET BREAK was defined /command DBG>> In this example, the DEFINE/COMMAND command defines SB as@ a symbol for the SET BREAuK command. The SHOW SYMBOL/DEFINED& command displays that definition. 3 TASK@ Displays information about the tasks of a multithread program# (also called a tasking program).& NOTE; SET TASK and SET THREAD are synonymous commands. They perform identically. Format' SHOW THREAD [task-spec[, . . . ]] 4 Parameters task-spec: Specifies a task value. Use any of the following forms:) o When thev event facility is THREADS:> - A task (thread) name as declared in the program, or a: language expression that yields a task ID number.B - A task ID number (for example, 2), as indicated in a SHOW THREAD display.% o When the event facility is ADA:> - A task (thread) name as declared in the program, or aD language expression that yields a task value. You can use a path name.B - A task ID (for example, 2), as indicated in w a SHOW THREAD display.1 o One of the following task built-in symbols:B %ACTIVE_TASK The task that runs when a GO, STEP, CALL, or, EXIT command executes.D %CALLER_TASK (Applies only to Ada programs.) When an acceptB statement executes, the task that called theA entry associated with the accept statement.< %NEXT_TASK The task after the visible task in theA debugger's x task list. The ordering of tasksA is arbitrary but consistent within a single' run of a program.B %PREVIOUS_ The task previous to the visible task in the+ TASK debugger's task list.D %VISIBLE_TASK The task whose call stack and register set areA the current context for looking up symbols,B register values, routine calls, breakpoints, and so on.D Dyo not use the asterisk (*) wildcard character. Instead, use theC /ALL qualifier. Do not specify a task with /ALL, /STATISTICS, or /TIME_SLICE. 4 Qualifiers /ALLA Selects all existing tasks for display-namely, tasks that haveC been created and (in the case of Ada tasks) whose master has not yet terminated. /CALLS /CALLS[=n]@ Does a SHOW CALLS command for each task selected for display.? This identifies the currently active routine calls (tzhe call stack) for a task. /FULL. When the event facility is THREADS, use the$ PTHREAD thread -f thread-numbercommand.= Displays additional information for each task selected forC display. The additional information is provided if you use /FULL+ by itself or with /CALLS or /STATISTICS.@ You can get help on POSIX threads debugger commands by typing PTHREAD HELP.B See the Guide to the POSIX Threads Library for more information* about using the P{OSIX threads debugger. /HOLD /HOLD /NOHOLD (default)> When the event facility is THREADS, use the PTHREAD tset -n thread-number command.B Selects either tasks that are on hold, or tasks that are not on hold for display.D If you do not specify a task, /HOLD selects all tasks that are onC hold. If you specify a task list, /HOLD selects the tasks in the task list that are on hold.? If you do not specify a task, /NOHOLD selects all tasks that|C are not on hold. If you specify a task list, /NOHOLD selects the/ tasks in the task list that are not on hold.@ You can get help on POSIX threads debugger commands by typing PTHREAD HELP.B See the Guide to the POSIX Threads Library for more information* about using the POSIX threads debugger. /IMAGEB Displays the image name for each active call on the call stack.( Valid only with the /CALLS qualifier. /PRIORITY /PRIORITY=(n[, . . . ])> W }hen the event facility is THREADS, use the PTHREAD tset -s thread-number command.@ If you do not specify a task, selects all tasks having any ofC the specified priorities, n, where n is a decimal integer from 0C to 15. If you specify a task list, selects the tasks in the task2 list that have any of the priorities specified.@ You can get help on POSIX threads debugger commands by typing PTHREAD HELP.B See the Guide to the POSIX Threads Library for more information* ~ about using the POSIX threads debugger. /STATE /STATE=(state[, . . . ])B If you do not specify a task, selects all tasks that are in anyD of the specified states-RUNNING, READY, SUSPENDED, or TERMINATED.A If you specify a task list, selects the tasks in the task list+ that are in any of the states specified. 4 DescriptionA A task can first appear in a SHOW THREAD display as soon as itC is created. A task can no longer appear in a SHOW THREAD displayA  if it is terminated or (in the case of an Ada tasking program)C if its master is terminated. By default, the SHOW THREAD command; displays one line of information for each task selected.C When you specify the /IMAGE qualifier, the debugger first does aD SET IMAGE command for each image that has debug information (thatC is, it was linked using the /DEBUG or /TRACEBACK qualifier). TheD debugger then displays the image name for each active call on theA calls stack. The output€ display has been expanded and displays& the image name in the first column.D The debugger suppresses the share$image_name module name, because8 that information is provided by the /IMAGE qualifier.@ The SET IMAGE command lasts only for the duration of the SHOWB THREAD/CALLS/IMAGE command. The debugger restores the set image> state when the SHOW THREAD/CALLS/IMAGE command is complete. Related commands: DEPOSIT/TASK EXAMINE/TASK (SET, SHOW) EVENT_FACILITY SET TASK|THREAD 4 Examples 1.DBG> SHOW EVENT_FACILITY event facility is ADA . . . DBG> SHOW TASK/ALL= task id pri hold state substate task object6 * %TASK 1 7 RUN 122624: %TASK 2 7 HOLD SUSP Accept H4.MONITOR; %TASK 3 6 READY Entry call H4.CHECK_IN DBG>@ In this example, the SHOW EVENT_FACILITY command identifiesA ADA as the current ‚event facility. The SHOW TASK/ALL command= provides basic information about all the tasks that were? created through Ada services and currently exist. One line? is devoted to each task. The active task is marked with anD asterisk (*). In this example, it is also the active task (the$ task that is in the RUN state).* 2.DBG> SHOW TASK %ACTIVE_TASK,3,MONITORB This command selects the active task, 3, and task MONITOR for display. 3.DBG> SHOW TASK/PRIOƒRITY=6@ This command selects all tasks with priority 6 for display.$ 4.DBG> SHOW TASK/STATE=(RUN,SUSP)> This command selects all tasks that are either running or suspended for display.% 5.DBG> SHOW TASK/STATE=SUSP/NOHOLDC This command selects all tasks that are both suspended and not on hold for display.< 6.DBG> SHOW TASK/STATE=(RUN,SUSP)/PRIO=7 %VISIBLE_TASK, 3C This command selects for display those tasks among the visibleA task and %T„ASK 3 that are in either the RUNNING or SUSPENDED state and have priority 7. 3 TERMINALA Identifies the current terminal screen height (page) and width being used to format output.& NOTEC This command is not available in the VSI DECwindows Motif for- OpenVMS user interface to the debugger. Format SHOW TERMINAL 4 DescriptionB The current terminal screen height and width are the height andB width l…ast established by the SET TERMINAL command. By default,B if you did not enter a SET TERMINAL command, the current heightC and width are the height and width known to the terminal driver,B as displayed by the DCL command SHOW TERMINAL (usually 24 lines+ and 80 columns for VT-series terminals). Related commands: SET TERMINAL SHOW DISPLAY SHOW WINDOW 4 Example DBG> SHOW TERMINAL terminal width: 80 page: 24 wrap: 80 D†BG>@ This command displays the current terminal screen width andC height (page) as 80 columns and 24 lines, and the message wrap setting at column 80. 3 THREAD@ Displays information about the tasks of a multithread program# (also called a tasking program).& NOTE; SET TASK and SET THREAD are synonymous commands. They perform identically. Format' SHOW THREAD [task-spec[, . . . ]] 4 Parameters‡ task-spec: Specifies a task value. Use any of the following forms:) o When the event facility is THREADS:> - A task (thread) name as declared in the program, or a: language expression that yields a task ID number.B - A task ID number (for example, 2), as indicated in a SHOW THREAD display.% o When the event facility is ADA:> - A task (thread) name as declared in the program, or aD language expression that yields a task ˆvalue. You can use a path name.B - A task ID (for example, 2), as indicated in a SHOW THREAD display.1 o One of the following task built-in symbols:B %ACTIVE_TASK The task that runs when a GO, STEP, CALL, or, EXIT command executes.D %CALLER_TASK (Applies only to Ada programs.) When an acceptB statement executes, the task that called theA entry associated with the accept statement ‰.< %NEXT_TASK The task after the visible task in theA debugger's task list. The ordering of tasksA is arbitrary but consistent within a single' run of a program.B %PREVIOUS_ The task previous to the visible task in the+ TASK debugger's task list.D %VISIBLE_TASK The task whose call stack and register set areA the current context for looking up symbols,B Š register values, routine calls, breakpoints, and so on.D Do not use the asterisk (*) wildcard character. Instead, use theC /ALL qualifier. Do not specify a task with /ALL, /STATISTICS, or /TIME_SLICE. 4 Qualifiers /ALLA Selects all existing tasks for display-namely, tasks that haveC been created and (in the case of Ada tasks) whose master has not yet terminated. /CALLS /CALLS[=n]@ Does a SHOW CALLS com‹mand for each task selected for display.? This identifies the currently active routine calls (the call stack) for a task. /FULL7 When the event facility is THREADS, use the command.= Displays additional information for each task selected forC display. The additional information is provided if you use /FULL+ by itself or with /CALLS or /STATISTICS.@ You can get help on POSIX threads debugger commands by typing PTHREAD HELP.B See the Guide to the POSIX ŒThreads Library for more information* about using the POSIX threads debugger. /HOLD /HOLD /NOHOLD (default)> When the event facility is THREADS, use the PTHREAD tset -n thread-number command.B Selects either tasks that are on hold, or tasks that are not on hold for display.D If you do not specify a task, /HOLD selects all tasks that are onC hold. If you specify a task list, /HOLD selects the tasks in the task list that are on hold.? If you do not specify a task, /NOHOLD selects all tasks thatC are not on hold. If you specify a task list, /NOHOLD selects the/ tasks in the task list that are not on hold.@ You can get help on POSIX threads debugger commands by typing PTHREAD HELP.B See the Guide to the POSIX Threads Library for more information* about using the POSIX threads debugger. /IMAGEB Displays the image name for each active call on the call stack.( Valid only with the /CALLS qualifier.Ž /PRIORITY /PRIORITY=(n[, . . . ])> When the event facility is THREADS, use the PTHREAD tset -s thread-number command.@ If you do not specify a task, selects all tasks having any ofC the specified priorities, n, where n is a decimal integer from 0C to 15. If you specify a task list, selects the tasks in the task2 list that have any of the priorities specified.@ You can get help on POSIX threads debugger commands by typing PTHREAD HELP.B See the Guide to the POSIX Threads Library for more information* about using the POSIX threads debugger. /STATE /STATE=(state[, . . . ])B If you do not specify a task, selects all tasks that are in anyD of the specified states-RUNNING, READY, SUSPENDED, or TERMINATED.A If you specify a task list, selects the tasks in the task list+ that are in any of the states specified. 4 DescriptionA A task can first appear in a SHOW THREAD display as soon as itC is created.  A task can no longer appear in a SHOW THREAD displayA if it is terminated or (in the case of an Ada tasking program)C if its master is terminated. By default, the SHOW THREAD command; displays one line of information for each task selected.C When you specify the /IMAGE qualifier, the debugger first does aD SET IMAGE command for each image that has debug information (thatC is, it was linked using the /DEBUG or /TRACEBACK qualifier). TheD debugger then displays the image na‘me for each active call on theA calls stack. The output display has been expanded and displays& the image name in the first column.D The debugger suppresses the share$image_name module name, because8 that information is provided by the /IMAGE qualifier.@ The SET IMAGE command lasts only for the duration of the SHOWB THREAD/CALLS/IMAGE command. The debugger restores the set image> state when the SHOW THREAD/CALLS/IMAGE command is complete. Related commands: DE’POSIT/TASK EXAMINE/TASK (SET, SHOW) EVENT_FACILITY SET TASK|THREAD 4 Examples 1.DBG> SHOW EVENT_FACILITY event facility is ADA . . . DBG> SHOW TASK/ALL= task id pri hold state substate task object6 * %TASK 1 7 RUN 122624: %TASK 2 7 HOLD SUSP Accept H4.MONITOR; %TASK 3 6 READY Entry call H4.CHECK_IN DBG>@ In this example, the SHOW E “VENT_FACILITY command identifiesA ADA as the current event facility. The SHOW TASK/ALL command= provides basic information about all the tasks that were? created through Ada services and currently exist. One line? is devoted to each task. The active task is marked with anD asterisk (*). In this example, it is also the active task (the$ task that is in the RUN state).* 2.DBG> SHOW TASK %ACTIVE_TASK,3,MONITORB This command selects the active task, 3, and ta”sk MONITOR for display. 3.DBG> SHOW TASK/PRIORITY=6@ This command selects all tasks with priority 6 for display.$ 4.DBG> SHOW TASK/STATE=(RUN,SUSP)> This command selects all tasks that are either running or suspended for display.% 5.DBG> SHOW TASK/STATE=SUSP/NOHOLDC This command selects all tasks that are both suspended and not on hold for display.< 6.DBG> SHOW TASK/STATE=(RUN,SUSP)/PRIO=7 %VISIBLE_TASK, 3C This command selects fo•r display those tasks among the visibleA task and %TASK 3 that are in either the RUNNING or SUSPENDED state and have priority 7. 3 TRACE* Displays information about tracepoints. Format SHOW TRACE 4 Qualifiers /PREDEFINED5 Displays information about predefined tracepoints. /USER7 Displays information about user-defined tracepoints. 4 Description@ The SHOW TRACE command displays information about tracepointsC tha –t are currently set, including any options such as WHEN or DOA clauses, /AFTER counts, and so on, and whether the tracepoints are deactivated.? By default, SHOW TRACE displays information about both user-B defined and predefined tracepoints (if any). This is equivalentC to entering the SHOW TRACE/USER/PREDEFINED command. User-defined= tracepoints are set with the SET TRACE command. PredefinedA tracepoints are set automatically when you start the debugger,< and they de —pend on the type of program you are debugging.D If you established a tracepoint using SET TRACE/AFTER:n, the SHOWB TRACE command displays the current value of the decimal integerA n, that is, the originally specified integer value minus 1 for? each time the tracepoint location was reached. (The debuggerB decrements n each time the tracepoint location is reached until> the value of n is 0, at which time the debugger takes trace action.)< On Alpha systems, the SHOW TRACE ˜command does not displayB individual instructions when the trace is on a particular class? of instruction (as with SET TRACE/CALL or SET TRACE/RETURN). Related commands:/ (ACTIVATE, DEACTIVATE, SET, CANCEL) TRACE 4 Examples 1.DBG> SHOW TRACE$ tracepoint at routine CALC\MULT tracepoint on calls:B RET RSB BSBB JSB BSBW CALLG CALLS DBG>? In this VAX example, the SHOW TRACE command identifies all? tracepo ™ints that are currently set. This example indicatesC user-defined tracepoints that are triggered whenever executionC reaches routine MULT in module CALC or one of the instructions0 RET, RSB, BSBB, JSB, BSBW, CALLG, or CALLS. 2.all> SHOW TRACE/PREDEFINED0 predefined tracepoint on program activation9 DO (SET DISP/DYN/REM/SIZE:64/PROC SRC_ AT H1 SOURCE. (EXAM/SOURCE .%SOURCE_SCOPE\%PC);7 SET DISP/DYN/REM/SIZE:64/PROC INST_ AT H1 INST' š (EXAM/INSTRUCTION .0\%PC))1 predefined tracepoint on program termination all>@ This command identifies the predefined tracepoints that are@ currently set. The example shows the predefined tracepointsB that are set automatically by the debugger for a multiprocessD program. The tracepoint on program activation triggers whenever> a new process comes under debugger control. The DO clause@ creates a process-specific source display named SRC_n and aA pro›cess-specific instruction display named INST_n whenever aB process activation tracepoint is triggered. The tracepoint onB program termination triggers whenever a process does an image exit. 3 TYPE@ Identifies the current type for program locations that do notC have a compiler-generated type or, if you specify /OVERRIDE, the current override type. Format SHOW TYPE 4 Qualifiers /OVERRIDE( Identifies the current override type. œ4 Description< The current type for program locations that do not have aB compiler-generated type is the type last established by the SETB TYPE command. If you did not enter a SET TYPE command, the type+ for those locations is longword integer.= The current override type for all program locations is theC override type last established by the SET TYPE/OVERRIDE command.A If you did not enter a SET TYPE/OVERRIDE command, the override type is "none". Related commands: CANCEL TYPE/OVERRIDE DEPOSIT EXAMINE (SET,SHOW,CANCEL) MODE (SET,SHOW,CANCEL) RADIX SET TYPE 4 Examples 1.DBG> SET TYPE QUADWORD DBG> SHOW TYPE type: quadword integer DBG>@ In this example, you set the type to quadword for locations> that do not have a compiler-generated type. The SHOW TYPEB command displays the current default type for those locationsA as quadword integer. This means that thže debugger interpretsB and displays entities at those locations as quadword integersD unless you specify otherwise (for example with a type qualifier on the EXAMINE command). 2.DBG> SHOW TYPE/OVERRIDE type/override: none DBG>C This command indicates that no override type has been defined. 3 WATCH* Displays information about watchpoints. Format SHOW WATCH 4 Description@ The SHOW WATCH command displays information about w ŸatchpointsC that are currently set, including any options such as WHEN or DOA clauses, /AFTER counts, and so on, and whether the watchpoints are deactivated.D If you established a watchpoint using SET WATCH/AFTER:n, the SHOWB WATCH command displays the current value of the decimal integerA n, that is, the originally specified integer value minus 1 for? each time the watchpoint location was reached. (The debuggerB decrements n each time the watchpoint location is reached  until> the value of n is 0, at which time the debugger takes watch action.) Related commands:, (ACTIVATE,CANCEL,DEACTIVATE,SET) WATCH 4 Example DBG> SHOW WATCH watchpoint of MAIN\X watchpoint of SUB2\TABLE+20 DBG>? This command displays two watchpoints: one at the variable> X (defined in module MAIN), and the other at the location> SUB2\TABLE+20 (20 bytes beyond the address denoted by the address expression TABLE). 3 WINDOW<¡ Identifies the name and screen position of predefined and$ user-defined screen-mode windows.& NOTEC This command is not available in the VSI DECwindows Motif for- OpenVMS user interface to the debugger. Format) SHOW WINDOW [window-name[, . . . ]] 4 Parameters windownameB Specifies the name of a screen window definition. If you do not? specify a name, or if you specify the asterisk (*) wildcardB chara¢cter by itself, all window definitions are listed. You canA use the wildcard within a window name. Do not specify a window+ definition name with the /ALL qualifier. 4 Qualifiers /ALL Lists all window definitions. 4 Description Related commands: (SHOW,CANCEL) DISPLAY (SET,SHOW) TERMINAL (SET,CANCEL) WINDOW SHOW SELECT 4 Example DBG> SHOW WINDOW LH*,RH* window LH1 at (1,11,1,40) window LH12 at (1,23,1,40) win£dow LH2 at (13,11,1,40) window RH1 at (1,11,42,39) window RH12 at (1,23,42,39) window RH2 at (13,11,42,39) DBG>> This command displays the name and screen position of all? screen window definitions whose names start with LH or RH. 2 SPAWN= Creates a subprocess, enabling you to execute DCL commandsC without terminating a debugging session or losing your debugging context.& NOTEC This command is not available in the¤ VSI DECwindows Motif for- OpenVMS user interface to the debugger. Format SPAWN [DCL-command] 3 Parameters DCL-commandB Specifies a DCL command which is then executed in a subprocess.D Control is returned to the debugging session when the DCL command terminates.? If you do not specify a DCL command, a subprocess is createdA and you can then enter DCL commands. Either logging out of theC spawned process or attaching to the parent proces¥s (with the DCL9 command ATTACH) returns you to your debugging session.@ If the DCL command contains a semicolon, you must enclose the> command in quotation marks ("). Otherwise the semicolon is< interpreted as a debugger command separator. To include a@ quotation mark in the string, enter two consecutive quotation marks (""). 3 Qualifiers /INPUT /INPUT=file-specB Specifies an input DCL command procedure containing one or more= DCL commands to b¦e executed by the spawned subprocess. TheA default file type is .COM. If you specify a DCL command stringD with the SPAWN command and an input file with /INPUT, the command> string is processed before the input file. After processing? of the input file is complete, the subprocess is terminated.> Do not use the asterisk (*) wildcard character in the file specification. /OUTPUT /OUTPUT=file-spec> Writes the output from the SPAWN operation to the specified?§ file. The default file type is .LOG. Do not use the asterisk5 (*) wildcard character in the file specification. /WAIT /WAIT (default) /NOWAITA Controls whether the debugging session (the parent process) isA suspended while the subprocess is running. The /WAIT qualifier@ (default) suspends the debugging session until the subprocessB is terminated. You cannot enter debugger commands until control! returns to the parent process.A The /NOWAIT qua ¨lifier executes the subprocess in parallel withC the debugging session. You can enter debugger commands while the@ subprocess is running. If you use /NOWAIT, you should specify@ a DCL command with the SPAWN command; the DCL command is thenC executed in the subprocess. A message indicates when the spawned subprocess completes.@ The kept debugger (that is, the debugger invoked with the DCLB command DEBUG/KEEP) shares I/O channels with the parent processB when it is run by a© SPAWN/NOWAIT command. Therefore, in the VSIB DECwindows Motif for OpenVMS user interface, you must press theB Return key twice on the DECterm from which the debugger was run@ after the debugger version number has appeared in the command view.A Optionally, you can execute the kept debugger in the following manner: $ DEFINE DBG$INPUT NL:! $ SPAWN/NOWAIT RUN DEBUG/KEEP 3 DescriptionA The SPAWN command acts exactly like the DCL command SPAWN. YouA can ediªt files, compile programs, read mail, and so on withoutA ending your debugging session or losing your current debugging context.D In addition, you can spawn a DCL command SPAWN. DCL processes theD second SPAWN command, including any qualifier specified with that command. Related command: ATTACH 3 Examples 1.DBG> SPAWN $D This example shows that the SPAWN command, without a parameter,= creates a subprocess at DCL level. You can no «w enter DCL8 commands. Log out to return to the debugger prompt.8 2.DBG> SPAWN/NOWAIT/INPUT=READ_NOTES/OUTPUT=0428NOTESC This command creates a subprocess that is executed in parallelA with the debugging session. This subprocess executes the DCLB command procedure READ_NOTES.COM. The output from the spawned4 operation is written to the file 0428NOTES.LOG.1 3.DBG> SPAWN/NOWAIT SPAWN/OUT=MYCOM.LOG @MYCOMC This command creates a subprocess that is executed ¬in parallel@ with the debugging session. This subprocess creates anotherC subprocess to execute the DCL command procedure MYCOM.COM. TheA output from that operation is written to the file MYCOM.LOG. 2 START 3 HEAP_ANALYZER>CLIENTS> STOP all> show process Number Name State Current PC 1<DBGK$$2727282C break SERVER main\main\%LINE 18834 2=USER1_2 interrupted 0FFFFFFFF800F7A20 * 3 USER1_3 interrupted<0FFFFFFFF800F7A20 all> This command sequence first shows a­ll?processes, then stops the processes in process set clients. The7last SHOW PROCESS command shows the new process states. 2 SYMBOLIZE= Converts a memory address to a symbolic representation, if possible. Format, SYMBOLIZE address-expression[, . . . ] 3 Parameters address-expressionC Specifies an address expression to be symbolized. Do not use the$ asterisk (*) wildcard character. 3 Description> If the address is a static address, ® it is symbolized as the@ nearest preceding symbol name, plus an offset. If the addressD is also a code address and a line number can be found that coversA the address, the line number is included in the symbolization.B If the address is a register address, the debugger displays allB symbols in all set modules that are bound to that register. The@ full path name of each such symbol is displayed. The register6 name itself ("%R5", for example) is also displayed.A If the addr ¯ess is a call stack location in the call frame of aA routine in a set module, the debugger searches for all symbolsD in that routine whose addresses are relative to the frame pointerD (FP) or the stack pointer (SP). The closest preceding symbol nameC plus an offset is displayed as the symbolization of the address.B A symbol whose address specification is too complex is ignored.$ On Alpha processors, the commands' SYMBOLIZE procedure-code-address and? SYMBOLIZE procedure-d°escriptor-address both display the path@ name of the routine, entry point, or Ada package specified by these addresses.= If the debugger cannot symbolize the address, a message is displayed. Related commands: EVALUATE/ADDRESS SET MODE [NO]LINE SET MODE [NO]SYMBOLIC (SET,SHOW) MODULE SHOW SYMBOL 3 Examples 1.DBG> SYMBOLIZE %R5 address PROG\%R5: PROG\X DBG>D This example shows that the local± variable X in routine PROG is located in register R5. 2.DBG> SYMBOLIZE %HEX 27C9E3 address 0027C9E3: MOD5\X DBG>C This command directs the debugger to treat the integer literal@ 27C9E3 as a hexadecimal value and convert that address to aB symbolic representation, if possible. The address converts to! the symbol X in module MOD5. 2 TYPE! Displays lines of source code. Format3 TYPE [[module-name\]line-number[:line-²number]@ [,[module-name\]line-number[:line-number][, . . . ]]] 3 Parameters module-name< Specifies the module that contains the source lines to be> displayed. If you specify a module name along with the lineB numbers, use standard pathname notation: insert a backslash (\)0 between the module name and the line numbers.= If you do not specify a module name, the debugger uses theA current scope (as established by a previous SET SCOPE command,D or ³the PC scope if you did not enter a SET SCOPE command) to findD source lines for display. If you specify a scope search list with@ the SET SCOPE command, the debugger searches for source lines< only in the module associated with the first named scope. line-number? Specifies a compiler-generated line number (a number used to4 label a source language statement or statements).A If you specify a single line number, the debugger displays the1 source code corresponding to ´that line number.@ If you specify a list of line numbers, separating each with a@ comma, the debugger displays the source code corresponding to each of the line numbers.C If you specify a range of line numbers, separating the beginning> and ending line numbers in the range with a colon (:), the@ debugger displays the source code corresponding to that range of line numbers.A You can display all the source lines of a module by specifyingA a range of line numbers s µtarting from 1 and ending at a numberB equal to or greater than the largest line number in the module.A After displaying a single line of source code, you can displayB the next line of that module by entering a TYPE command withoutA a line number (that is, by entering TYPE and then pressing theA Return key). You can then display the next line and successiveD lines by repeating this sequence, in effect, reading through your% source program one line at a time. 3 Descr ¶iption: The TYPE command displays the lines of source code thatB correspond to the specified line numbers. The line numbers usedD by the debugger to identify lines of source code are generated byC the compiler. They appear in a compiler-generated listing and in a screen-mode source display.A If you specify a module name with the TYPE command, the module@ must be set. Use the SHOW MODULE command to determine whetherB a particular module is set. Then use the SET MODULE comma·nd, if necessary.B In screen mode, the output of a TYPE command is directed at the> current source display, not at an output or DO display. The? source display shows the lines specified and any surrounding( lines that fit in the display window. Related commands: EXAMINE/SOURCE( SET (BREAK,TRACE,WATCH)/[NO]SOURCE SET MODE [NO]SCREEN (SET,SHOW,CANCEL) SCOPE SET STEP [NO]SOURCE STEP/[NO]SOURCE 3 Examples 1.DBG> TYPE 1¸60 module COBOLTEST 160: START-IT-PARA. DBG> TYPE module COBOLTEST% 161: MOVE SC1 TO ES0. DBG>? In this example, the first TYPE command displays line 160,< using the current scope to locate the module containing? that line number. The second TYPE command, entered without= specifying a line number, displays the next line in that module. 2.DBG> TYPE 160:163 module COBOLTEST 160: START-IT-PARA.% ¹ 161: MOVE SC1 TO ES0.! 162: DISPLAY ES0.% 163: MOVE SC1 TO ES1. DBG>D This command displays lines 160 to 163, using the current scope to locate the module. 3.DBG> TYPE SCREEN_IO\7,22:24> This command displays line 7 and lines 22 to 24 in module SCREEN_IO. 2 WAIT> Causes the debugger to wait until the target processes have1 stopped before prompting for the next command. Format WAITº 3 Description@ When debugging multiprocess programs, the WAIT command causesB the debugger to complete executing all process specified by theD previous command before displaying a prompt to accept and execute another command. Related commands: STOP SET MODE [NO]INTERRUPT SET MODE [NO]WAIT 3 Example all> 2,3> GO;WAIT processes 2,3# break at CLIENT\main\%LINE 18814: 18814: status = sys$qiow (EFN$C_ENF, mbxchan,> » IO$_READVBLKIO$M_WRITERCHECK, myiosb) process 1# break at SERVER\main\%LINE 188346 18834: if ((myiosb.iosb$w_status === SS$_NOREADER) && (pos_status != -1)) all>A This command sequence executes the target processes (in this@ case, 2 and 3), and the debugger waits until both processes= reach breakpoints before prompting for the next command. 2 WHILE@ Executes a sequence of commands while the language ex¼pression= (Boolean expression) you have specified evaluates as true. Format5 WHILE Boolean-expression DO (command[; . . . ]) 3 Parameters Boolean-expressionD Specifies a language expression that evaluates as a Boolean value1 (true or false) in the currently set language. command= Specifies a debugger command. If you specify more than one? command, separate the commands with semicolons (;). At eachB execution, the debugger checks the sy½ntax of any expressions in( the commands and then evaluates them. 3 DescriptionB The WHILE command evaluates a Boolean expression in the currentD language. If the value is true, the command list in the DO clauseC is executed. The command then repeats the sequence, reevaluatingB the Boolean expression and executing the command list until the$ expression is evaluated as false.D If the Boolean expression is false, the WHILE command terminates. Related commands: EXITLOOP FOR REPEAT 3 Example' DBG> WHILE (X .EQ. 0) DO (STEP/SILENT)C This command directs the debugger to keep stepping through the: program until X no longer equals 0 (Fortran example).ww