ATM Configuration and Management Manual

SCF Commands
ATM Configuration and Management Manual—522307-003
4-103
TRACE PROCESS Command
keyword
is subsystem-specific. See Table 4-5 for the list of keywords that can be used
for the PROCESS objects.
number
is the numeric value that a keyword represents. See Table 4-5 for the list of
numbers that can be used for the PROCESS objects
TO file-spec
specifies the file to which 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.
Table 4-5. select-spec for a PROCESS Object
Keyword Number Meaning
ALL -1 Trace all items
SMACH 0 Trace state machines
EVT 1 Trace events
QUEUE 2 Trace internal queues
TIMER 3 Trace timer activity
MSG 4 Trace messages
INTMSG 5 Trace internally generated messages
DIH 6 Trace calls to the driver interrupt handler
routines