PTrace Reference Manual

PTrace Reference Manual—526393-001
2-1
2 Using PTrace
This section describes how to start PTrace, how to control its input and output files,
and how to enter PTrace commands. Section 3, PTrace Commands, contains detailed
syntax and descriptions of all the commands.
PTrace formats and prints the trace files that you create with CMI, SCF, or SPI. Trace
files are unstructured and cannot be printed or displayed directly. PTrace includes
several options for displaying trace data in different formats.
You can start PTrace with the TACL or SCF RUN command or a call to the NonStop
Kernel NEWPROCESS function. The RUN command for PTrace is described in this
section. The NEWPROCESS function is described in the Guardian Procedure Errors
and Messages Manual and is not described here.
PTrace can accept input from and can direct output to a file, a terminal, or an
application process.
Starting a PTrace Session
With the RUN command, you can start PTrace either interactively or noninteractively.
Starting a Noninteractive Session
The syntax of the TACL or SCF RUN command for PTrace follows:
run-option-list
is one or more NonStop Kernel run options, as described in the TACL Reference
Manual. Although other run options are allowed, the options that have special
significance for PTrace are as follows:
IN file-name
designates the initial source for PTrace command input for a session. If IN is
omitted, the input source defaults to the input file for the TACL process through
which PTrace is initiated (usually a terminal). For more information, see Setting
the Initial Input Source on page 2-3.
Note. If you are using separate product modules or libraries contained in a subvolume, and
not with the current version of PTrace in $SYSTEM.SYSTEM, you must set the following
parameters before running PTrace:
PARAM PTRACE^PM^LOC=subvolume
PARAM PTRACE^LIB^MOVED=YES
PTRACE [ / run-option-list / ] [ ptrace-command ; ] ...