LAN Configuration and Management Manual

SCF Commands for the SLSA Subsystem
LAN Configuration and Management Manual—520469-012
4-145
TRACE SAC Command
TRACE SAC Command
The TRACE SAC command traces the SAC object in a processor. The TRACE
operation can significantly increase the LAN DIH use of the processor; therefore, use
the TRACE SAC command with caution. This is a sensitive command.
Command Syntax
OUT file-spec
causes any SCF output generated for this command to be directed to the specified
file.
SAC sac-name
is the name of the SAC.
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.
TRACE [ /OUT file-spec/ ] SAC sac-name
{ , STOP }
{ [ , BULKIO | NOBULKIO ]
[ , COUNT count ]
[ , CPU cpu-number ]
[ , LOCKSIZE locksize ]
[ , NOCOLL ]
[ , PAGES pages ]
[ , RECSIZE size ]
[ , SELECT select-spec ]
[ , TO file-spec ]
[ , WRAP ]}