LAN Configuration and Management Manual

SCF Commands for the SLSA Subsystem
LAN Configuration and Management Manual—520469-012
4-143
TRACE PIF Command
COUNT count
specifies the number of trace records to be captured. count is an integer in the
range -1 through 32767. If COUNT is omitted or if count equals -1, records are
accumulated until the trace is stopped.
LOCKSIZE locksize
designates how much memory space, in units of pages, is locked down at one
time. LOCKSIZE can be specified only when a trace is initiated. locksize is an
integer in the range 4 through 1024. locksize must be less than or equal to pages.
If PAGES is not specified, locksize must be less than or equal to 64. If LOCKSIZE
is omitted, locksize is the lesser of pages or 64.
NOCOLL
specifies that trace data from the extended segment is written to the disk file
specified in TO file-spec 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 stopped automatically. You
don’t 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 if 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, which is 8 bytes, is
not included in size. If RECSIZE is omitted or if size equals 0, the default value of
120 bytes is assumed.