SNAX/XF and SNAX/APN Configuration and Management Manual

SCF Commands for SNAX/XF and SNAX/APN
SNAX/XF and SNAX/APN Configuration and Management Manual—425836-006
13-131
TRACE Command
If you are starting a trace and do not specify LUSELECT, all LUs are traced. If you
are modifying an existing trace and do not specify LUSELECT, the list of selected
LUs does not change.
NOCOLL
specifies that trace data from the extended data segment is written to the disk file
specified in TO file-name only when one of the following occurs:

The trace is stopped.

The number of trace records written to the extended data segment is equal to
the count specified in the TRACE command that started the trace. When the
trace facility detects this condition, the trace records from the extended data
segment are written to the disk file and the trace is automatically stopped (a
separate TRACE command does not need to be issued to stop the trace).
If NOCOLL is not specified, a trace collector process reads the trace records from
the extended data segment and writes them to the disk file as they become
available.
This option can be specified only when the trace is being initiated—that is, when
the TO option is specified.
OFF
when specified with LUSELECT or PUSELECT, turns off selective tracing for a
specific object or a list of specific objects. For example:

The trace options LUSELECT (#LU1,#LU2), OFF and PUSELECT
(#PU1,#PU2), OFF deselect the named objects as objects for tracing.

The trace options LUSELECT ALL, OFF and PUSELECT ALL, OFF
respectively deselect all previously selected LUs and PUs as objects for
tracing.
If only some of the previously selected LUs or PUs are deselected with the OFF
option, selective tracing remains in effect for the other previously selected LUs or
PUs. However, if all of the previously selected LUs or PUs are deselected with
OFF (either by specifying ALL or by specifying all previously selected items
individually), so that the list of objects of that type to be traced is empty, the trace
reverts to capturing information for all LUs and PUs.
For example, in the first bulleted item above, if the only LUs previously selected
were #LU1 and #LU2, then the given LUSELECT option causes data for all LUs to
be traced. The option LUSELECT ALL, OFF has the same effect.
Note that specifying OFF for all objects does not stop tracing; it merely deselects
all objects that were specifically selected using LUSELECT or PUSELECT, so that
the trace reverts to capturing data for all LUs or all PUs. To stop the trace, you
must issue a TRACE LINE command with the STOP option.