Document revision date: 19 July 1999
[Compaq] [Go to the documentation home page] [How to order documentation] [Help on this site] [How to contact us]
[OpenVMS documentation]

OpenVMS Debugger Manual


Previous Contents Index


CANCEL MODULE

Deletes the symbol records of a module in the current image from the run-time symbol table (RST) for that image.

Note

The current image is either the main image (by default) or the image established as the current image by a previous SET IMAGE command.

Format

CANCEL MODULE [module-name[,...]]


Parameters

module-name

Specifies the name of a module whose symbol records are deleted from the RST. Do not use the asterisk (*) wildcard character. Instead, use the /ALL qualifier. Do not specify a module name with /ALL.

Qualifiers

/ALL

Deletes the symbol records of all modules from the RST. Do not specify /[NO]RELATED with this qualifier.

/RELATED (default)

/NORELATED

(Applies to Ada programs.) Controls whether the debugger deletes from the RST the symbol records of a module that is related to a specified module through a with-clause or subunit relationship.

The CANCEL MODULE/RELATED command deletes symbol records for related modules as well as for those specified, but not for any module that is also related to another set module. The effect of CANCEL MODULE/RELATED is consistent with Ada's scope and visibility rules and depends on the actual relationship between modules. The CANCEL MODULE/NORELATED command deletes symbol records only for modules that are specified (no symbol records are deleted for related modules).


Description

Use the CANCEL MODULE command if the debugger performance has slowed down because of many modules being set. You can also use the CANCEL IMAGE command to delete the symbols of an entire image (this automatically cancels all of the modules in that image). Also, if dynamic mode is enabled (which is the default), you can disable it with the SET MODE NODYNAMIC command. As a result, the debugger does not set modules or images automatically.

The CANCEL MODULE command does not cancel any breakpoints, tracepoints, or watchpoints that are set currently. It deletes the symbolization of any breakpoints, tracepoints, or watchpoints associated with the canceled modules.

Related commands:


Examples

#1

DBG> CANCEL MODULE SUB1
      

This command deletes the symbols of module SUB1 from the RST.

#2

DBG> CANCEL MODULE/ALL
      

This command deletes the symbols of all modules from the RST.


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:


Examples

#1

DBG> CANCEL RADIX
      

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:


Example


DBG> CANCEL SCOPE
      

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 in conjunction 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:


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 SET SOURCE/EXACT command, but also affects the SET SOURCE [JONES] command.


CANCEL TRACE

Cancels a tracepoint.

Format

CANCEL TRACE [address-expression[,...]]


Parameters

address-expression

Specifies a tracepoint 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

Applies to a multiprocess debugging configuration (when DBG$PROCESS has the value MULTIPROCESS). Cancels the effect of a previous SET TRACE/ACTIVATING command.

/ALL

By default, cancels all user-defined tracepoints. When used with /PREDEFINED, it cancels all predefined tracepoints but no user-defined tracepoints. To cancel all tracepoints, use /ALL/USER/PREDEFINED.

/BRANCH

Cancels the effect of a previous SET TRACE/BRANCH command.

/CALL

Cancels the effect of a previous SET TRACE/CALL command.

/EVENT=event-name

Cancels the effect of a previous SET TRACE/EVENT=event-name command. Specify the event name (and address expression, if any) exactly as specified with the SET TRACE/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 TRACE/EXCEPTION command.

/INSTRUCTION

Cancels the effect of a previous SET TRACE/INSTRUCTION command.

/LINE

Cancels the effect of a previous SET TRACE/LINE command.

/PREDEFINED

Cancels a specified predefined tracepoint without affecting any user-defined tracepoints. When used with /ALL, it 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. This is the default unless you specify /PREDEFINED. To cancel all user-defined tracepoints, use /ALL.

/VECTOR_INSTRUCTION

(VAX only) Cancels the effect of a previous SET TRACE/VECTOR_INSTRUCTION command.

Description

Tracepoints can be user defined or predefined. User-defined tracepoints are explicitly set 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 start 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 can 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 (the default is /USER). To cancel only predefined tracepoints, specify /PREDEFINED but not /USER. To cancel both user-defined and predefined tracepoints, use CANCEL TRACE/ALL/USER/PREDEFINED.

In general, the effect of CANCEL TRACE is symmetrical with that of SET TRACE (even though SET TRACE 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 CANCEL TRACE. To cancel tracepoints 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.

To cause the debugger to temporarily ignore a tracepoint, but retain definition of the tracepoint, use the command DEACTIVATE TRACE. You can later activate the tracepoint (with ACTIVATE TRACE).

Related commands:


Examples

#1

DBG> CANCEL TRACE MAIN\LOOP+10
      

This command cancels the user-defined tracepoint at the location MAIN\LOOP+10.

#2

DBG> CANCEL TRACE/ALL
      

This command cancels all user-defined tracepoints.

#3

DBG_1> CANCEL TRACE/TERMINATING
      

This command cancels a previous SET TRACE/TERMINATING command. As a result, a user-defined tracepoint is not triggered when a process does an image exit.

#4

DBG> CANCEL TRACE/EVENT=RUN %TASK 3
      

This command cancels the tracepoint that was set to trigger when task 3 (task ID = 3) entered the RUN state.


CANCEL TYPE/OVERRIDE

Cancels the override type established by a previous SET TYPE/OVERRIDE command.

Format

CANCEL TYPE/OVERRIDE


Description

The CANCEL TYPE/OVERRIDE command sets the current override type to "none." As a result, a program location associated with a compiler-generated type is interpreted according to that type.

Related commands:


Example


DBG> CANCEL TYPE/OVERRIDE
      

This command cancels the effect of a previous SET TYPE/OVERRIDE command.


CANCEL WATCH

Cancels a watchpoint.

Format

CANCEL WATCH [address-expression[,...]]


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.

Qualifiers

/ALL

Cancels all watchpoints.

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:


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.


Previous Next Contents Index

  [Go to the documentation home page] [How to order documentation] [Help on this site] [How to contact us]  
  privacy and legal statement  
4538PRO_041.HTML