LAN Configuration and Management Manual

SCF Commands for the SLSA Subsystem
LAN Configuration and Management Manual—520469-012
4-140
TRACE PIF Command
segment are written to the disk file and the trace is stopped automatically. You
do not need to issue a separate TRACE command 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.
The NOCOLL option cannot be used with the BULKIO option.
PAGES pages
designates how much space, in units of pages, is allocated in the extended data
segment used for tracing. PAGES can be specified only when a trace is being
initiated. pages is an integer in the range 4 through 1024 or is equal to 0. If PAGES
is omitted or pages equals 0, the default value of 64 pages is assumed.
RECSIZE size
specifies the length of the data in the trace-data records. size is an integer in the
range 16 through 4050, and 0. The length of the trace header (8 bytes) is not
included in size. If RECSIZE is omitted or if size equals 0, the default value of 120
bytes is assumed.
SELECT select-spec
select-spec is one of the following specifications:
{ keyword }
{ ( keyword [ , keyword ] ) }
{ number }
{ ( number [ , number ] ) }
keyword
is subsystem-specific. See Table 4-5
for the list of keywords that can be
used with PIF objects.
number
is the numeric value that a keyword represents. See Table 4-5 for the list of
numbers that can be used for the PIF objects.
TO file-spec
specifies the file to which trace information is to be written. The file might have
been previously created as an unstructured file using file code 830. An old file is
purged of data before the trace is initiated. If the file does not exist, a file is created
with an extent size based upon the number of PAGES specified.
WRAP
specifies that when the trace disk file end-of-file (EOF) mark is reached, trace data
wraps around to the beginning of the file and overwrites any data there.