Envoy Configuration and Management Manual

Subsystem Control Facility (SCF) Commands for
Envoy
Envoy Configuration and Management Manual—429861-001
5-51
TRACE LINE Command
TRACE LINE Command
The TRACE command initiates, modifies, or terminates the trace mode on an Envoy
line. Using the TRACE command, you can request the capture of target-defined data
items, alter trace parameters, and end tracing. This is a sensitive command.
An SCF trace produces a trace file that you can display using the commands available in
the PTrace program. SCP creates the trace file. For more information on using PTrace to
interpret a trace file, see Section 6, Tracing
.
The command syntax is as follows:
OUT file-spec
causes any SCF output generated for this command to be directed to the specified
file. The file-spec must be a partially or fully qualified Guardian 90 file name. If this
option is not specified, the output is sent to the home terminal.
LINE line-name
designates the line to be traced. If you omit line-name, SCF traces the assumed line
(for information about the ASSUME command, see the Section , SCF Reference
Manual for G-Series Releases).
STOP
discontinues the trace currently in progress.
BACKUP
specifies that the backup process should receive the trace request. The object must
be running as a process pair if you use this syntax. If the primary process is being
traced when a takeover by the backup process occurs, the trace of the process
continues. However, in this case, most events being traced before the process switch
are no longer traced because the process being traced is no longer the primary
process. If you omit BACKUP, SCF assumes the primary process.
TRACE [ / OUT file-spec / ] [ LINE line-name ]
{ , STOP [ , BACKUP ] }
{ {, trace-option}... }
trace-option is:
{ BACKUP }
{ COUNT count }
{ NOCOLL }
{ PAGES pages }
{ RECSIZE size }
{ SELECT select-spec }
{ TO file-spec }
{ WRAP }