 |
OpenVMS Debugger Manual
SHOW DEFINE
Identifies the default (/ADDRESS, /COMMAND, /PROCESS_GROUP, or /VALUE)
currently in effect for the DEFINE command.
Format
SHOW DEFINE
Description
The default qualifier for the DEFINE command is the one last
established with the SET DEFINE command. If you did not enter a 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
Example
|
DBG> SHOW DEFINE
Current setting is: DEFINE/ADDRESS
DBG>
|
This command indicates that the DEFINE command is set for definition by
address.
SHOW DISPLAY
Identifies one or more existing screen displays.
Note
This command is not available in the Compaq DECwindows Motif for OpenVMS user interface to
the debugger.
|
Format
SHOW DISPLAY [display-name[,...]]
Parameters
display-name
Specifies the name of a display. If you do not specify a name, 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.
Qualifiers
/ALL
Lists all display definitions.
Description
The SHOW DISPLAY command lists all displays according to their order in
the display list. The most hidden display is listed 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 any debug command
list). It also identifies whether the display is removed from the
pasteboard or is dynamic (a dynamic display 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
Example
|
DBG> SHOW DISPLAY
display SRC at H1, size = 64, dynamic
kind = SOURCE (EXAMINE/SOURCE .%SOURCE_SCOPE\%PC)
display INST at H1, size = 64, removed, dynamic
kind = INSTRUCTION (EXAMINE/INSTRUCTION .0\%PC)
display REG at RH1, size = 64, removed, dynamic, kind = REGISTER
display OUT at S45, size = 100, dynamic, kind = OUTPUT
display EXSUM at Q3, size = 64, dynamic, kind = DO (EXAMINE SUM)
display PROMPT at S6, size = 64, dynamic, kind = PROGRAM
DBG>
|
The SHOW DISPLAY command lists all displays currently defined. In this
example, they include the five predefined displays (SRC, INST, REG,
OUT, and PROMPT), and the user-defined DO display EXSUM. Displays INST
and REG are removed from the display pasteboard: the DISPLAY command
must be used to display them on the screen.
SHOW EDITOR
Indicates the action taken by the EDIT command, as established by the
SET EDITOR command.
Format
SHOW EDITOR
Description
Related commands:
EDIT
SET EDITOR
Examples
| #1 |
DBG> SHOW EDITOR
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 initially 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 EDITOR
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 DEC Text Processing Utility
(DECTPU). The editing cursor is initially positioned at the beginning
of source line 1.
SHOW EVENT_FACILITY
Identifies the current event facility and the associated event names.
Event facilities are available for programs that call Ada routines or
that use POSIX Threads services. On VAX processors, event facilities
are also available for programs that call SCAN routines.
Format
SHOW EVENT_FACILITY
Description
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 the 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
Example
|
DBG> SHOW EVENT_FACILITY
event facility is THREADS
...
|
This command identifies the current event facility to be THREADS
(POSIX Threads) and lists the associated event names that can be used
with SET BREAK/EVENT or SET TRACE/EVENT commands.
SHOW EXIT_HANDLERS
Identifies the exit handlers that have been declared in your program.
Format
SHOW EXIT_HANDLERS
Description
The exit handler routines are displayed in the order that they are
called (that is, last in, first out). The routine name is displayed
symbolically, if possible. Otherwise, its address is displayed. The
debugger's exit handlers are not displayed.
Example
|
DBG> SHOW EXIT_HANDLERS
exit handler at STACKS\CLEANUP
DBG>
|
This command identifies the exit handler routine CLEANUP, which is
declared in module STACKS.
SHOW IMAGE
Displays information about one or more images that are part of your
running program.
Format
SHOW IMAGE [image-name]
Parameters
image-name
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 (*) wildcard
character by itself, all images are listed. You can use the wildcard
within an image name.
Description
The SHOW IMAGE command displays the following information:
- Name of the image
- Start and end addresses of the image
- Whether the image has been set with the SET IMAGE command (loaded
into the run-time symbol table, RST)
- Current image that is your debugging context (marked with an
asterisk (*))
- Total number of images selected in the display
- Number of bytes allocated for the RST and other internal structures
SHOW IMAGE does not display all of the memory ranges of an image
installed using the /RESIDENT qualifier. Instead, this command displays
only the process data region.
Related commands:
(SET,CANCEL) IMAGE
(SET,SHOW,CANCEL) MODULE
Example
|
DBG> SHOW IMAGE SHARE*
image name set base address end address
*SHARE yes 00000200 00000FFF
SHARE1 no 00001000 000017FF
SHARE2 yes 00018C00 000191FF
SHARE3 no 00019200 000195FF
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.
SHOW KEY
Displays the debugger predefined key definitions and those created by
the DEFINE/KEY command.
Note
This command is not available in the Compaq DECwindows Motif for OpenVMS user interface to
the debugger.
|
Format
SHOW KEY [key-name]
Parameters
key-name
Specifies a function key whose definition is displayed. Do not 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 Name |
LK201 Keyboard |
VT100-type |
VT52-type |
|
PF1
|
PF1
|
PF1
|
Blue
|
|
PF2
|
PF2
|
PF2
|
Red
|
|
PF3
|
PF3
|
PF3
|
Black
|
|
PF4
|
PF4
|
PF4
|
|
|
KP0--KP9
|
Keypad 0--9
|
Keypad 0--9
|
Keypad 0--9
|
|
PERIOD
|
Keypad period (.)
|
Keypad period (.)
|
|
|
COMMA
|
Keypad comma (,)
|
Keypad comma (,)
|
|
|
MINUS
|
Keypad minus (-)
|
Keypad minus (-)
|
|
|
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
|
|
|
Qualifiers
/ALL
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 qualifiers
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-name [,...])
/NOSTATE (default)
Selects one or more states for which a key definition is displayed. The
/STATE qualifier displays key definitions for the specified states. You
can specify predefined key states, such as DEFAULT and GOLD, or
user-defined states. A state name can be any appropriate alphanumeric
string. The /NOSTATE qualifier displays key definitions for the current
state only.
Description
Keypad mode must be enabled (SET MODE KEYPAD) before you can use this
command. Keypad mode is enabled by default.
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
This command displays all the key definitions for the current state.
| #2 |
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.
| #3 |
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.
| #4 |
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
| #1 |
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.
| #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 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 Compaq DECwindows Motif for OpenVMS user 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
| #1 |
DBG> SHOW MARGINS
left margin: 1 , right margin: 255
DBG>
|
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>
|
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>
|
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
| #1 |
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.
| #2 |
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.
| #3 |
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
|
|
