PTrace Reference Manual

PTrace Reference Manual—526393-001
vii
About This Manual
This manual describes the PTrace (print trace) utility. PTrace selects, formats, and
displays data placed in trace files by the Subsystem Control Facility (SCF),
Communications Management Interface (CMI), or the Subsystem Programmatic
Interface (SPI).
You can use the Subsystem Control Point (SCP) subsystem to create an SPI trace or
you can write a subsystem of your own through the SPI mechanism to create an SPI
trace. The PTrace commands provide a variety of options to format trace data for
different subsystems.
The PTrace process is independent of the process that creates the trace files. Thus, to
use PTrace, you do not need the hardware and software present on the system where
the trace file was created.
Audience
This manual is written for people who use trace facilities for problem determination.
This manual assumes you are familiar with SCF, CMI, or SCP and with the
subsystems that create the trace files. You should have access to the following
manuals:
•
TACL Reference Manual
•
One of these manuals on trace generation:
°
SCF Reference Manual for G-Series RVUs for systems running on a G-series
RVU and Subsystem Control Facility (SCF) Reference Manual for systems
running on a D-series RVU
°
Communications Management Interface (CMI) Operator Reference Manual
(D-series only; see the preceding note.)
°
SPI Programming Manual (for information on SPI) and the Subsystem Control
Point (SCP) Management Programming Manual (for information on SCP)
•
Documentation that pertains to the subsystems whose trace files you wish to
format
This manual does not tell you how to analyze a trace file.
Note. CMI is only used in systems running D-series RVUs with the Envoy ACP/XF, ATP6100,
CP6100, and AM6520 communications subsystems; all other subsystems use SCF. For
systems running G-series RVUs, all communications subsystems use SCF to generate trace
files.