Cancels a watchpoint.
Format
CANCEL WATCH [address-expression[, . . . ]]
1 – Parameters
address-expression
Specifies a watchpoint to be canceled. With high-level languages,
this is typically the name of a variable. Do not use the asterisk
(*) wildcard character. Instead, use the /ALL qualifier. Do not
specify an address expression with /ALL.
2 – Qualifiers
2.1 /ALL
Cancels all watchpoints.
3 – Description
The effect of the CANCEL WATCH command is symmetrical with the
effect of the SET WATCH command. To cancel a watchpoint that was
established at a specific location with the SET WATCH command,
specify that same location with CANCEL WATCH. Thus, to cancel
a watchpoint that was set on an entire aggregate, specify the
aggregate in the CANCEL WATCH command; to cancel a watchpoint
that was set on one element of an aggregate, specify that element
in the CANCEL WATCH command.
The CANCEL ALL command also cancels all watchpoints.
To cause the debugger to temporarily ignore a watchpoint, but
not delete the definition of the watchpoint, use the command
DEACTIVATE WATCH. You can later activate the watchpoint (with
ACTIVATE WATCH).
Related commands:
(ACTIVATE,DEACTIVATE,SET,SHOW) WATCH
CANCEL ALL
(SET,SHOW,CANCEL) BREAK
(SET,SHOW,CANCEL) TRACE
4 – Examples
1.DBG> CANCEL WATCH SUB2\TOTAL
This command cancels the watchpoint at variable TOTAL in module
SUB2.
2.DBG> CANCEL WATCH/ALL
This command cancels all watchpoints you have set.