OSI/MHS SCF Reference Manual

OSI/MHS SCF Commands
OSI /MHS SCF Reference Manual—424828-001
2-206
TRACE MON Command
TRACE MON Command
The TRACE MON command initiates, modifies, or stops a trace of the MHS manager.
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
is the name of the MON 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,
which is 8 bytes, is not included in integer. If RECSIZE is omitted or equals 0,
the default value of 128 is assumed. The recommended value for RECSIZE is 4050.
TRACE [ / OUT file-spec / ] MON [\psystem.]$proc
{ , STOP }
{ [ , PAGES integer ]
[ , NOCOLL ]
[ , RECSIZE integer ]
[ , SELECT select-spec ]
[ , TO file-spec ]
[ , WRAP ]
[ , COUNT integer ] }