Envoy ACP/XF Configuration and Management Manual

Subsystem Control Facility (SCF) Commands for
EnvoyACP/XF
EnvoyACP/XF Configuration and Management Manual—429232-003
5-37
TRACE Command
TRACE Command
The TRACE command is a sensitive command that initiates trace mode on the
specified object. You can use traces as diagnostic tools.
OUT file-spec
causes any SCF output generated for this command to go to the specified file.
file-spec must be a partially or fully qualified file name. If you do not specify this
option, the output goes to the home terminal.
object-name
is the name of the line to be traced. If omitted, the assumed line is traced.
STOP
discontinues the trace currently in progress.
BCOUNT count
specifies the maximum trace records to be collected.
NOCOLL
specifies that trace data from the extended data segment is written to the disk file
specified in TO file-spec only when one of the following occurs:
•
The trace is stopped.
•
The number of trace records written to the extended data segment equals the
count specified in the TRACE command. In this case, the extended data-
segment trace records are written to the disk file and the trace is automatically
stopped.
If NOCOLL is not specified, a trace-collector process reads the trace records from
the extended data segment and writes them to the disk file as they become
available. You can specify this option only when the trace is being initiated—that is,
when you specify the TO option.
TRACE [ / OUT file-spec / ] LINE object-name
{ , STOP [ , BACKUP ] }
{ [ , COUNT count ]
[ , NOCOLL ]
[ , PAGES pages ]
[ , RECSIZE sizes ]
[ , SELECT select-name ]
[ , WRAP ]
, TO file-spec }