ATM Configuration and Management Manual

SCF Commands
ATM Configuration and Management Manual—522307-003
4-104
TRACE SUBSYS Command
Example
This example starts a trace for all traceable items in $AM1:
-> TRACE PROCESS $AM1, STOP
TRACE SUBSYS Command
The TRACE SUBSYS command initiates a trace on the SUBSYS object.
Command Syntax
OUT file-spec
causes any SCF output generated for this command to be directed to the specified
file.
SUBSYS subsys-name
specifies the SUBSYS for which a trace is to be initiated.
STOP
discontinues the trace currently in progress. If BACKUP is specified, only the
backup process trace is stopped.
BULKIO | NOBULKIO
designates whether or not 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, thus
reducing the number of missing frame errors reported by PTRACE.
A limitation of Bulk I/O 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, NOBULKIO should be
specified. Bulk I/O tracing is faster and should eliminate most data loss. The
default is BULKIO. BULKIO cannot be used with NOCOLL.
TRACE [/OUT file-spec/ ] SUBSYS subsys-name
{ , STOP [ , BACKUP }
{ , [ , BACKUP ]
{ , [ , BULKIO | NOBULKIO ]
[ , COUNT count ]
[ , LOCKSIZE locksize ]
[ , NOCOLL ]
[ , PAGES pages ]
[ , RECSIZE size ]
[ , SELECT select-spec ]
[ , TO file-spec ]
[ , WRAP ] ... }