DEBUG CANCEL — MicroVMS 4.4
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:
ALLBREAKDISPLAYEXCEPTION BREAKIMAGEMODE
MODULERADIXSCOPESOURCETRACETYPEWATCH
WINDOW
Parameters
keyword
Specifies the item to be canceled. Keyword can be ALL, BREAK,
DISPLAY, EXCEPTION BREAK, MODE, MODULE, RADIX, SCOPE, TRACE,
WINDOW, WATCH, or TYPE/OVERR.
qualifier
Depends on the keyword specified.
parameters
Depends on the keyword specified.
ALL
Cancels all breakpoints, tracepoints, watchpoints, and restores
scope and user-set entry/display modes and types to their default
values.
CANCEL ALL does not affect the current language setting or the
modules included in the debugger symbol table.
Format:
CANCEL ALL
BREAK
Cancels a previously set breakpoint, or cancels all breakpoints
if CANCEL BREAK/ALL is specified.
You either give an address expression specifying which breakpoint
to cancel, or a qualifier specifying which breakpoint to cancel.
Format:
CANCEL BREAK [/qualifier]
[address-expression [,address-expression...]]
Examples:
DBG> SET BREAK/SILENT A\B DO (EX X)
DBG> CANCEL BREAK A\B ! Cancels effect of above breakpoint
DBG> SET BREAK/INST WHEN (A .NE. 0)
DBG> CANCEL BREAK/INST ! Cancels effect of above breakpoint
Additional information available:
Parameters
address-expression
Denotes the location of the breakpoint to be canceled. The
parameter does not have to exactly match what you specified when
you set the breakpoint; it just has to specify the same address.
Note that an address expression is not needed if a qualifier was
given. For example in CANCEL BREAK/CALL you are un-doing the
effect of a previous SET BREAK/CALL, and you do not need an
address expression.
Qualifiers
Additional information available:
/ALL/BRANCH/CALL/EVENT/EXCEPTION/INSTRUCTION
/LINE
/ALL
Cancel all breakpoints.
/BRANCH
Cancel effect of SET BREAK/BRANCH.
/CALL
Cancel effect of SET BREAK/CALL.
/EVENT
Cancel effect of the command
SET BREAK/EVENT=keyword [expression[, expression...]]
Format:
CANCEL BREAK/EVENT=keyword [expression[, expression...]]
The 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.
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.
EXCEPTION BREAK
Format:
CANCEL EXCEPTION BREAK
Cancels an exception breakpoint.
Thus the command CANCEL EXCEPTION BREAK cancels the effect of the
command SET EXCEPTION BREAK.
(CANCEL BREAK/EXCEPTION is equivalent and is the preferred syntax
since it is more consistent with the other forms of CANCEL BREAK.
The "CANCEL EXCEPTION BREAK" form remains for the sake of
compatibility with older versions of the debugger.)
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 a previously set tracepoint, or cancels all tracepoints
if CANCEL TRACE/ALL is specified.
You either give an address expression specifying which tracepoint
to cancel, or a qualifier specifying which tracepoint to cancel.
Format:
CANCEL TRACE [/qualifier]
[address-expression [,address-expression...]]
Examples:
DBG> SET TRACE X DO (SHOW CALLS)
DBG> CANCEL TRACE X ! Cancels effect of above tracepoint
DBG> SET TRACE/INST WHEN (A .NE. 0)
DBG> CANCEL TRACE/INST ! Cancels effect of above tracepoint
Additional information available:
Parameters
address-expression
Denotes the location of the tracepoint to be canceled. The
parameter does not have to exactly match what you specified when
you set the tracepoint; it just has to specify the same address.
Note that an address expression is not needed if a qualifier was
given. For example in CANCEL TRACE/CALL you are un-doing the
effect of a previous SET TRACE/CALL, and you do not need an
address expression.
Qualifiers
Additional information available:
/ALL/BRANCH/CALL/EVENT/EXCEPTION/INSTRUCTION
/LINE
/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=keyword [expression[, expression...]]
Format:
CANCEL TRACE/EVENT=keyword [expression[, expression...]]
The 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.
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.