HP OpenVMS Debugger Manual

Contents

Index

SHOW OUTPUT

Identifies the current output options.

Format

SHOW OUTPUT

Description

The current output options are the options last established with 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

Example


DBG> SHOW OUTPUT noverify, terminal, screen_log, logging to USER$:[JONES.WORK]DEBUG.LOG;9 DBG>

This command shows the following current output options:

Debugger commands read from debugger command procedures are not echoed on the terminal.
Debugger output is being displayed on the terminal.
The debugging session is being logged to the log file USER$:[JONES.WORK]DEBUG.LOG;9.
The screen contents are logged as they are updated in screen mode.

SHOW PROCESS

Displays information about processes that are currently under debugger control.

Format

SHOW PROCESS [process-spec[,...]]

Parameters

process-spec
Specifies a process currently under debugger control. Use any of the following forms:

[%PROCESS_NAME] process-name The process name, if that name does not contain spaces or lowercase characters. The process name can include the asterisk (*) wildcard character.

[%PROCESS_NAME] " process-name " The process name, if that name contains spaces or lowercase characters. You can also use apostrophes (') instead of quotation marks (").

%PROCESS_PID process_id The process identifier (PID, a hexadecimal number).

[%PROCESS_NUMBER] process-number
(or %PROC process-number) The number assigned to a process when it comes under debugger control. A new number is assigned sequentially, starting with 1, to each process. If a process is terminated with the EXIT or QUIT command, the number can be assigned again during the debugging session. Process numbers appear in a SHOW PROCESS display. Processes are ordered in a circular list so they can be indexed with the built-in symbols %PREVIOUS_PROCESS and %NEXT_PROCESS.

process-set-name A symbol defined with the DEFINE/PROCESS_SET command to represent 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.

%VISIBLE_PROCESS The process whose stack, register set, and images are the current context for looking up symbols, register values, routine calls, breakpoints, and so on.

You can also use the asterisk (*) wildcard character or the /ALL qualifier to specify all processes. Do not specify a process with /ALL or /DYNAMIC. If you do not specify a process or /ALL with /BRIEF, /FULL, or /[NO]HOLD, the visible process is selected.

Qualifiers

/ALL
Selects all processes known to the debugger for display.
/BRIEF
(Default) Displays only one line of information for each process selected for display.
/DYNAMIC
Shows whether dynamic process setting is enabled or disabled. 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.
/VISIBLE
(Default). Selects the visible process for display.

Description

The SHOW PROCESS command displays information about specified processes and any images running in those processes.
The SHOW PROCESS/FULL command also displays information about the availability and use of the vector processor. This information is useful if you are debugging a program that uses vector instructions.
A process can first appear in a SHOW PROCESS display as soon as it comes under debugger control. A process can no longer appear in a SHOW PROCESS display if it is terminated through an EXIT or QUIT command.
By default (/BRIEF), one line of information is displayed for each process, including the following:

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 is terminated by an EXIT or QUIT command, its process number is not reused during that debugging session. The visible process is marked with an asterisk (*) in the leftmost column.
The process name.
The current debugging state for that process. (See Table DEBUG-2.)
The location (symbolized, if possible) at which execution of the image is suspended in that process.

Table DEBUG-2 Debugging States
State Description

Activated The image and its process have just been brought under debugger control.

Break
Break on branch
Break on call
Break on instruction
Break on lines
Break on modify of
Break on return
Exception break
Exception break preceding A breakpoint was triggered.

Interrupted Execution was interrupted in that process, either because execution was suspended in another process, or because the user interrupted program execution with the abort-key sequence (by default, Ctrl/C).

Step
Step on return A STEP command has completed.

Terminated The image indicated has terminated execution but the process is still under debugger control. Therefore, you can obtain information about the image and its process. You can use the EXIT or QUIT command to terminate the process.

Trace
Trace on branch
Trace on call
Trace on instruction
Trace on lines
Trace on modify of
Trace on return
Exception trace
Exception trace preceding A tracepoint was triggered.

Unhandled exception An unhandled exception was encountered.

Watch of A watchpoint was triggered.

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

**Table DEBUG-2 Debugging States**
State	Description
Activated	The image and its process have just been brought under debugger control.
Break Break on branch Break on call Break on instruction Break on lines Break on modify of Break on return Exception break Exception break preceding	A breakpoint was triggered.
Interrupted	Execution was interrupted in that process, either because execution was suspended in another process, or because the user interrupted program execution with the abort-key sequence (by default, Ctrl/C).
Step Step on return	A STEP command has completed.
Terminated	The image indicated has terminated execution but the process is still under debugger control. Therefore, you can obtain information about the image and its process. You can use the EXIT or QUIT command to terminate the process.
Trace Trace on branch Trace on call Trace on instruction Trace on lines Trace on modify of Trace on return Exception trace Exception trace preceding	A tracepoint was triggered.
Unhandled exception	An unhandled exception was encountered.
Watch of	A watchpoint was triggered.

Examples

#1
all> SHOW PROCESS Number Name State Current PC * 2 _WTA3: break SCREEN\%LINE 47 all>

By default, the SHOW PROCESS command displays one line of information about the visible process (which is identified with an asterisk (*) in the leftmost column). The process has the process name _WTA3:. It is the second process brought under debugger control (process number 2). It is on hold, and the image's execution is suspended at a breakpoint at line 47 of module SCREEN.

#2
all> SHOW PROCESS/FULL %PREVIOUS_PROCESS Process number: 1 Process name: JONES_1: Visible process: NO Current PC: TEST_VALVES\%LINE 153 State: interrupted PID: 20400885 Owner PID: 00000000 Current/Base priority: 5/4 Terminal: VTA79: Image name: USER$:[JONES.PROG1]TEST_VALVES.EXE;31 Elapsed CPU time: 0 00:03:17.17 CPU Limit: Infinite Buffered I/O Count: 14894 Remaining buffered I/O quota: 80 Direct I/O Count: 6956 Remaining direct I/O quota: 40 Open file count: 7 Remaining open file quota: 43 Enqueue count: 200 Remaining enqueue quota: 198 Vector capable: Yes Vector consumer: Yes Vector CPU time: 00:00:00.00 Fast Vector context switches: 0 Slow Vector context switches: 0 Current working set size: 1102 Working set size quota: 1304 Current working set extent: 12288 Maximum working set extent: 12288 Peak working set size: 4955 Maximum authorized working set: 1304 Current virtual size: 255 Peak virtual size: 16182 Page faults: 41358 Active ASTs: Remaining AST Quota: 27 Event flags: FF800000 60000003 Event flag wait mask: 7FFFFFFF all>

all> SHOW PROCESS/FULL %PREVIOUS_PROCESS
Process number: 1                  Process name: JONES_1: 
                                   Visible process: NO 
Current PC: TEST_VALVES\%LINE 153 
State: interrupted 
PID: 20400885                      Owner PID: 00000000 
Current/Base priority:  5/4        Terminal: VTA79: 
 
Image name: USER$:[JONES.PROG1]TEST_VALVES.EXE;31 
 
Elapsed CPU time:   0 00:03:17.17  CPU Limit:         Infinite 
Buffered I/O Count:         14894  Remaining buffered I/O quota:       80 
Direct I/O Count:            6956  Remaining direct I/O quota:         40 
Open file count:                7  Remaining open file quota:          43 
Enqueue count:                200  Remaining enqueue quota:           198 
Vector capable:               Yes 
Vector consumer:              Yes  Vector CPU time:           00:00:00.00 
Fast Vector context switches:   0  Slow Vector context switches:        0 
Current working set size:    1102  Working set size quota:           1304 
Current working set extent: 12288  Maximum working set extent:      12288 
Peak working set size:       4955  Maximum authorized working set:   1304 
Current virtual size:         255  Peak virtual size:               16182 
Page faults:                41358 
 
Active ASTs:                       Remaining AST Quota:                27 
Event flags:    FF800000 60000003  Event flag wait mask:         7FFFFFFF
all>

The SHOW PROCESS/FULL %PREVIOUS_PROCESS command displays the maximum level of information about the previous process in the circular list of processes (process number 1, in this case).

#3
all> SHOW PROCESS TEST_3 Number Name State Current PC 7 TEST_3 watch of TEST_3\ROUT4\COUNT TEST_3\%LINE 54 all>

This SHOW PROCESS command displays one line of information about process TEST_3. The image is suspended at a watchpoint of variable COUNT.

#4
all> SHOW PROCESS/DYNAMIC Dynamic process setting is enabled all>

This command indicates that dynamic process setting is enabled.

SHOW RADIX

Identifies the current radix for the entry and display of integer data or, if you specify /OVERRIDE, the current override radix.

Format

SHOW RADIX

Qualifiers

/OVERRIDE
Identifies the current override radix.

Description

The debugger can interpret and display integer data in any one of four radixes: binary, decimal, hexadecimal, and octal. The current radix for the entry and display of integer data is the radix last established with the SET RADIX command.
If you did not enter a SET RADIX command, the default radix for 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/OVERRIDE command. If you did not enter a SET RADIX/OVERRIDE command, the override radix is "none".
Related commands:
DEPOSIT
EVALUATE
EXAMINE
(SET,CANCEL) RADIX

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/OVERRIDE command sets the override radix to hexadecimal and the SHOW RADIX/OVERRIDE command indicates the override radix. This means that commands such as EXAMINE display all data as hexadecimal integer data.

SHOW SCOPE

Identifies the current scope search list for symbol lookup.

Format

SHOW SCOPE

Description

The current scope search list designates one or more program locations (specified by path names or other special characters) to be used in the interpretation of symbols that are specified without pathname prefixes in debugger commands.
The current scope search list is the scope search list last established with the SET SCOPE command. By default, if you did 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 is currently executing (scope 0); if no X is visible there, the debugger looks in the caller of that routine (scope 1), and so on down the 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.
If you used a decimal integer in the SET SCOPE command to represent a routine in the call stack, the SHOW SCOPE command displays the name of the routine represented by the integer, if possible.
Related commands:
(SET,CANCEL) SCOPE

Examples

#1
DBG> CANCEL SCOPE DBG> SHOW SCOPE scope: * 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 DBG> SHOW SCOPE scope: 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>

DBG> CANCEL SCOPE
DBG> SHOW SCOPE
scope: 
 *  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
DBG> SHOW SCOPE
scope: 
    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 search list, which is displayed by the (first) SHOW SCOPE command. In this example, execution is suspended at routine REMOVEQUEEN, after several recursive calls to routine TRYCOL. The asterisk (*) 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 scope search list to scope 2. Scope 2 is the scope of the caller of the routine in which execution is suspended. The asterisk in the output of the (second) SHOW SCOPE command indicates that the scope 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 to the following scope search list. First the debugger looks in the PC scope (denoted by 0, which is in module TEST). If the debugger cannot find a specified symbol in the PC scope, it then looks in routine R2 of module STACKS; if necessary, it then looks in module SCREEN_IO, and then finally in the global symbol table (denoted by the global scope (\)). The SHOW SCOPE command identifies the current scope search list for symbol lookup. No asterisk is shown in the SHOW SCOPE display unless the default scope search list is in effect or you have entered a SET SCOPE/CURRENT command.

SHOW SEARCH

Identifies the default qualifiers (/ALL or /NEXT, /IDENTIFIER or /STRING) currently in effect for the SEARCH command.

Format

SHOW SEARCH

Description

The default qualifiers for the SEARCH command are the default qualifiers last established with the SET SEARCH command. If you did not enter a SET SEARCH command, the default qualifiers are /NEXT and /STRING.
Related commands:
SEARCH
(SET,SHOW) LANGUAGE
SET SEARCH

Example


DBG> SHOW SEARCH 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>

DBG> SHOW SEARCH
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 the default settings for the SET SEARCH command. By default, the debugger searches for and displays the next occurrence of the string.
The second SHOW SEARCH command indicates that the debugger 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 displays the strings only if they are not bounded on either side by a character that can be part of an identifier in the current language.

SHOW SELECT

Identifies the displays currently selected for each of the display attributes: error, input, instruction, output, program, prompt, scroll, and source.

Note
This command is not available in the HP DECwindows Motif for OpenVMS user interface to the debugger.

Format

SHOW SELECT

Description

The display attributes have the following properties:

A display that has the error attribute displays debugger diagnostic messages.
A display that has the input attribute echoes your debugger input.
A display that has the instruction attribute displays the decoded instruction stream of the routine being debugged. The display is updated when you enter an EXAMINE/INSTRUCTION command.
A display that has the output attribute displays any debugger output that is not directed to another display.
A display that has the program attribute displays program input and output. Currently only the PROMPT display can have the program attribute.
A display that has the prompt attribute is where the debugger prompts for input. Currently, only the PROMPT display can have the PROMPT attribute.
A display that has the scroll attribute is the default display for the SCROLL, MOVE, and EXPAND commands.
A display that has the source attribute displays the source code of the module being debugged, if available. The display is updated when you enter a TYPE or EXAMINE/SOURCE command.

Related commands:
SELECT
SHOW DISPLAY

Example


DBG> SHOW SELECT display selections: scroll = SRC input = none output = OUT error = PROMPT source = SRC instruction = none program = PROMPT prompt = PROMPT DBG>

The SHOW SELECT command identifies the displays currently selected for each of the display attributes. These selections are the defaults for languages.

SHOW SOURCE

Identifies the source directory search lists and search methods currently in effect.

Format

SHOW SOURCE

Qualifiers

/DISPLAY
Identifies the search list used when the debugger displays source code.
/EDIT
Identifies the search list to be used during execution of the debugger's EDIT command.

Description

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 all modules not explicitly mentioned in a SET SOURCE/MODULE=module-name command. When you have used those commands, SHOW SOURCE identifies the source directory search list associated with each search category.
If a source directory search list has not been established by using the SET SOURCE or SET SOURCE/MODULE=module-name command, the SHOW SOURCE command indicates that no directory search list is currently in effect. In this case, the debugger expects each source file to be in the same directory that it was in at compile time (the debugger also checks that the version number and the creation date and time of a source file match the information in the debugger's symbol table).
The /EDIT qualifier is needed when the files used for the display of source code are different from the files to be edited by using the EDIT command. This is the case with Ada programs. For Ada programs, the SHOW SOURCE command identifies the search list of files used for source display (the copied source files in Ada program libraries); the SHOW SOURCE/EDIT command identifies the search list for the source files you edit when using the EDIT command.
For information specific to Ada programs, type Help Language_Support Ada.
Related commands:
(SET,CANCEL) SOURCE

Examples

#1
DBG> SHOW SOURCE no directory search list in effect, match the latest source file version DBG> SET SOURCE [PROJA],[PROJB],DISK:[PETER.PROJC] DBG> SHOW SOURCE source directory search list for all modules, match the latest source file version: [PROJA] [PROJB] DISK:[PETER.PROJC] DBG>

DBG> SHOW SOURCE
no directory search list in effect, 
    match the latest source file version
DBG> SET SOURCE [PROJA],[PROJB],DISK:[PETER.PROJC]
DBG> SHOW SOURCE
source directory search list for all modules, 
    match the latest source file version: 
        [PROJA] 
        [PROJB] 
        DISK:[PETER.PROJC]
DBG>

In this example, the SET SOURCE command directs the debugger to 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] source directory search list for all other modules, match the latest source file version: [PROJA] [PROJB] DISK:[PETER.PROJC] DBG>

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] 
source directory search list for all other modules, 
match the latest source file version: 
        [PROJA] 
        [PROJB] 
        DISK:[PETER.PROJC]
DBG>

In this example, the SET SOURCE command directs the debugger to search the current default directory ([]) and directory DISK$2:[PROJD] for source files to use with the module CTEST. The /EXACT qualifier specifies that the search will locate the exact version of the CTEST source files found in the debug symbol table.

Contents

Index

[%PROCESS_NAME] process-name	The process name, if that name does not contain spaces or lowercase characters. The process name can include the asterisk (*) wildcard character.
[%PROCESS_NAME] " process-name "	The process name, if that name contains spaces or lowercase characters. You can also use apostrophes (') instead of quotation marks (").
%PROCESS_PID process_id	The process identifier (PID, a hexadecimal number).
[%PROCESS_NUMBER] process-number (or %PROC process-number)	The number assigned to a process when it comes under debugger control. A new number is assigned sequentially, starting with 1, to each process. If a process is terminated with the EXIT or QUIT command, the number can be assigned again during the debugging session. Process numbers appear in a SHOW PROCESS display. Processes are ordered in a circular list so they can be indexed with the built-in symbols %PREVIOUS_PROCESS and %NEXT_PROCESS.
process-set-name	A symbol defined with the DEFINE/PROCESS_SET command to represent 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.
%VISIBLE_PROCESS	The process whose stack, register set, and images are the current context for looking up symbols, register values, routine calls, breakpoints, and so on.