AM3270 and TR3271 Configuration and Management Manual

AM3270 and TR3271 Configuration and Management Manual—529993-001
7-1
7 PTrace for AM3270 and TR3271
This section describes the PTrace interface, command syntax, and fields of sample
trace records. This section includes:
•
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, and mask bits (if applicable)
•
Sample, formatted, trace-record displays
About PTrace
The print trace (PTrace) 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, lines, and subdevices. 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
•
programmatically, 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 NonStop
Kernel 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 section only includes the PTrace specifics for the AM3270 and TR3271
subsystems. For more information about the PTrace utility, see the PTrace Reference
Manual.
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