ATM Configuration and Management Manual

SCF Commands
ATM Configuration and Management Manual—522307-003
4-106
TRACE SUBSYS Command
{ number }
{ ( number [ , number ] ... ) }
keyword
is subsystem-specific. See Table 4-4 on page 4-100 for the list of keywords
that can be used for the ADAPTER objects.
number
is the numeric value that a keyword represents. See Table 4-4 on page 4-100
for the list of numbers that can be used for the ADAPTER objects.
TO file-spec
specifies the file to which the trace information is to be written. The file might have
been previously created as an unstructured file with file code 830. An old file is
purged of data before the trace is initiated. If the file does not exist, a file is created
with an extent size based upon the number of PAGES specified.
WRAP
specifies that when the trace disk file end-of-file mark is reached, trace data wraps
around to the beginning of the file and overwrites any data there.
Considerations
•
If TO file-spec is specified, a new trace is initiated unless the file-spec is
invalid, the file cannot be opened, or trace is already active for the IOP.
•
If TO file-spec and STOP are both omitted, the TRACE command modifies the
trace currently in progress, if any.
•
If TO file-spec is omitted and STOP is specified, the TRACE command stops the
trace currently in progress, if any.
•
The parameters COUNT, RECSIZE, and SELECT can be changed during an
ongoing trace. Other trace parameters cannot be modified during an ongoing trace.
Example
This example starts a trace for all traceable items in $ZZATM.
-> TRACE SUBSYS $ZZATM, BACKUP, STOP
Table 4-6. select-spec for a SUBSYS Object
Keyword Number Meaning
ALL
-1 Trace all items