Trace options data set

The trace options data set can be either a member of a partitioned data set (PDS) or a sequential data set with these attributes:

• Record format (RECFM) of fixed block (FB)
• Logical record length (LRECL) of 80

Parameters in the trace options data set

These trace options can be specified in the trace options data set. Specify at least one trace option:

TYPE=FULL | INTERNAL

Specifies the type of trace to start. INTERNAL is the default value if TYPE is not specified.

FULL

Requests an external trace to GTF and a corresponding internal wrap trace for the program control and each printer LU specified for tracing.

INTERNAL

Requests an internal wrap trace for the program control and each printer LU specified for tracing.

LUNAME=ALL | (lu-name1[,lu-name2,...])

Specifies the printer LUs to be traced. The NetSpool program control is also traced. If LUNAME is not specified, only NetSpool program control is traced.

ALL

Requests tracing all NetSpool printer LUs defined in the Printer Inventory.

(lu-name1[,lu-name2,...])

Requests tracing specific NetSpool printer LUs defined in the Printer Inventory.

Guidelines::

1. Specify the LUNAME parameter so that additional information related to NetSpool printer LUs is traced.
2. If you know which NetSpool printer LU is failing, specify that LU name in this parameter so that the amount of trace information is limited and easier to read.
3. Tracing NetSpool printer LUs increases the above-the-16 M-line storage requirement for NetSpool. Therefore, trace only the printer LUs necessary for diagnosing the problem.

PAGECOUNT=nnn

Specifies the number of 4 K pages of storage to allocate for each internal trace table. NetSpool allocates storage for the trace tables above the 16-megabyte line. Values from 1 to 999 are valid. The default is 12 (48 K bytes) for tracing NetSpool program control and 12 for each printer LU traced if PAGECOUNT is not specified. This allocation occurs only if NetSpool tracing is active.

Use this syntax to specify the trace options in the trace options data set as specified in the TRACEOPT DD statement:

[TYPE=FULL | INTERNAL]
[,LUNAME=ALL | (lu-name1[,lu-name2...])]
[,PAGECOUNT=nnn]

For example, if you want to do full tracing of printer LUs LUPRT101 and LUPRT102, and you want the size of the internal trace storage to be 24 K for each printer LU and the NetSpool program control, specify this in the trace options data set:

TYPE=FULL,LUNAME=(LUPRT101,LUPRT102),PAGECOUNT=6

When NetSpool tracing is active, you can display the tracing status of the program control and each printer LU by entering this NetSpool command:

F jobname.identifier,DISPLAY TRACE