Envoy Configuration and Management Manual

Envoy Configuration and Management Manual—429861-001
6-1
6
Tracing
This section describes the PTrace interface, command syntax, and fields of sample trace
records. This section includes the following topics:
•
A brief description of PTrace
•
How to record and display trace data
•
How PTrace determines the subsystem
•
Subsystem-specific PTrace commands and any special considerations for using these
commands with the subsystem
•
SELECT keywords, enumerated values, mask bits (if applicable), and keyword
description
•
Sample formatted trace-record displays
Topics described in this section include the following:
•
About PTrace on page 6-1
•
Recording and Displaying Trace Data on page 6-2
•
Determining the Subsystem on page 6-3
•
PTrace Commands on page 6-3
•
Trace Examples on page 6-10
About PTrace
The PTrace (print trace) utility formats data that is stored in unstructured trace files for
output to terminals, printers, and disk files. Trace files contain records of the
communications between processes.
Using PTrace, you can interpret information about processing activity collected from
processes and lines. This information can be used for troubleshooting.
Information for PTrace can be collected in one of the following ways:
•
Interactively, with the SCF (Subsystem Control Facility) trace facility
•
Programatically, with a management programming application that uses the same
trace facility as SCF
Each subsystem varies as to what is recorded and the amount of detail that is included.
The information produced by a trace facility is stored in an unstructured Guardian 90
file. The PTrace program formats information from this file into a format that you can
examine. The formatted information can be sent to a terminal, a printer, or a disk file.
This manual and the Envoy Application Programming Manual include only the PTrace
specifics for the Envoy subsystem. For more information about PTrace, see the PTrace
Reference Manual.