Envoy Configuration and Management Manual

Tr acing

Envoy Configuration and Management Manual—429861-001

6-2

Recording and Displaying Trace Data

Trace files contain a record of the communications between processes. Each subsystem

determines what information is recorded in its trace files. The type of events recorded,

the amount of detail, and the subsystem-specific parameters may vary.

You generate a trace file using the SCF TRACE command. The trace files that SCF

creates are unstructured and cannot be printed or displayed directly. You use PTrace to

display and examine the trace files. The PTrace program formats the data stored in the

unstructured trace files for output to terminals, printers, or disk files. Figure 6-1

shows

the four general steps involved in recording and displaying trace data.

Figure 6-1. Recording and Displaying Trace Data

Notes. The default RECSIZE of 120 is not sufficient for Envoy trace records. Use a RECSIZE

of 256 when starting a trace.

The trace file size is limited to 70K bytes on disk. When the file is full, trace will automatically

be stopped. The WRAP option allows the trace records to wrap around in the file. Specify

WRAP if the data is expected to go over 70K bytes.

CDT028.CDD

Start the Trace

with the SCF

TRACE command

Stop the Trace

with the SCF

TRACE command

Display the Trace

with PTrace

Collect Trace data