LAN Configuration and Management Manual

SCF Commands for the SLSA Subsystem
LAN Configuration and Management Manual—520469-012
4-139
TRACE PIF Command
PIF pif-name
is the name of the PIF.
STOP
discontinues the trace currently in progress.
BULKIO | NOBULKIO
designates whether TRACE should use bulk I/O for tracing. BULKIO specifies that
the TRACE collector use bulk I/O to write data to the disk file, reducing the number
of missing frame errors reported by PTrace.
A limitation of BULKIO is that only one user can access the file at a time. If shared
access of the trace file is needed while the trace is active, specify NOBULKIO.
Bulk I/O tracing is faster and should eliminate most data loss. The default is
BULKIO. BULKIO cannot be used with NOCOLL.
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.
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