$S TRACE(nn)

Function

To activate the specified trace identifiers.

Syntax


>>-$S--TRace--+-nn--+------------+-------------------+---------><
              |     '- ---+-nn-+-'                   |   
              |           '-*--'                     |   
              |    .-,--------------------------.    |   
              |    V                            |    |   
              '-(------+-nn-+--+------------+---+--)-'   
                       '-*--'  '- ---+-nn-+-'            
                                     '-*--'

Parameters

nn: The subscript that defines the activated trace IDs. The subscript might specify a specific trace ID or a range of trace IDs. The range of trace IDs reserved by IBM® is 1 to 47. Trace IDs 48 to 255 are available for customer use. For more information about specific identifier meanings, see z/OS JES2 Diagnosis, GA32-0993.

Authority Required

This command requires system authority. The description of the $T RDRnn command explains how to ensure that the authority of the appropriate MVS™ system command group is assigned.

This command requires control security access authority. For a description of assigning command input authority, see z/OS JES2 Initialization and Tuning Guide, SA32-0991.

Processing Considerations

Each trace ID may be started independent of the overall trace facility. However, no tracing is done unless the trace facility is also started. See the description of the TRACE facility and the TRACEDEF initialization statement in z/OS JES2 Initialization and Tuning Reference, SA32-0992 for information about starting the trace facility.
The trace table entries are added to JES2 trace tables as they are generated. These tables are reused if trace logging is not in effect. If trace logging is enabled, then full trace tables are formatted and added to the JES2 event trace log.

Scope

Single member. This command will be in effect for this member only.

However, you might want this command to be applied to all members of the MAS (to ensure a consistent environment across the MAS). If so, you can use the MVS ROUTE *ALL command to issue this command to all active members (if the JES2 command character is the same on all members). See z/OS MVS System Commands, SA38-0666 for more information on using the ROUTE *ALL command.

Messages

The $HASP667 message displays the current status of the specified trace IDs.

Example

 1   $s trace(1-3)

  $HASP667 TRACE(1) START=YES
  $HASP667 TRACE(2) START=YES
  $HASP667 TRACE(3) START=YES

JES2 activates trace identifiers 1, 2, and 3.