Function

To specify the JES2 trace environment characteristics.

Parameters

ACTIVE={No|Yes}

Specifies whether JES2 is to start the trace facility.

LOG=

Specifies the characteristics for the trace facility log processor.

CLASS=c

The output class (A-Z, 0-9) of the trace log data set.

SIZE=nnnnnnnnnn

The maximum size, in bytes (100-2147483647), of the trace log data set. When this value is reached, JES2 queues the trace log for printing.

START={No|Yes}

Specifies whether the trace log information is to be formatted and periodically added to the trace log data set. Y further specifies that when the size of the trace log data set exceeds the amount specified by the SIZE parameter, JES2 spins off the data set and queues it for printing.

SPIN

Specifies that the trace log data set is to be spun off and queued for printing. A new data set is then opened for the trace log and entries on the trace log work queue are formatted and put to the new data set. If you do not specify SPIN, no action is taken.

Note: The SPIN parameter is valid only if logging is active (for example, if LOG=(START=Y)).

TABLES=nnnn

The number (0-2500) of trace tables (PAGES x 4K bytes) that JES2 is to obtain at any one time.

If you change the number of tables requested, JES2 immediately attempts to adjust the number of trace tables by either getting trace tables (if above the old number) or releasing tables (if below the old number). If JES2 cannot lower the number of trace tables sufficiently, the normal trace logging process makes the adjustment as trace tables are formatted and written.

TABWARN=nnn

Specifies the percentage of trace tables used at which the $HASP050 message alerts the operator of a trace table shortage.

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.

Scope

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

Depending on your installation's setup, 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 $HASP698 message displays the current values of all the parameters on the TRACEDEF initialization statement.

JES2 starts the trace facility. The trace information obtained is formatted and added to the trace log data set periodically. The output class of the trace log data set is B.