Displays information about tracepoints.

    Format

      SHOW TRACE

1  –  Qualifiers

1.1    /PREDEFINED

    Displays information about predefined tracepoints.

1.2    /USER

    Displays information about user-defined tracepoints.

2  –  Description

    The SHOW TRACE command displays information about tracepoints
    that are currently set, including any options such as WHEN or DO
    clauses, /AFTER counts, and so on, and whether the tracepoints
    are deactivated.

    By default, SHOW TRACE displays information about both user-
    defined and predefined tracepoints (if any). This is equivalent
    to entering the SHOW TRACE/USER/PREDEFINED command. User-defined
    tracepoints are set with the SET TRACE command. Predefined
    tracepoints are set automatically when you start the debugger,
    and they depend on the type of program you are debugging.

    If you established a tracepoint using SET TRACE/AFTER:n, the SHOW
    TRACE command displays the current value of the decimal integer
    n, that is, the originally specified integer value minus 1 for
    each time the tracepoint location was reached. (The debugger
    decrements n each time the tracepoint location is reached until
    the value of n is 0, at which time the debugger takes trace
    action.)

    On Alpha systems, the SHOW TRACE command does not display
    individual instructions when the trace is on a particular class
    of instruction (as with SET TRACE/CALL or SET TRACE/RETURN).

    Related commands:

       (ACTIVATE, DEACTIVATE, SET, CANCEL) TRACE

3  –  Examples

    1.DBG> SHOW TRACE
      tracepoint at routine CALC\MULT
      tracepoint on calls:
              RET     RSB     BSBB    JSB     BSBW    CALLG   CALLS
      DBG>

      In this VAX example, the SHOW TRACE command identifies all
      tracepoints that are currently set. This example indicates
      user-defined tracepoints that are triggered whenever execution
      reaches routine MULT in module CALC or one of the instructions
      RET, RSB, BSBB, JSB, BSBW, CALLG, or CALLS.

    2.all> SHOW TRACE/PREDEFINED
      predefined tracepoint on program activation
       DO (SET DISP/DYN/REM/SIZE:64/PROC SRC_ AT H1 SOURCE
              (EXAM/SOURCE .%SOURCE_SCOPE\%PC);
          SET DISP/DYN/REM/SIZE:64/PROC INST_ AT H1 INST
              (EXAM/INSTRUCTION .0\%PC))
      predefined tracepoint on program termination
      all>

      This command identifies the predefined tracepoints that are
      currently set. The example shows the predefined tracepoints
      that are set automatically by the debugger for a multiprocess
      program. The tracepoint on program activation triggers whenever
      a new process comes under debugger control. The DO clause
      creates a process-specific source display named SRC_n and a
      process-specific instruction display named INST_n whenever a
      process activation tracepoint is triggered. The tracepoint on
      program termination triggers whenever a process does an image
      exit.