Enables or disables a debugger mode.
Format
SET MODE mode[, . . . ]
1 – Parameters
DYNAMIC
(Default) Enables dynamic mode. When dynamic mode is enabled,
the debugger sets modules and images automatically during program
execution so that you typically do not have to enter the SET
MODULE or SET IMAGE command. Specifically, whenever the debugger
interrupts execution (whenever the debugger prompt is displayed),
the debugger automatically 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 informational
message when its sets a module or image automatically.
NODYNAMIC
Disables dynamic mode. Because additional memory is allocated
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 MODULE
and CANCEL IMAGE commands). When dynamic mode is disabled, you
must set modules and images explicitly with the SET MODULE and
SET IMAGE commands.
G_FLOAT
Specifies that the debugger interpret double-precision floating-
point constants entered in expressions as G_FLOAT (does not
affect the interpretation of variables declared in your program).
NOG_FLOAT
(Default) Specifies that the debugger interpret double-precision
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,
when program execution is suspended in any process, the debugger
interrupts execution in all other processes that were executing
images and prompts for input.
NOINTERRUPT
(Default) Useful when debugging a multiprocess program. Specifies
that, when program execution is suspended in any process, the
debugger take no action with regard to other process.
KEYPAD
NOTE
This parameter is not available in the VSI DECwindows Motif
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 the
Keypad_Definitions_CI help topic; also, use the SHOW KEY command
to determine the current key definitions.) You can also redefine
the key functions with the DEFINE/KEY command.
NOKEYPAD
NOTE
This parameter is not available in the VSI DECwindows Motif
for OpenVMS user interface to the debugger.
Disables keypad mode. When keypad mode is disabled, the keys on
the numeric keypad do not have predefined functions, nor can you
assign debugger functions to those keys with DEFINE/KEY commands.
LINE
(Default) Specifies that the debugger display program locations
in terms of line numbers, if possible.
NOLINE
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 any
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
NOTE
This parameter is not available in the VSI DECwindows Motif
for OpenVMS user interface to the debugger.
Enables screen mode. When screen mode is enabled, you can divide
the terminal screen into rectangular regions, so different data
can be displayed in different regions. Screen mode enables you to
view more information more conveniently than the default, line-
oriented, noscreen mode. You can use the predefined displays, or
you can define your own.
NOSCREEN
NOTE
This parameter is not available in the VSI DECwindows Motif
for OpenVMS user interface to the debugger.
(Default) Disables screen mode.
SCROLL
NOTE
This parameter is not available in the VSI DECwindows Motif
for OpenVMS user interface to the debugger.
Enables scroll mode. When scroll mode is enabled, a screen-mode
output or DO display is updated by scrolling the output line by
line, as it is generated. SET MODE SCROLL is the default.
NOSCROLL
NOTE
This parameter is not available in the VSI DECwindows Motif
for OpenVMS user interface to the debugger.
Disables scroll mode. When scroll mode is disabled, a screen-mode
output or DO display is updated only once per command, instead
of line by line as it is generated. Disabling scroll mode reduces
the amount of screen updating that takes place and can be useful
with slow terminals.
SEPARATE
(Applies only to workstations running VWS.) Specifies that a
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 that
contains the program's input and output. The separate window is
created with a height of 24 lines and a width of 80 columns wide,
emulating a VT-series terminal screen.
NOSEPARATE
(Applies only to workstations running VWS. Default.) Specifies
that no separate window be created for debugger input and output.
SYMBOLIC
(Default) Enables symbolic mode. When symbolic mode is
enabled, the debugger displays the locations denoted by address
expressions symbolically (if possible) and displays instruction
operands symbolically (if possible). EXAMINE/NOSYMBOLIC can be
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 (it
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, command
processing might speed up somewhat, because the debugger does not
need to convert numbers to names. EXAMINE/SYMBOLIC can be used
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 immediately
prompts for new commands even if some or all processes are still
running.
2 – 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
3 – Example
DBG> SET MODE SCREEN
This command puts the debugger in screen mode.