/sys$common/syshlp/DBG$HELP.HLB  —  DEBUG  DEACTIVATE  TRACE
    Deactivates a tracepoint, which you can later activate.

    Format

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

1  –  Parameters

 address-expression

    Specifies a tracepoint to be deactivated. 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.

2  –  Qualifiers

2.1    /ACTIVATING

    Deactivates a tracepoint established with a previous SET
    TRACE/ACTIVATING command.

2.2    /ALL

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

2.3    /BRANCH

    Deactivates a tracepoint established with a previous SET
    TRACE/BRANCH command.

2.4    /CALL

    Deactivates a tracepoint established with a previous SET
    TRACE/CALL command.

2.5    /EVENT

       /EVENT=event-name

    Deactivates a tracepoint established with 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.

2.6    /EXCEPTION

    Deactivates a tracepoint established with a previous SET
    TRACE/EXCEPTION command.

2.7    /INSTRUCTION

    Deactivates a tracepoint established with a previous SET
    TRACE/INSTRUCTION command.

2.8    /LINE

    Deactivates a tracepoint established with a previous SET
    TRACE/LINE command.

2.9    /PREDEFINED

    Deactivates a specified predefined tracepoint without affecting
    any user-defined tracepoints. When used with /ALL, it deactivates
    all predefined tracepoints.

2.10    /TERMINATING

    Deactivates a tracepoint established with a previous SET
    TRACE/TERMINATING command.

2.11    /USER

    Deactivates a specified user-defined tracepoint without affecting
    any predefined tracepoints. When used with /ALL, it deactivates
    all user-defined tracepoints. The /USER qualifier is the default
    unless you specify /PREDEFINED.

3  –  Description

    User-defined tracepoints are activated when you set them with
    the SET TRACE command. Predefined tracepoints are activated by
    default. Use the DEACTIVATE TRACE command to deactivate one or
    more tracepoints.

    If you deactivate a tracepoint, the debugger ignores the
    tracepoint during program execution. To activate a deactivated
    tracepoint, use the ACTIVATE TRACE command. You can activate and
    deactivate user-defined and predefined tracepoints separately.
    Activating and deactivating tracepoints enables you to run and
    rerun your program with or without tracepoints without having to
    cancel and then reset them. By default, the RERUN command saves
    the current state of all tracepoints (activated or deactivated).

    To check if a tracepoint is deactivated, use the SHOW TRACE
    command.

    Related commands:

       CANCEL ALL
       RERUN
       (SET,SHOW) EVENT_FACILITY
       (SET,SHOW,CANCEL,ACTIVATE) TRACE

4  –  Examples

    1.DBG> DEACTIVATE TRACE MAIN\LOOP+10

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

    2.DBG> DEACTIVATE TRACE/ALL

      This command deactivates all user-defined tracepoints.
Close Help