CP6100 Configuration and Management Manual

Managing CP6100 Using the Subsystem
Control Facility (SCF)
CP6100 Configuration and Management Manual—426741-003
8-31
TRACE Command
TRACE Command
The TRACE command requests the capture of target-defined data items, alters trace
parameters, or ends tracing. TRACE is a sensitive command.
An SCF trace produces a trace file that can be displayed using PTrace commands.
The trace file is created by SCF. The PTrace utility is described in Section 9, PTrace
Facility for CP6100.
Command Syntax for the TRACE Command
The TRACE command has the following syntax:
OUT file-spec
causes any SCF output generated for this command to be directed to the specified
file.
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 SCF Reference Manual
for G-Series RVUs or SCF Reference Manual for H-Series RVUs).
STOP [ , BACKUP ]
discontinues the trace currently in progress. If you specify BACKUP, SCF stops the
trace of the backup process only.
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 ] }
{ [ , BACKUP ]
[ , COUNT count ]
[ , NOCOLL ]
[ , PAGES pages ]
[ , RECSIZE sizes ]
[ , SELECT select-spec ]
[ , TO file-spec ]
[ , WRAP ]... }