SCF Reference Manual for J-Series and H-Series RVUs

SCF Commands
SCF Reference Manual for J-Series and H-Series RVUs—529649-003
5-125
TRACE Command
TRACE Command
The TRACE command requests the capture of target-defined data items, alters trace
parameters, and ends tracing.
The SCP process produces a trace file that can be displayed using the commands
available in the PTrace program. The PTrace program is described in the PTrace
Reference Manual or in the SCF reference manual for your particular subsystem. Use
of SCF trace by a subsystem is optional; a subsystem can supply its own tracing or
diagnostics method.
This command is sensitive.
OUT file-spec
causes any SCF output generated for this command to be directed to the specified
file. The variable file-spec is defined on page 5-9.
object-spec
designates the objects to be traced. The variable object-spec is defined on
page 5-2. If object-spec is omitted, the assumed object is traced. (See
ASSUME Command on page 5-36.)
STOP [ , BACKUP ]
discontinues the trace currently in progress on the primary process. If BACKUP is
specified along with STOP, only the backup process trace is stopped.
TO file-spec
specifies that a new trace is to be started and names the file to receive the trace
information. An old file of that name is purged of data before the trace is initiated.
If file-spec does not exist, SCF creates the file with an extent size based on the
value of the PAGES parameter. The file-spec variable is defined on page 5-9.
TRACE [ / OUT file-spec / ] [ object-spec ]
{ , STOP [ , BACKUP ] }
{ TO file-spec [,LOCKSIZE pages ][,NOCOLL][,PAGES pages ]}
{ , trace-option [ , trace-option ] … }
trace-option is:
{ BACKUP }
{ BULKIO | NOBULKIO }
{ COUNT count }
{ NOPREALLOCATE | PREALLOCATE } …
{ RECSIZE size }
{ SELECT select-spec }
{ WRAP }