The additional topics list all the debugger commands and any
related DCL commands in functional groupings, along with brief
descriptions.
1 – Starting and Ending a Debugging Session
The following commands are used to start the debugger, bring
a program under debugger control, and interrupt and end a
debugging session. Except where the DCL RUN and DEBUG commands
are indicated specifically, all commands are debugger commands.
DEBUG/KEEP (DCL RUN Starts the debugger
command)
RUN program-image Brings a program under debugger control
RERUN Reruns the program currently under
debugger control
RUN program-image If the specified image was linked using
(DCL RUN command) LINK/DEBUG, starts the debugger and also
brings the image under debugger control.
When you start the debugger in this
manner, you cannot then use the debugger
RUN or RERUN commands. You can use the
/[NO]DEBUG qualifiers with the RUN command
to control whether the debugger is started
when the program is executed.
EXIT, Ctrl/Z Ends a debugging session, executing all
exit handlers
QUIT Ends a debugging session without executing
any exit handlers declared in the program
Ctrl/C Aborts program execution or a debugger
command without interrupting the debugging
session
(SET,SHOW) ABORT_KEY (Assigns, identifies) the default Ctrl/C
abort function to another Ctrl-key
sequence, identifies the Ctrl-key sequence
currently defined for the abort function
Ctrl/Y-DEBUG Interrupts a program that is running
(DCL DEBUG command) without debugger control and starts the
debugger
ATTACH Passes control of your terminal from the
current process to another process
SPAWN Creates a subprocess, enabling you to
execute DCL commands without ending a
debugging session or losing your debugging
context
2 – Controlling and Monitoring Program Execution
The following commands are used to control and monitor program
execution:
GO Starts or resumes program execution
STEP Executes the program up to the next line,
instruction, or specified instruction
(SET,SHOW) STEP (Establishes, displays) the default
qualifiers for the STEP command
(SET,SHOW,CANCEL) (Sets, displays, cancels) breakpoints
BREAK
(ACTIVATE,DEACTIVATE) (Activates, deactivates) previously set
BREAK breakpoints
(SET,SHOW,CANCEL) (Sets, displays, cancels) tracepoints
TRACE
(ACTIVATE,DEACTIVATE) (Activates, deactivates) previously set
TRACE tracepoints
(SET,SHOW,CANCEL) (Sets, displays, cancels) watchpoints
WATCH
(ACTIVATE,DEACTIVATE) (Activates, deactivates) previously set
WATCH watchpoints
SHOW CALLS Identifies the currently active routine
calls
SHOW STACK Gives additional information about the
currently active routine calls
CALL Calls a routine
3 – Examining and Manipulating Data
The following commands are used to examine and manipulate data:
EXAMINE Displays the value of a variable or the
contents of a program location
SET MODE [NO]OPERANDS Controls whether the address and contents
of the instruction operands are displayed
when you examine an instruction
DEPOSIT Changes the value of a variable or the
contents of a program location
EVALUATE Evaluates a language or address expression
MONITOR (Applies only to the debugger's DECwindows
Motif interface). Displays the current
value of a variable or language expression
in the Monitor View of the DECwindows
Motif interface.
4 – Type Selection and Radix
The following commands are used to control type selection and
radix:
(SET,SHOW,CANCEL) (Establishes, displays, restores) the
RADIX radix for data entry and display
(SET,SHOW,CANCEL) (Establishes, displays, restores) the
TYPE type for program locations that are not
associated with a compiler-generated type
SET MODE [NO]G_FLOAT Controls whether double-precision
floating-point constants are interpreted
as G_FLOAT or D_FLOAT
5 – Symbol Searches and Symbolization
The following commands are used to control symbol searches and
symbolization:
SHOW SYMBOL Displays symbols in your program
(SET,SHOW,CANCEL) Sets a module by loading its symbol
MODULE information into the debugger's symbol
table, identifies, cancels a set module
(SET,SHOW,CANCEL) Sets a shareable image by loading data
IMAGE structures into the debugger's symbol
table, identifies, cancels a set image
SET MODE [NO]DYNAMIC Controls whether or not modules and
shareable images are set automatically
when the debugger interrupts execution
(SET,SHOW,CANCEL) (Establishes, displays, restores) the
SCOPE scope for symbol searches
SYMBOLIZE Converts a memory address to a symbolic
address expression
SET MODE [NO]LINE Controls whether program locations are
displayed in terms of line numbers or
routine-name + byte offset
SET MODE [NO]SYMBOLIC Controls whether program locations are
displayed symbolically or in terms of
numeric addresses
6 – Displaying Source Code
The following commands are used to control the display of source
code:
TYPE Displays lines of source code
EXAMINE/SOURCE Displays the source code at the location
specified by the address expression
SEARCH Searches the source code for the specified
string
(SET,SHOW) SEARCH (Establishes, displays) the default
qualifiers for the SEARCH command
SET STEP [NO]SOURCE Enables/disables the display of source
code after a STEP command has been
executed or at a breakpoint, tracepoint,
or watchpoint
(SET,SHOW) MARGINS (Establishes, displays) the left and right
margin settings for displaying source code
(SET,SHOW,CANCEL) (Creates, displays, cancels) a source
SOURCE directory search list
7 – Screen Mode
The following commands are used to control screen mode and screen
displays:
SET MODE [NO]SCREEN Enables/disables screen mode
DISPLAY Creates or modifies a display
SCROLL Scrolls a display
EXPAND Expands or contracts a display
MOVE Moves a display across the screen
(SHOW,CANCEL) DISPLAY (Identifies, deletes) a display
(SET,SHOW,CANCEL) (Creates, identifies, deletes) a window
WINDOW definition
SELECT Selects a display for a display attribute
SHOW SELECT Identifies the displays selected for each
of the display attributes
SAVE Saves the current contents of a display
into another display
EXTRACT Saves a display or the current screen
state into a file
(SET,SHOW) TERMINAL (Establishes, displays) the terminal
screen height and width that the debugger
uses when it formats displays and other
output
SET MODE [NO]SCROLL Controls whether an output display is
updated line by line or once per command
Ctrl/W Refreshes the screen
DISPLAY/REFRESH
8 – Editing Source Code
The following commands are used to control source editing from a
debugging session:
EDIT Starts an editor during a debugging
session
(SET,SHOW) EDITOR (Establishes, identifies) the editor
started by the EDIT command
9 – Defining Symbols
The following commands are used to define and delete symbols for
addresses, commands, or values:
DEFINE Defines a symbol as an address, command,
or value
DELETE Deletes symbol definitions
(SET,SHOW) DEFINE (Establishes, displays) the default
qualifier for the DEFINE command
SHOW SYMBOL/DEFINED Identifies symbols that have been defined
with the DEFINE command
10 – Keypad Mode
The following commands are used to control keypad mode and key
definitions:
SET MODE [NO]KEYPAD Enables/disables keypad mode
DEFINE/KEY Creates key definitions
DELETE/KEY Deletes key definitions
SET KEY Establishes the key definition state
SHOW KEY Displays key definitions
11 – Command Log Initialization Files
The following commands are used with command procedures and log
files:
@ (Execute Procedure) Executes a command procedure
(SET,SHOW) ATSIGN (Establishes, displays) the default file
specification that the debugger uses to
search for command procedures
DECLARE Defines parameters to be passed to command
procedures
(SET,SHOW) LOG (Specifies, identifies) the debugger log
file
SET OUTPUT [NO]LOG Controls whether a debugging session is
logged
SET OUTPUT Controls whether, in screen mode, the
[NO]SCREEN_LOG screen contents are logged as the screen
is updated
SET OUTPUT [NO]VERIFY Controls whether debugger commands are
displayed as a command procedure is
executed
SHOW OUTPUT Identifies the current output options
established by the SET OUTPUT command
12 – Control Structures
The following commands are used to establish conditional and
looping structures for debugger commands:
FOR Executes a list of commands while
incrementing a variable
IF Executes a list of commands conditionally
REPEAT Executes a list of commands a specified
number of times
WHILE Executes a list of commands while a
condition is true
EXITLOOP Exits an enclosing WHILE, REPEAT, or FOR
loop
13 – Multiprocess Programs
The following commands are used to debug multiprocess programs.
Note that these commands are specific to multiprocess programs.
Many of the commands listed under other categories have
qualifiers or parameters that are specific to multiprocess
programs (for example, SET BREAK/ACTIVATING, EXIT process-spec,
DISPLAY/PROCESS=).
CONNECT Brings a process under debugger control
DISCONNECT Release a process from debugger control
DEFINE/PROCESS_GROUP Assigns a symbolic name to a list of
process specifications
DO Executes commands in the context of one or
more processes
SET MODE Controls whether execution is interrupted
[NO]INTERRUPT in other processes when it is paused in
some process
(SET,SHOW) PROCESS Modifies the multiprocess debugging
environment, displays process information
14 – Additional Commands
The following commands are used for miscellaneous purposes:
HELP Displays online help on debugger commands
and selected topics
(DISABLE,ENABLE,SHOW) (Disables, enables) the delivery of
AST ASTs in the program, identifies whether
delivery is enabled or disabled
(SET,SHOW) EVENT_ (Establishes, identifies) the current run-
FACILITY time facility for Ada, POSIX Threads, and
SCAN events
(SET,SHOW) LANGUAGE (Establishes, identifies) the current
language
SET MODE [NO]SEPARATE Controls whether the debugger, when used
on a workstation running VWS, creates a
separate window for debugger input and
output
SET OUTPUT Controls whether debugger output, except
[NO]TERMINAL for diagnostic messages, is displayed or
suppressed
SET PROMPT Specifies the debugger prompt
(SET,SHOW) TASK Modifies the tasking environment, displays
task information
(SET,SHOW) VECTOR_ Enables or disables a debugger vector mode
MODE option, identifies the current vector mode
option (for vectorized programs).
SHOW EXIT_HANDLERS Identifies the exit handlers declared in
the program
SHOW MODE Identifies the current debugger modes
established by the SET MODE command (for
example, screen mode, step mode)
SHOW OUTPUT Identifies the current output options
established by the SET OUTPUT command
SYNCHRONIZE VECTOR_ Forces immediate synchronization between
MODE the scalar and vector processors (for
vectorized programs)