Document revision date: 30 March 2001

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.

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.

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

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.

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.

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.

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.

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.

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

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.

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.

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.

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

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.

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.

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
      

---

Previous

Next

Contents

Index

	privacy and legal statement
4538PRO_058.HTML