DBG$HELP.HLB  —  DEBUG  ACTIVATE  TRACE
    Activates a tracepoint that you have previously set and then
    deactivated.

    Format

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

1  –  Parameters 

 address-expression

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

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

2.2    /ALL 

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

2.3    /BRANCH 

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

2.4    /CALL 

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

2.5    /EVENT 

       /EVENT=event-name

    Activates 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 

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

2.7    /INSTRUCTION 

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

2.8    /LINE 

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

2.9    /PREDEFINED 

    Activates a specified predefined tracepoint without affecting
    any user-defined tracepoints. When used with /ALL, activates all
    predefined tracepoints.

2.10    /TERMINATING 

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

2.11    /USER 

    Activates a specified user-defined tracepoint without affecting
    any predefined tracepoints. To activate all user-defined
    tracepoints, use the /ALL qualifier.

3  –  Description 

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

    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).

    You can activate and deactivate user-defined tracepoints or
    predefined tracepoints or both. To check if a tracepoint is
    activated, use the SHOW TRACE command.

    Related commands:

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

4  –  Examples 

    1.DBG> ACTIVATE TRACE MAIN\LOOP+10

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

    2.DBG> ACTIVATE TRACE/ALL

      This command activates all user-defined tracepoints.
Close Help