LAN Configuration and Management Manual

SCF Commands for the SLSA Subsystem
LAN Configuration and Management Manual—520469-012
4-146
TRACE SAC Command
CPU cpu-number
specifies the CPU number from which the trace records are to be captured.
cpu-number is an integer in the range 0 through 15. You can only specify the
CPU that is on the parent SAC's ACCESSLIST, and the associated CPU must be
loaded. If the CPU attribute is not specified, the owner CPU of the SAC is traced.
If the specified CPU is down at the time the TRACE command is issued, the
system will return an error and an empty trace file will be generated.
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.
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.