OSI/MHS SCF Reference Manual

OSI/MHS SCF Commands
OSI /MHS SCF Reference Manual—424828-001
2-209
TRACE PROCESS Command
TRACE PROCESS Command
The TRACE PROCESS command initiates, modifies, or stops a trace of the process. To
issue this command, the object must be in the STARTED state. This is a sensitive
command.
An SCF trace produces a trace file that can be displayed using the commands available
in the PTrace program. The trace file is created by SCP. You can find general
information about the PTrace program in the PTrace Reference Manual. Section 3,
Formatting Trace Files With PTrace, presents subsystem-specific information about
using PTrace with the OSI/MHS subsystem.
OUT file-spec
directs any SCF output generated for this command to the specified file.
[\psystem.]$proc.#[\gsystem.]pname
is the name of the PROCESS object you want to trace.
STOP
discontinues (stops) the trace currently in progress.
PAGES
designates how much space, in units of pages, is allocated in the extended data
segment used for tracing. PAGES can be specified only when a trace is being
initiated. PAGES is an integer in the range 4 through 64 or is equal to 0 (zero). If
PAGES is omitted or equals 0, the default value of 64 is assumed.
NOCOLL
indicates that the trace collector should not be initiated.
RECSIZE
specifies the length of the data in the trace data records. RECSIZE is an integer in
the range 16 through 4050 or is equal to 0 (zero). The length of the trace header,
TRACE [ / OUT file-spec / ]
PROCESS [\psystem.]$proc.#[\gsystem.]pname
{ , STOP }
{ [ , PAGES integer ]
[ , NOCOLL ]
[ , RECSIZE integer ]
[ , SELECT select-spec ]
[ , TO file-spec ]
[ , WRAP ]
[ , COUNT integer ] }