SCF Reference Manual for G-Series RVUs (G06.27+)

SCF Commands
SCF Reference Manual for G-Series RVUs—520413-005
5-128
TRACE Command
WRAP
specifies that when the trace file end-of-file mark is reached, trace data wraps
around to the beginning of the file and overwrites any data there. If WRAP is not
specified, the trace is stopped when the end-of-file mark is reached. You cannot
change the specification of the WRAP option during an ongoing trace.
Some subsystems may automatically select this option. Refer to the SCF
reference manual for a specific subsystem for more information about TRACE
command options.
Considerations
•
If TO file-spec is specified, a new trace is initiated unless file-spec is
invalid, the file cannot be opened, or a trace is already active for that process’s PID
(CPU, PIN).
•
If TO file-spec is omitted and STOP is specified, the TRACE command stops
the trace currently in progress.
•
If TO file-spec and STOP are both omitted, the TRACE command modifies the
trace currently in progress.
•
The parameters COUNT, RECSIZE, and SELECT can be changed during an
ongoing trace. Other trace parameters cannot be modified during an ongoing
trace.
Examples
•
The following command initiates a trace of the TLAM manager process ($ZLMG).
Trace records are written to the file $DATA.TRACE.LANMGR13.
-> TRACE PROCESS $ZLMG, TO $DATA.TRACE.LANMGR13, SELECT ALL
•
The following command stops the trace of the TLAM manager process:
-> TRACE PROCESS $ZLMG, STOP