Envoy ACP/XF Configuration and Management Manual
Subsystem Control Facility (SCF) Commands for
EnvoyACP/XF
EnvoyACP/XF Configuration and Management Manual—429232-003
5-38
TRACE Command
PAGES pages
designates how much memory space, in units of pages (2,048 bytes), is allocated
in the extended data segment used for tracing. The value of pages must be an
integer in the range 4 through 32766. If PAGES is omitted, the extended data-
segment size is set to 64 pages.
RECSIZE sizes
specifies the length of the data in the trace-data records. Byte length is an integer
in the range 16 through 4,050 or equal to 0 (zero). The length of the trace header
(eight bytes) is not included in byte length. If you omit RECSIZE or if byte count
equals 0, the default value of 120 bytes is assumed.
WRAP
specifies that trace records written to the disk file named in TO file-spec are to
be wrapped when the file becomes full. You can specify this option only when the
trace is being initiated—that is, when you specify the TO option.
If you do not specify WRAP, tracing stops when the disk file becomes full. Note that
the WRAP option applies only to the disk file; within the extended data segment,
trace records are always wrapped when the extended data segment becomes full.
The operation of wrapping when WRAP is specified depends on whether NOCOLL
is specified.
If you specify NOCOLL along with WRAP when the trace is started, then when the
trace is stopped and a wrap has occurred within the extended data segment, the
trace data from the beginning of the extended data segment to the last record
placed in the segment is written to the disk file.
SELECT select-name
specifies the type of record to be traced. select-name is a keyword. Keywords
identify individual or multiple trace-record types for EnvoyACP/XF. The mask is a
32-bit number in octal or hexadecimal, such as: %37777777777 (a 32-bit octal
number) or %HFFFFFFFF (32-bit hex number).
SELECT Keywords:
Option Meaning
ALL Trace all items
L0 Operator messages
L1 LCB Trace
L2 Level-2 state machine
L3 Level-3 state machine
L4 Level-4 state machine