DEBUG CANCEL — VMS C_3.0
Cancels breakpoints, tracepoints, and watchpoints, and restores
scope and source directory search list and user-set entry/display
modes, radix, and types to their default values. Also cancels
screen displays and windows. The item canceled depends on the
keyword specified in the command.
Format:
CANCEL keyword [/qualifier] [parameters]
Additional information available:
ALLBREAKDISPLAYIMAGEMODEMODULERADIX
SCOPESOURCETRACETYPEWATCHWINDOW
Parameters
keyword
Specifies the item to be canceled. Keyword can be ALL, BREAK,
DISPLAY, IMAGE, MODE, MODULE, RADIX, SCOPE, SOURCE, TRACE,
TYPE/OVERRIDE, WATCH, or WINDOW,
qualifier
Depends on the keyword specified.
parameters
Depends on the keyword specified.
ALL
Cancels all breakpoints, tracepoints, and watchpoints. Restores
some modes established with the SET MODE command to their default
values. Restores the scope and type to their default values.
Format:
CANCEL ALL [/qualifier]
The CANCEL ALL command performs the following steps:
1. Cancels all breakpoints, tracepoints, and watchpoints. 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 may be set
automatically when you invoke the debugger. By default
(CANCEL ALL/USER), only user defined breakpoints,
tracepoints, and watchpoints are canceled -- those that were
previously set explicitly with the SET BREAK, SET TRACE, and
SET WATCH commands. If you specify /PREDEFINED but not
/USER, all predefined (but no user defined) breakpoints,
tracepoints, and watchpoints are canceled. If you specify
both /PREDEFINED and /USER, all predefined and user defined
breakpoints, tracepoints, and watchpoints are canceled.
2. Restores the scope search list to its default value (0,1,2, .
. . ,n). This is equivalent to entering the CANCEL SCOPE
command.
3. 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 commands CANCEL
TYPE/OVERRIDE and SET TYPE LONGWORD.
4. Restores some 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
5. The CANCEL ALL command does not affect the current language
setting or modules included in the run-time symbol table (SET
MODULE).
CANCEL ALL does not affect the current language setting or the
modules included in the debugger symbol table.
Additional information available:
Examples
1 DBG> CANCEL ALL
This command cancels all user defined breakpoints, tracepoints,
and watchpoints and restores scopes, types, and some modes to
their default values. In this example, there are no predefined
breakpoints, tracepoints, or watchpoints.
2 DBG> CANCEL ALL
%DEBUG-I-PREDEPTNOT, predefined eventpoint(s) not canceled
This command cancels all user defined breakpoints, tracepoints,
and watchpoints and restores scopes, types, and some modes to
their default values. In this example, there are some predefined
breakpoints, tracepoints, or watchpoints, and these are not
canceled, by default.
3 DBG> CANCEL ALL/PREDEFINED
This command cancels all predefined breakpoints, tracepoints, and
watchpoints and restores scopes, types, and some modes to their
default values. No user defined breakpoints, tracepoints, or
watchpoints are affected.
Qualifiers
Additional information available:
/PREDEFINED
Cancels all predefined (but no user defined) breakpoints,
tracepoints, and watchpoints.
/USER
Cancels all user defined (but no predefined) breakpoints,
tracepoints, and watchpoints. CANCEL ALL/USER is assumed by
default unless you specify /PREDEFINED.
BREAK
Cancels breakpoints.
Format:
CANCEL BREAK [/qualifier] [address-expression [,...]]
Breakpoints may be user defined or predefined. User defined
breakpoints are those that you set explicitly with the SET BREAK
command. Predefined breakpoints, which depend on the type of
program you are debugging (for example, Ada or multiprocess), are
established automatically when you invoke 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 may 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 (/USER is the default).
To cancel only predefined breakpoints, specify /PREDEFINED but
not /USER. To cancel both user defined and predefined
breakpoints, specify both /USER and /PREDEFINED.
In general, note that 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
(for example, /LINE, /BRANCH, /ACTIVATING, /EVENT=, and so on).
See the qualifier descriptions for more specific information.
Additional information available:
Examples:
1 DBG> SET BREAK/SILENT A\B DO (EX X)
DBG> CANCEL BREAK A\B
This CANCEL BREAK command cancels the effect of the SET BREAK command
2 DBG> SET BREAK/INST WHEN (A .NE. 0)
DBG> CANCEL BREAK/INST
This CANCEL BREAK command cancels the effect of the SET BREAK command
3 DBG> CANCEL BREAK MAIN\LOOP+10
This command cancels the user defined breakpoint set
at the address expression MAIN\LOOP+10.
4 DBG> CANCEL BREAK/ALL
This command cancels all user defined breakpoints.
5 DBG> CANCEL BREAK/ALL/USER/PREDEFINED
This command cancels all user defined and predefined breakpoints.
6 DBG_1> 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.
7 DBG> CANCEL BREAK/EVENT=DEPENDENTS_EXCEPTION/PREDEFINED
This command cancels the predefined breakpoint set on
dependent exceptions. This breakpoint is predefined
for Ada programs.
Parameters
address-expression
Specifies a breakpoint to be canceled. Do not use the asterisk
wildcard character (*). Do not specify an address expression
when using any of the qualifiers except for /EVENT, /PREDEFINED,
or /USER.
Qualifiers
Additional information available:
/ACTIVATING/ALL/BRANCH/CALL/EVENT/EXCEPTION
/INSTRUCTION/LINE/PREDEFINED/TERMINATING
/USER
/ACTIVATING
Note: This qualifier applies to a multiprocess debugging
configuration (when DBG$PROCESS has the value MULTIPROCESS).
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. Specify both /USER and /PREDEFINED to
cancel all breakpoints.
/BRANCH
Cancel effect of SET BREAK/BRANCH.
/CALL
Cancel effect of SET BREAK/CALL.
/EVENT=event-name
Cancel effect of the command
SET BREAK/EVENT=event-name [expression[, expression...]]
Format:
CANCEL BREAK/EVENT=event-name [expression[, expression...]]
The event-name keyword and expression parameter(s) cancel the
breakpoint(s) which was set with the same keyword and expression
parameter. If the expression parameter was omitted on the SET
command, the expression parameter should also be omitted on the
CANCEL command.
/EXCEPTION
Cancel effect of SET BREAK/EXCEPTION.
/INSTRUCTION
Cancel effect of the command SET BREAK/INSTRUCTION or SET
BREAK/INSTRUCTION=(opcode-list).
/LINE
Cancel effect of SET BREAK/LINE.
/PREDEFINED
Cancels a specified predefined breakpoint without affecting any
user defined breakpoints. When used with /ALL, cancels all
predefined breakpoints.
/TERMINATING
Cancels the effect of a previous SET BREAK/TERMINATING command.
/USER
Cancels a specified user defined breakpoint without affecting any
predefined breakpoints. When used with /ALL, cancels all user
defined breakpoints. CANCEL BREAK/USER is assumed by default
unless you specify /PREDEFINED.
DISPLAY
Cancels a specified screen display or cancels all screen
displays. You must specify the names of the displays to be
cancelled or the /ALL qualifier, but not both. When a screen
display is cancelled, it is deleted entirely: Its contents are
lost, it is removed from the screen display list, and all its
memory is released to the memory pool.
Format:
CANCEL DISPLAY [/qualifier] [disp_name [,disp_name...]]
Example:
CANCEL DISPLAY OUT
The above cancels the output display and thus causes input and
output to be intermixed.
Additional information available:
Parameters
disp_name
The name of a screen display to be cancelled.
Qualifiers
Additional information available:
/ALL
Specifies that all screen displays be cancelled.
/SUFFIX[=process-identifier-type]
Note: This qualifier applies to a multiprocess debugging
configuration (when DBG$PROCESS has the value MULTIPROCESS). Use
this qualifier only directly after a display name.
Appends a process-identifying suffix to a display name. The
suffix denotes the visible process. This qualifier is used
primarily in command procedures when specifying display
definitions or key definitions that are bound to display
definitions. Use any of the following process-identifier-type
keywords:
PROCESS_NAME The display-name suffix is the VMS process name.
PROCESS_NUMBER The display-name suffix is the process number
(as shown in a SHOW PROCESS display).
PROCESS_PID The display-name suffix is the VMS process
identification number (PID).
If you specify /SUFFIX without a process-identifier- type
keyword, the process identifier type used for the display-name
suffix is, by default, the same as that used for the prompt
suffix (see SET PROMPT/SUFFIX).
IMAGE
Cancels a previously "set" shareable image (see the help on SET
IMAGE and SHOW IMAGE). Cancelling an image deallocates the data
structures that were built when the image was set. If you cancel
the "current image", then "current image" reverts back to the
main image. You cannot cancel the main image.
Format:
CANCEL IMAGE [/ALL] [image-name [,...]]
Example: say you want to set a breakpoint on routine R in
shareable image SHARE:
DBG> SET IMAGE SHARE
DBG> SET BREAK R
DBG> CANCEL IMAGE SHARE
MODE
Cancels radix mode, symbolic/nosymbolic mode and G_float/D_float
mode settings established by the SET MODE command, thus
reestablishing language-specific default mode values.
Format:
CANCEL MODE
MODULE
Removes symbols declared in the specified module(s) or in all
modules from the debugger symbol table. If debugger response
time becomes a problem, it may help to cancel modules that you
are not referencing. This removes symbols from those modules
from the debugger symbol table and thus may speed up searches of
the symbol table.
You can remove the symbols from one module, from a list of
modules, or from all modules.
Format:
CANCEL MODULE [/qualifier] [ module[,module,...] ]
Examples:
DBG> CANCEL MODULE A,B,C
DBG> CANCEL MODULE/ALL
Additional information available:
Parameters
module(s)
Specifies the name of the module(s) whose symbols are to be
removed from the symbol table.
Qualifiers
Additional information available:
/ALL
Specifies that symbols in all modules be removed from the symbol
table.
/NORELATED
(Meaningful for language ADA only). This qualifier tells the
debugger to cancel only the module or modules specified in this
command. In language ADA, "related" modules may also be
cancelled unless this qualifier is specified.
Example:
DBG> CANCEL MODULE/NOREL M ! Cancel only M
DBG> CANCEL MODULE/RELAT M ! Cancel M and all the
! packages it imports.
/RELATED
(Meaningful for language ADA only). This qualifier is the
default. It enables automatic module cancelling and thereby
cancels all those modules that are related to this one.
RADIX
Cancels radix mode settings established by the SET RADIX command,
thus reestablishing language-specific default radix mode values.
Format:
CANCEL RADIX
CANCEL RADIX/OVERRIDE
Additional information available:
Qualifiers
/OVERRIDE is the only qualifier allowed. CANCEL RADIX/OVERRIDE
cancels the effect of a previous SET RADIX/OVERRIDE command.
/OVERRIDE
Cancels radix mode settings established by the SET RADIX/OVERRIDE
command.
SCOPE
Cancels the current scope search list established by the SET
SCOPE command. The scope search list is set back to its default
value of 0,1,2,3,4,...,N. As a result of the CANCEL SCOPE
command, symbols without pathname prefixes are looked up relative
to the current PC. See the help on "SET SCOPE default" for more
precise details on what this means.
Format:
CANCEL SCOPE
SOURCE
Cancels the current source directory search list established by
previous SET SOURCE commands.
The CANCEL SOURCE command without the /MODULE qualifier cancels
the effect of a previous SET SOURCE command.
The CANCEL SOURCE/MODULE=modname command cancels the effect of a
previous SET SOURCE/MODULE=modname command in which the same
module name was specified.
The CANCEL SOURCE/EDIT command cancels the effect of a previous
SET SOURCE/EDIT. The use of the /EDIT qualifier means that the
source directory search list is only to be applied on the EDIT
command.
Format:
CANCEL SOURCE [/MODULE=modname] [/EDIT]
Examples:
DBG> SET SOURCE [],SRC$
DBG> CANCEL SOURCE ! Cancels effect of above
DBG> SET SOURCE/MODULE=M []
DBG> CANCEL SOURCE/MODULE=M ! Cancels effect of above
Additional information available:
Qualifiers
Additional information available:
/MODULE=modname
Specifies the name of a module for which a source directory
search list is to be canceled.
/EDIT
Cancels the effect of a previous SET SOURCE/EDIT. The /EDIT
qualifier means that the source directory search list is only to
be used on the EDIT command.
TRACE
Cancels tracepoints.
Format:
CANCEL TRACE [/qualifier] [address-expression [,...]]
Tracepoints may be user defined or predefined. User defined
tracepoints are those that you set explicitly with the SET TRACE
command. Predefined tracepoints, which depend on the type of
program you are debugging (for example, Ada or multiprocess), are
established automatically when you invoke the debugger. Use the
SHOW TRACE command to identify all tracepoints that are currently
set. Any predefined tracepoints are identified as such.
User defined and predefined tracepoints are set and canceled
independently. For example, a location or event may have both a
user defined and a predefined tracepoint. Canceling the user
defined tracepoint does not affect the predefined tracepoint, and
conversely.
To cancel only user defined tracepoints, do not specify
/PREDEFINED with the CANCEL TRACE command (/USER is the default).
To cancel only predefined tracepoints, specify /PREDEFINED but
not /USER. To cancel both user defined and predefined
tracepoints, specify both /USER and /PREDEFINED.
In general, note that the effect of the CANCEL TRACE command is
symmetrical with that of the SET TRACE command (even though the
SET TRACE command is used only with user defined tracepoints).
Thus,
to cancel a tracepoint that was established at a specific
location, specify that same location (address expression) with
the CANCEL TRACE command. To cancel tracepoints that were
established on a class of instructions or events, specify the
class of instructions or events with the corresponding qualifier
(for example, /LINE, /BRANCH, /ACTIVATING, /EVENT=, and so on).
See the qualifier descriptions for more specific information.
Additional information available:
Examples:
1 DBG> SET TRACE X DO (SHOW CALLS)
DBG> CANCEL TRACE X
This CANCEL TRACE command cancels the effect of the SET TRACE command
2 DBG> SET TRACE/INST WHEN (A .NE. 0)
DBG> CANCEL TRACE/INST
This CANCEL TRACE command cancels the effect of the SET TRACE command
3 DBG> CANCEL TRACE MAIN\LOOP+10
This command cancels the user defined tracepoint at
the location MAIN\LOOP+10.
4 DBG> CANCEL TRACE/ALL
This command cancels all user defined tracepoints.
5 DBG_1> CANCEL TRACE/TERMINATING
This command cancels a previous user defined SET
TRACE/TERMINATING command. As a result, a tracepoint
is not triggered when a process performs an image exit.
Parameters
address-expression
Specifies a tracepoint to be canceled. Do not use the asterisk
wildcard character (*). Do not specify an address expression
when using any of the qualifiers except for /EVENT, /PREDEFINED,
or /USER.
Qualifiers
Additional information available:
/ACTIVATING/ALL/BRANCH/CALL/EVENT/EXCEPTION
/INSTRUCTION/LINE/PREDEFINED/TERMINATING
/USER
/ACTIVATING
Note: This qualifier applies to a multiprocess debugging
configuration (when DBG$PROCESS has the value MULTIPROCESS).
Cancels the effect of a previous SET TRACE/ACTIVATING command.
/ALL
Cancel all tracepoints.
/BRANCH
Cancel effect of SET TRACE/BRANCH.
/CALL
Cancel effect of SET TRACE/CALL.
/EVENT=
Cancel effect of the command
SET TRACE/EVENT=event-name [expression[, expression...]]
Format:
CANCEL TRACE/EVENT=event-name [expression[, expression...]]
The event-name keyword and expression parameter(s) cancel the
tracepoint(s) which was set with the same keyword and expression
parameter. If the expression parameter was omitted on the SET
command, the expression parameter should also be omitted on the
CANCEL command.
/EXCEPTION
Cancel effect of SET TRACE/EXCEPTION.
/INSTRUCTION
Cancel effect of SET TRACE/INSTRUCTION or SET
TRACE/INSTRUCTION=(opcode-list).
/LINE
Cancel effect of SET TRACE/LINE.
/PREDEFINED
Cancels a specified predefined tracepoint without affecting any
user defined tracepoints. When used with /ALL, cancels all
predefined tracepoints.
/TERMINATING
Cancels the effect of a previous SET TRACE/TERMINATING command.
/USER
Cancels a specified user defined tracepoint without affecting any
predefined tracepoints. When used with /ALL, cancels all user
defined tracepoints. CANCEL BREAK/USER is assumed by default
unless you specify /PREDEFINED.
TYPE
Cancels the debugger override type established by the SET
TYPE/OVERRIDE command, thus setting the current override type to
"none."
As a result of the CANCEL TYPE/OVERRIDE command, program entities
are interpreted in compiler-generated types or in the default
type.
Format:
CANCEL TYPE/OVERRIDE
Additional information available:
Qualifiers
Additional information available:
/OVERRIDE
Must be specified. The minimum abbreviation is /OVERR.
WATCH
Cancels the specified watchpoint(s).
If you specify an address-expression as a parameter, the
watchpoint at the location denoted by that address-expression is
canceled. If you specify /ALL, all watchpoints are canceled.
Format:
CANCEL WATCH [/qualifier]
[address-expression [,address-expression...]]
Examples:
DBG> SET WATCH A[1] DO (SHOW CALLS)
DBG> CANCEL WATCH A[1] ! Cancels effect of above
DBG> CANCEL WATCH/ALL ! Cancels all watchpoints
Additional information available:
Parameters
address-expression
Specifies the location of the watchpoint to be canceled.
Qualifiers
Additional information available:
/ALL
Specifies that all watchpoints be canceled.
WINDOW
Cancels one or more specified screen window definitions or
cancels all such definitions. You must specify the names of the
screen windows to be cancelled or the /ALL qualifier, but not
both. When a screen window definition is cancelled, the
corresponding window name is no longer available for use in
DISPLAY or SET DISPLAY commands. The command does not affect any
existing screen displays.
Format:
CANCEL WINDOW [/ALL] [wind-name [,wind-name...]]
Example:
CANCEL WINDOW Q1,Q2
Additional information available:
Parameters
wind-name
The name of a screen window to be cancelled.
Qualifiers
Additional information available:
/ALL
Specifies that all screen window definitions be cancelled. Note
that this cancels all predefined as well as user-defined window
definitions.