Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

ALL

BREAK

DISPLAY

EXCEPTION BREAK

IMAGE

MODE

MODULE

RADIX

SCOPE

SOURCE

TRACE

TYPE

WATCH

WINDOW

Parameters

Parameters

Qualifiers

/ALL

/BRANCH

/CALL

/EVENT

/EXCEPTION

/INSTRUCTION

/LINE

Parameters

Qualifiers

/ALL

Parameters

Qualifiers

/ALL

/NORELATED

/RELATED

Qualifiers

/OVERRIDE

Qualifiers

/MODULE

/EDIT

Parameters

Qualifiers

/ALL

/BRANCH

/CALL

/EVENT

/EXCEPTION

/INSTRUCTION

/LINE

Qualifiers

/OVERRIDE

Parameters

Qualifiers

/ALL

Parameters

Qualifiers

/ALL

DEBUG CANCEL — VMS 5.1-B

     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

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:

ParametersQualifiers

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 undoing 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:

ParametersQualifiers

Parameters

 disp_name

     The name of a screen display to be cancelled.

Qualifiers

Additional information available:

/ALL

/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:

ParametersQualifiers

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/NORELATED/RELATED

/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

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

Qualifiers

Additional information available:

/MODULE/EDIT

/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:

ParametersQualifiers

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 undoing 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

Qualifiers

Additional information available:

/OVERRIDE

/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:

ParametersQualifiers

Parameters

 address-expression

     Specifies the location of the watchpoint to be canceled.

Qualifiers

Additional information available:

/ALL

/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:

ParametersQualifiers

Parameters

 wind-name

     The name of a screen window to be cancelled.

Qualifiers

Additional information available:

/ALL

/ALL

     Specifies that all screen window definitions be cancelled.   Note
     that  this  cancels all predefined as well as user-defined window
     definitions.

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026