Starting and stopping a trace dynamically using NetSpool operator commands

You can enter a NetSpool operator command to start or stop NetSpool tracing after NetSpool has started. If tracing is already started, you can also start tracing additional printer LUs or selectively stop printer LUs that are being traced. Once a trace has started for NetSpool program control or for a printer LU, its trace options cannot be modified. If you need to change the trace options for a specific printer LU, you must stop the trace for that printer and start it again.

To start tracing, enter the MVS™ MODIFY command and options:

F jobname.identifier,TRACE ON
[,TYPE=FULL | INTERNAL]
[,LUNAME=ALL | (lu-name1[,lu-name2...])]
[,PAGECOUNT=nnn ]

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 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.

To start NetSpool full tracing for the program control and LUPRT101 and LUPRT102, enter the MVS MODIFY command, as in this example:

F jobname.identifier,TRACE ON,TYPE=FULL,LUNAME=(LUPRT101,LUPRT102),PAGECOUNT=4

To stop a NetSpool trace, enter the MVS MODIFY command:

F jobname.identifier,TRACE OFF[,LUNAME=ALL | (lu-name1[,lu-name2...])]

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

Specifies the printer LUs for which tracing is to be stopped. If LUNAME is not specified, all NetSpool tracing is stopped.

ALL

Requests tracing is to be stopped for all NetSpool printer LUs defined in the Printer Inventory. Tracing for program control continues.

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

Requests tracing is to be stopped for specific NetSpool printer LUs defined in the Printer Inventory.

To stop NetSpool full tracing for the program control and LUPRT101 and LUPRT102, enter the MVS MODIFY command, as in this example:

F jobname.identifier,TRACE OFF,LUNAME=LUPRT101,LUPRT102

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

F jobname.identifier,DISPLAY TRACE

For example, to display the tracing status of the program control and printer LUPRT101, enter:

F jobname.identifier,DISPLAY LUPRT101