$S TRACE(nn) - Start a trace ID

Function

To activate the specified trace identifiers.

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.

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.

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 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 for more information on using the ROUTE *ALL command.

Messages

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