OpenVMS Debugger Manual

By default, the current key state is the DEFAULT state. You can change the current state by using the SET KEY/STATE command or by pressing a key that causes a state change (that is, a key that was defined with DEFINE/KEY/LOCK_STATE or /SET_STATE).

Related commands:

DEFINE/KEY
DELETE/KEY
SET KEY

Examples

DBG> SHOW KEY/ALL

This command displays all the key definitions for the current state.

DBG> SHOW KEY/STATE=BLUE KP8
GOLD keypad definitions: 
  KP8 = "Scroll/Top" (noecho,terminate,nolock)
DBG>

This command displays the definition for keypad key 8 in the BLUE state.

DBG> SHOW KEY/BRIEF KP8
DEFAULT keypad definitions: 
  KP8 = "Scroll/Up"
DBG>

This command displays the definition for keypad key 8 in the current state.

DBG> SHOW KEY/DIRECTORY
MOVE_GOLD 
MOVE_BLUE 
MOVE 
GOLD 
EXPAND_GOLD 
EXPAND_BLUE 
EXPAND 
DEFAULT 
CONTRACT_GOLD 
CONTRACT_BLUE 
CONTRACT 
BLUE
DBG>

This command displays the names of the states for which keys have been defined.

SHOW LANGUAGE

Identifies the current language.

Format

SHOW LANGUAGE

DESCRIPTION

The current language is the language last established with the SET LANGUAGE command. If you did not enter a SET LANGUAGE command, the current language is, by default, the language of the module containing the main program.
Related command:

SET LANGUAGE

Example

DBG> SHOW LANGUAGE
language: BASIC
DBG>

This command displays the name of the current language as BASIC.

SHOW LOG

Indicates whether the debugger is writing to a log file and identifies the current log file.

Format

SHOW LOG

DESCRIPTION

The current log file is the log file last established by a SET LOG command. By default, if you did not enter a SET LOG command, the current log file is the file SYS$DISK:[]DEBUG.LOG.
Related commands:

SET LOG
SET OUTPUT [NO]LOG
SET OUTPUT [NO]SCREEN_LOG

Examples

DBG> SHOW LOG
not logging to DEBUG.LOG
DBG>

This command displays the name of the current log file as DEBUG.LOG (the default log file) and reports that the debugger is not writing to it.

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 debugger to log debugger input and output into that file. The SHOW LOG command confirms that the debugger is writing to the log file PROG4.COM in your current default directory.

SHOW MARGINS

Identifies the current source-line margin settings for displaying source code.

Note
This command is not available in the DECwindows Motif interface to the debugger.

Format

SHOW MARGINS

DESCRIPTION

The current margin settings are the margin settings last established with the SET MARGINS command. By default, if you 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

Examples

DBG> SHOW MARGINS
left margin: 1 , right margin: 255
DBG>

This command displays the default margin settings of 1 and 255.

DBG> SET MARGINS 50
DBG> SHOW MARGINS
left margin: 1 , right margin: 50
DBG>

This command displays the default left margin setting of 1 and the modified right margin setting of 50.

DBG> SET MARGINS 10:60
DBG> SHOW MARGINS
left margin: 10 , right margin: 60
DBG>

This command displays both margin settings modified to 10 and 60.

SHOW MODE

Identifies the current debugger modes (screen or no screen, keypad or nokeypad, and so on) and the current radix.

Format

SHOW MODE

DESCRIPTION

The current debugger modes are the modes last established with the SET MODE command. By default, if you did not enter a SET MODE 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

Example

DBG> SHOW MODE
modes: symbolic, line, d_float, screen, scroll, keypad, 
       dynamic, interrupt, no separate window 
input radix :decimal 
output radix:decimal
DBG>

The SHOW MODE command displays the current modes and current input and output radix.

SHOW MODULE

Displays information about the modules in the current image.

Format

SHOW MODULE [module-name]

PARAMETERS

module-name
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 can use a wildcard within a module name. Shareable image modules are selected only if you specify /SHARE.

QUALIFIERS

/RELATED

/NORELATED (default)
(Applies to Ada programs.) Controls whether the debugger includes, in the SHOW MODULE display, any module that is 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 relationship. By default (/NORELATED), no related modules are selected for display (only the modules specified are selected).
/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.
The debugger creates dummy modules for each shareable image in your program. The names of these shareable "image modules" have the prefix SHARE$. The SHOW MODULE/SHARE command identifies these 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, you cannot reference other (local or global) symbols in that image from the current image. This feature overlaps the effect of the newer SET IMAGE and SHOW IMAGE commands.

DESCRIPTION

The SHOW MODULE command displays the following information about one or more modules selected for display:

Name of the module.
Programming language in which the module is coded, unless all modules are coded in the same language.
Whether the module has been set with the SET MODULE command. That is, whether the symbol records of the module have been loaded into the debugger's run-time symbol table (RST).
Space (in bytes) required in the RST for symbol records in that module.
Total number of modules selected in the display.
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) or the image established as the current image by a previous SET IMAGE command.

For information specific to Ada programs, type Help Language_Support Ada.
Related commands:

(SET,SHOW,CANCEL) IMAGE
SET MODE [NO]DYNAMIC
(SET,CANCEL) MODULE
(SET,SHOW,CANCEL) SCOPE
SHOW SYMBOL

Examples

DBG> SHOW MODULE
module name           symbols   size 
 
TEST                  yes       432 
SCREEN_IO             no        280 
 
total PASCAL modules: 2.    bytes allocated: 2740.
DBG>

In this example, the SHOW MODULE command, without a parameter, displays information about all of the modules in the current image, which is the main image by default. This example shows the display format when all modules have the same source language. The symbols column shows that module TEST has been set, but module SCREEN_IO has not.

DBG> SHOW MODULE FOO,MAIN,SUB*
module name           symbols   language   size 
 
FOO                   yes       MACRO      432 
MAIN                  no        FORTRAN    280 
SUB1                  no        FORTRAN    164 
SUB2                  no        FORTRAN    204 
 
total modules: 4.     bytes allocated: 60720.
DBG>

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 the modules do not have the same source language.

DBG> SHOW MODULE/SHARE
module name           symbols   language   size 
 
FOO                   yes       MACRO       432 
MAIN                  no        FORTRAN     280
    ...
SHARE$DEBUG           no        Image         0 
SHARE$LIBRTL          no        Image         0 
SHARE$MTHRTL          no        Image         0 
SHARE$SHARE1          no        Image         0 
SHARE$SHARE2          no        Image         0 
 
total modules: 17.     bytes allocated: 162280.
DBG> SET MODULE SHARE$SHARE2
DBG> SHOW SYMBOL * IN SHARE$SHARE2

In this example, the SHOW MODULE/SHARE command identifies all of the modules in the current image and all of the shareable images (the names of the shareable images are prefixed with SHARE$. The SET MODULE SHARE$SHARE2 command sets the shareable image module SHARE$SHARE2. The SHOW SYMBOL command identifies any universal symbols defined in the shareable image SHARE2.

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. This command applies especially to a multiprocess debugging configuration (when DBG$PROCESS has the value MULTIPROCESS).

Format

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

PARAMETERS

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

[%PROCESS_NAME] proc-name The process name, if that name contains no space or lowercase characters. The process name can include the asterisk (*) wildcard character.

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

%PROCESS_PID proc-id The process identifier (PID, a hexadecimal number).

%PROCESS_NUMBER proc-number
(or %PROC proc-number) The number assigned to a process when it comes under debugger control. Process numbers appear in a SHOW PROCESS display.

proc-group-name A symbol defined with the DEFINE/PROCESS_GROUP command to represent a group of processes. Do not specify a recursive symbol definition.

%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.

%VISIBLE_PROCESS The process whose call 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.
/HOLD

/NOHOLD (default)
Selects either processes that are on hold, or processes that are not on hold for display.
If you do not specify a process, /HOLD selects all processes that are on hold. If you specify a process list, /HOLD selects the processes in the list that are on hold.
If you do not specify a process, /NOHOLD selects all processes that are not on hold. If you specify a process list, /NOHOLD selects the processes in the list that are not on hold.
If you specify both /HOLD and /NOHOLD on the same command line, the effect is to select processes that are on hold and processes that are not on hold for display (the qualifier specified last on the command line does not override the other).
/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.
Whether the process has been put on hold with a SET PROCESS/HOLD command.
The current debugging state for that process. (See Table CD-2.)
The location (symbolized, if possible) at which execution of the image is suspended in that process.

Table CD-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_GROUP
EXIT
QUIT
SET PROCESS

**Table CD-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

DBG_2> SHOW PROCESS
 Number  Name       Hold  State      Current PC 
*    2 _WTA3:       HOLD  break      SCREEN\%LINE 47
DBG_2>

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.

DBG_2> SHOW PROCESS/FULL %PREVIOUS_PROCESS
Process number: 1                  Process name: JONES_1: 
Hold: NO                           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
DBG_2>

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).

DBG_2> SHOW PROCESS %PROCESS_NAME TEST_3
 Number  Name    Hold  State       Current PC 
     7 TEST_3          watch of TEST_3\ROUT4\COUNT 
                                       TEST_3\%LINE 54
DBG_2>

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

DBG_2> SHOW PROCESS/DYNAMIC
Dynamic process setting is enabled
DBG_2>

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. On VAX processors, the exceptions are BLISS and MACRO--32, which have a default radix of hexadecimal. On Alpha processors, the exceptions are BLISS, MACRO--32, and MACRO--64, 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

DBG> SHOW RADIX
input radix: decimal 
output radix: decimal
DBG>

This command identifies the input radix and output radix as decimal.

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 path-name 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 path-name 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

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.

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 path-name 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.

Previous | Next | Contents | [Home] | [Comments] | [Ordering info] | [Help]
  4538P047.HTM
  OSSG Documentation
  22-NOV-1996 13:02:44.88
Copyright © Digital Equipment Corporation 1996. All Rights Reserved.

Legal

[%PROCESS_NAME] proc-name	The process name, if that name contains no space or lowercase characters. The process name can include the asterisk (*) wildcard character.
[%PROCESS_NAME] " proc-name"	The process name, if that name contains space or lowercase characters. You can also use apostrophes (') instead of quotation marks (").
%PROCESS_PID proc-id	The process identifier (PID, a hexadecimal number).
%PROCESS_NUMBER proc-number (or %PROC proc-number)	The number assigned to a process when it comes under debugger control. Process numbers appear in a SHOW PROCESS display.
proc-group-name	A symbol defined with the DEFINE/PROCESS_GROUP command to represent a group of processes. Do not specify a recursive symbol definition.
%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.
%VISIBLE_PROCESS	The process whose call stack, register set, and images are the current context for looking up symbols, register values, routine calls, breakpoints, and so on.