 |
OpenVMS Debugger Manual
CANCEL ALL
Cancels all breakpoints, tracepoints, and watchpoints. Restores the
scope and type to their default values. Restores the line, symbolic,
and G_floating modes established with the SET MODE command to their
default values.
Format
CANCEL ALL
Qualifiers
/PREDEFINED
Cancels all predefined (but no user-defined) breakpoints and
tracepoints.
/USER
Cancels all user-defined (but no predefined) breakpoints, tracepoints,
and watchpoints. This is the default unless you specify /PREDEFINED.
Description
The CANCEL ALL command does the following:
- Cancels all user-defined eventpoints (those created with the
commands SET BREAK, SET TRACE, and SET WATCH). This is equivalent to
entering the commands CANCEL BREAK/ALL, CANCEL TRACE/ALL, and CANCEL
WATCH/ALL. Depending on the type of program (for example Ada,
multiprocess), certain predefined breakpoints or tracepoints might be
set automatically when you start the debugger. To cancel all predefined
but no user-defined eventpoints, use CANCEL ALL/PREDEFINED. To cancel
all predefined and user-defined eventpoints, use CANCEL
ALL/PREDEFINED/USER.
- Restores the scope search list to its default value
(0,1,2,...,n). This is equivalent to entering the CANCEL SCOPE
command.
- Restores the data type for memory locations that are associated
with a compiler-generated type to the associated type. Restores the
type for locations that are not associated with a compiler-generated
type to "longword integer". This is equivalent to entering
the CANCEL TYPE/OVERRIDE and SET TYPE LONGWORD commands.
- Restores the line, symbolic, and G_floating modes established with
the SET MODE command to their default values. This is equivalent to
entering the following command:
DBG> SET MODE LINE,SYMBOLIC,NOG_FLOAT
|
The CANCEL ALL command does not affect the current language setting or
modules included in the run-time symbol table.
Related commands:
(CANCEL,DEACTIVATE) BREAK
CANCEL SCOPE
(CANCEL,DEACTIVATE) TRACE
CANCEL TYPE/OVERRIDE
(CANCEL,DEACTIVATE) WATCH
(SET,CANCEL) MODE
SET TYPE
Examples
This command cancels all user-defined breakpoints and tracepoints and
all watchpoints, and restores scopes, types, and some modes to their
default values. In this example, there are no predefined breakpoints or
tracepoints.
| #2 |
DBG> CANCEL ALL
%DEBUG-I-PREDEPTNOT, predefined eventpoint(s) not canceled
|
This command cancels all user-defined breakpoints and tracepoints and
all watchpoints, and restores scopes, types, and some modes to their
default values. In this example, there is a predefined breakpoint or
tracepoint; this is not canceled by default.
| #3 |
DBG> CANCEL ALL/PREDEFINED
|
This command cancels all predefined breakpoints and tracepoints, and
restores scopes, types, and some modes to their default values. No
user-defined breakpoints or tracepoints are affected.
CANCEL BREAK
Cancels a breakpoint.
Format
CANCEL BREAK [address-expression[,...]]
Parameters
address-expression
Specifies a breakpoint to be canceled. Do not use the asterisk (*)
wildcard character. Instead, use the /ALL qualifier. Do not specify an
address expression when using any qualifiers except /EVENT,
/PREDEFINED, or /USER.
Qualifiers
/ACTIVATING
Cancels the effect of a previous SET BREAK/ACTIVATING command.
/ALL
By default, cancels all user-defined breakpoints. When used with
/PREDEFINED, cancels all predefined breakpoints but no user-defined
breakpoints. To cancel all breakpoints, use CANCEL
BREAK/ALL/USER/PREDEFINED.
/BRANCH
Cancels the effect of a previous SET BREAK/BRANCH command.
/CALL
Cancels the effect of a previous SET BREAK/CALL command.
/EVENT=event-name
Cancels the effect of a previous SET BREAK/EVENT=event-name
command. Specify the event name (and address expression, if any)
exactly as specified with the SET BREAK/EVENT command. To identify the
current event facility and the associated event names, use the SHOW
EVENT_FACILITY command.
/EXCEPTION
Cancels the effect of a previous SET BREAK/EXCEPTION command.
/HANDLER
Cancels the effect of a previous SET BREAK/HANDLER command.
/INSTRUCTION
Cancels the effect of a previous SET BREAK/INSTRUCTION command.
/LINE
Cancels the effect of a previous SET BREAK/LINE command.
/PREDEFINED
Cancels a specified predefined breakpoint without affecting any
user-defined breakpoints. When used with /ALL, cancels all predefined
breakpoints.
/SYSEMULATE
(Alpha only) Cancels the effect of a previous SET BREAK/SYSEMULATE
command.
/TERMINATING
Cancels the effect of a previous SET BREAK/TERMINATING command.
/UNALIGNED_DATA
(Alpha only) Cancels the effect of a previous SET BREAK/UNALIGNED_DATA
command.
/USER
Cancels a specified user-defined breakpoint without affecting any
predefined breakpoints. This is the default unless you specify
/PREDEFINED. To cancel all user-defined breakpoints, use the /ALL
qualifier.
/VECTOR_INSTRUCTION
(VAX only) Cancels the effect of a previous SET
BREAK/VECTOR_INSTRUCTION command.
Description
Breakpoints can be user defined or predefined. User-defined breakpoints
are set explicitly with the SET BREAK command. Predefined breakpoints,
which depend on the type of program you are debugging (for example, Ada
or ZQUIT multiprocess), are established automatically when you start
the debugger. Use the SHOW BREAK command to identify all breakpoints
that are currently set. Any predefined breakpoints are identified as
such.
User-defined and predefined breakpoints are set and canceled
independently. For example, a location or event can have both a
user-defined and a predefined breakpoint. Canceling the user-defined
breakpoint does not affect the predefined breakpoint, and conversely.
To cancel only user-defined breakpoints, do not specify /PREDEFINED
with the CANCEL BREAK command (the default is /USER). To cancel only
predefined breakpoints, specify /PREDEFINED but not /USER. To cancel
both predefined and user-defined breakpoints, specify both /PREDEFINED
and /USER.
In general, the effect of the CANCEL BREAK command is symmetrical with
that of the SET BREAK command (even though the SET BREAK command is
used only with user-defined breakpoints). Thus, to cancel a breakpoint
that was established at a specific location, specify that same location
(address expression) with the CANCEL BREAK command. To cancel
breakpoints that were established on a class of instructions or events,
specify the class of instructions or events with the corresponding
qualifier (/LINE, /BRANCH, /ACTIVATING, /EVENT=, and so on). For more
information, see the qualifier descriptions.
If you want the debugger to ignore a breakpoint without your having to
cancel it (for example, if you want to rerun the program with and
without breakpoints), use the DEACTIVATE BREAK instead of the CANCEL
BREAK command. Later, you can activate the breakpoint (with ACTIVATE
BREAK).
Related commands:
(ACTIVATE,DEACTIVATE) BREAK
CANCEL ALL
(SET,SHOW) BREAK
(SET,SHOW) EVENT_FACILITY
(SET,SHOW,CANCEL) TRACE
Examples
| #1 |
DBG> CANCEL BREAK MAIN\LOOP+10
|
This command cancels the user-defined breakpoint set at the address
expression MAIN\LOOP+10.
This command cancels all user-defined breakpoints.
| #3 |
DBG> CANCEL BREAK/ALL/USER/PREDEFINED
|
This command cancels all user-defined and predefined breakpoints.
| #4 |
all> CANCEL BREAK/ACTIVATING
|
This command cancels a previous user-defined SET BREAK/ACTIVATING
command. As a result, the debugger does not suspend execution when a
new process is brought under debugger control.
| #5 |
DBG> CANCEL BREAK/EVENT=EXCEPTION_TERMINATED/PREDEFINED
|
This command cancels the predefined breakpoint set on task terminations
due to unhandled exceptions. This breakpoint is predefined for Ada
programs and programs that call POSIX Threads or Ada routines.
CANCEL DISPLAY
Permanently deletes a screen display.
Note
This command is not available in the Compaq DECwindows Motif for OpenVMS user interface to
the debugger.
|
Format
CANCEL DISPLAY [display-name[,...]]
Parameters
display-name
Specifies the name of a display to be canceled. Do not specify the
PROMPT display, which cannot be canceled. Do not use the asterisk (*)
wildcard character. Instead, use the /ALL qualifier. Do not specify a
display name with /ALL.
Qualifiers
/ALL
Cancels all displays, except the PROMPT display.
Description
When a display is canceled, its contents are permanently lost, it is
deleted from the display list, and all the memory that was allocated to
it is released.
You cannot cancel the PROMPT display.
Related commands:
(SHOW) DISPLAY
(SET,SHOW,CANCEL) WINDOW
Examples
| #1 |
DBG> CANCEL DISPLAY SRC2
|
This command deletes display SRC2.
| #2 |
DBG> CANCEL DISPLAY/ALL
|
This command deletes all displays, except the PROMPT display.
CANCEL MODE
Restores the line, symbolic, and G_floating modes established by the
SET MODE command to their default values. Also restores the default
input/output radix.
Note
This command is not available in the Compaq DECwindows Motif for OpenVMS user interface to
the debugger.
|
Format
CANCEL MODE
Description
The effect of the CANCEL MODE command is equivalent to the following
commands:
DBG> SET MODE LINE,SYMBOLIC,NOG_FLOAT
DBG> CANCEL RADIX
|
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.
Related commands:
(SET,SHOW) MODE
(SET,SHOW,CANCEL) RADIX
Example
This command restores the default radix mode and all default mode
values.
CANCEL RADIX
Restores the default radix for the entry and display of integer data.
Format
CANCEL RADIX
Qualifiers
/OVERRIDE
Cancels the override radix established by a previous SET RADIX/OVERRIDE
command. This sets the current override radix to "none" and
restores the output radix mode to the value established with a previous
SET RADIX or SET RADIX/OUTPUT command. If you did not change the radix
mode with a SET RADIX or SET RADIX/OUTPUT command, the CANCEL
RADIX/OVERRIDE command restores the radix mode to its default value.
Description
The CANCEL RADIX command cancels the effect of any previous SET RADIX
and SET RADIX/OVERRIDE commands. It restores the input and output radix
to their default value. 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 effect of the CANCEL RADIX/OVERRIDE command is more limited and is
explained in the description of the /OVERRIDE qualifier.
Related commands:
EVALUATE
(SET,SHOW) RADIX
Examples
This command restores the default input and output radix.
| #2 |
DBG> CANCEL RADIX/OVERRIDE
|
This command cancels any override radix you might have set with the SET
RADIX/OVERRIDE command.
CANCEL SCOPE
Restores the default scope search list for symbol lookup.
Format
CANCEL SCOPE
Description
The CANCEL SCOPE command cancels the current scope search list
established by a previous SET SCOPE command and restores the default
scope search list, namely 0,1,2,...,n, where n is the
number of calls in the call stack.
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), then searches the global symbol table (GST), if necessary.
Related commands:
(SET,SHOW) SCOPE
Example
This command cancels the current scope.
CANCEL SOURCE
Cancels a source directory search list, a source directory search
method, or both a list and method established by a previous SET SOURCE
command.
Format
CANCEL SOURCE
Qualifiers
/DISPLAY
Cancels the effect of a previous SET SOURCE/DISPLAY command, which
specifies the directory search list to be used by the debugger when
displaying source code. Canceling this command means the debugger
searches for a source file in the directory in which it was compiled.
/EDIT
Cancels the effect of a previous SET SOURCE/EDIT command, which
specifies the directory search list to be used during execution of the
debugger's EDIT command. Canceling this command means the debugger
searches for a source file in the directory in which it was compiled.
/EXACT
Cancels the effect of a previous SET SOURCE/EXACT command, which
specifies a directory search method. Canceling this command means that
the debugger no longer searches for the exact version of the
source file from compilation; it reverts to the default behavior of
searching for the latest version of the file.
/LATEST
Cancels the effect of a previous SET SOURCE/LATEST command, which
specifies a directory search method. In this case, the CANCEL
SOURCE/LATEST command directs the debugger to return to searching for
the exact version of the source file from compilation. Because
/LATEST is the default setting, this qualifier only makes sense when
used with other qualifiers, for example, /MODULE.
/MODULE=module-name
Cancels the effect of a previous SET SOURCE/MODULE=module-name
command in which the same module name and qualifiers were specified.
(The /MODULE qualifier allows you to specify a unique directory search
list, directory search method, or both, for the named module.) You can
append one or more of the qualifiers listed above to the SET
SOURCE/MODULE and CANCEL SOURCE/MODULE commands.
If you issue a CANCEL SOURCE/MODULE command with additional qualifiers,
you cancel the effect of the specified qualifiers on the module. If you
issue an unqualified CANCEL SOURCE/MODULE command, the debugger no
longer differentiates the module from any other module in your
directories.
/ORIGINAL
(Applies to STDL programs only. Requires the installation of the
Correlation Facility (a separate layered product) and invocation of the
kept debugger.) Cancels the effect of a previous SET SOURCE/ORIGINAL
command. The SET SOURCE/ORIGINAL command is required to debug STDL
source files, and must be canceled when you debug source files written
in other languages.
Description
CANCEL SOURCE cancels the effect of a previous SET SOURCE command. The
nature of this cancellation depends on the qualifiers activated in
previous SET SOURCE commands. See the CANCEL SOURCE examples to see how
CANCEL SOURCE and SET SOURCE interact.
When you issue a SET SOURCE command, be aware that one of the two
qualifiers ---/LATEST or /EXACT---will always be active. These
qualifiers affect the debugger search method. The /LATEST qualifier
directs the debugger to search for the version last created (the
highest-numbered version in your directory). The /EXACT qualifier
directs the debugger to search for the version last compiled (the
version recorded in the debugger symbol table created at compile time).
For example, a SET SOURCE/LATEST command might search for SORT.FOR;3
while a SET SOURCE/EXACT command might search for SORT.FOR;1.
CANCEL SOURCE without the /DISPLAY or /EDIT qualifier cancels the
effect of both SET SOURCE/DISPLAY and SET SOURCE/EDIT, if both were
previously given.
The /DISPLAY qualifier is needed when the files to be displayed are no
longer in the compilation directory.
The /EDIT qualifier is needed when the files used for the display of
source code are different from the editable files. This is the case
with Ada programs. For Ada programs, the (SET,SHOW,CANCEL) SOURCE
commands affect the search of files used for source display (the
"copied" source files in Ada program libraries); the
(SET,SHOW,CANCEL) SOURCE/EDIT commands affect the search of the source
files that you edit when using the EDIT command.
For information specific to Ada programs, type HELP Language_Support
Ada.
Related commands:
(SET,SHOW) SOURCE
Examples
| #1 |
DBG> SET SOURCE/MODULE=CTEST/EXACT [],SYSTEM::DEVICE:[PROJD]
DBG> SET SOURCE [PROJA],[PROJB],[PETER.PROJC]
...
DBG> SHOW SOURCE
source directory search list for CTEST,
match the exact source file version:
[]
SYSTEM::DEVICE:[PROJD]
source directory list for all other modules,
match the latest source file version:
[PROJA]
[PROJB]
[PETER.PROJC]
DBG> CANCEL SOURCE
DBG> SHOW SOURCE
source directory search list for CTEST,
match the exact source file version:
[]
SYSTEM::DEVICE:[PROJD]
all other source files will try to match
the latest source file version
|
In this example, the SET SOURCE command establishes a directory search
list and a search method (the default, latest version) for source files
other than CTEST. The CANCEL SOURCE command cancels the directory
search list but does not cancel the search method.
| #2 |
DBG> SET SOURCE/MODULE=CTEST/EXACT [],SYSTEM::DEVICE:[PROJD]
DBG> SET SOURCE [PROJA],[PROJB],[PETER.PROJC]
...
DBG> SHOW SOURCE
source directory search list for CTEST,
match the exact source file version:
[]
SYSTEM::DEVICE:[PROJD]
source directory list for all other modules,
match the latest source file version:
[PROJA]
[PROJB]
[PETER.PROJC]
DBG> CANCEL SOURCE/MODULE=CTEST/EXACT
DBG> SHOW SOURCE
source directory search list for CTEST,
match the latest source file version:
[]
SYSTEM::DEVICE:[PROJD]
source directory list for all other modules,
match the latest source file version:
[PROJA]
[PROJB]
[PETER.PROJC]
DBG> CANCEL SOURCE/MODULE=CTEST
DBG> SHOW SOURCE
source directory list for all modules,
match the latest source file version:
[PROJA]
[PROJB]
[PETER.PROJC]
|
In this example, the SET SOURCE/MODULE=CTEST/EXACT command establishes
a directory search list and a search method (exact version) for the
source file CTEST. The CANCEL SOURCE/MODULE=CTEST/EXACT command cancels
the CTEST search method (returning to the default latest version), and
the CANCEL SOURCE/MODULE=CTEST command cancels the CTEST directory
search list.
| #3 |
DBG> SET SOURCE /EXACT
DBG> SHOW SOURCE
no directory search list in effect,
match the exact source file
DBG> SET SOURCE [JONES]
DBG> SHOW SOURCE
source directory list for all modules,
match the exact source file version:
[JONES]
DBG> CANCEL SOURCE /EXACT
DBG> SHOW SOURCE
source directory list for all modules,
match the latest source file version:
[JONES]
|
In this example, the SET SOURCE/EXACT command establishes a search
method (exact version) that remains in effect for the SET SOURCE
[JONES] command. The CANCEL SOURCE/EXACT command not only cancels the
SET SOURCE/EXACT command, but also affects the SET SOURCE [JONES]
command.
|
