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