IPX/SPX Configuration and Management Manual

NonStop™ IPX/SPX PTrace Facility
IPX/SPX Configuration and Management Manual—425731-001
4-4
Device Type and Subtype
In the following example, the TACL RUN command instructs PTrace to read its
commands from a file called PTRACE.FIRSTRUN and to write its display output to a
file called PTRACE.FIRSTOUT. The NOWAIT option allows TACL to resume control
of the session while PTrace is executing.
PTRACE /IN PTRACE.FIRSTRUN, OUT PTRACE.FIRSTOUT, NOWAIT/
Starting an Interactive PTrace Session
To start PTrace interactively, enter PTRACE at the TACL or SCF prompt. PTrace
displays its product banner, followed by its prompt, the question mark (?). When you see
the prompt, you can begin entering PTrace commands. When you are finished using
PTrace, type EXIT to return to the TACL or SCF prompt.
Device Type and Subtype
When a trace file is created, the type and subtype of the device being traced are recorded
in the file. When PTrace opens the trace file, it uses this information to determine for
which subsystem it is formatting records.
The device type and subtype for the IPXMGR process are 19 and 0, respectively. The
device type and subtype for the IPXPROTO process are 19 and 1, respectively.
PTrace Commands
PTrace commands provide options for selecting trace records for display, so you can
suppress those records that do not relate to the problem you are investigating. The
PTrace commands also provide options for specifying the way in which the trace records
are formatted.
PTrace provides a common set of commands for displaying trace records; however, not
all PTrace commands are supported by all subsystems.
The PTrace code consists of two modules. The first module contains the code shared by
all subsystems; the second contains the additional, subsystem-specific code that actually
displays the PTrace records. Thus, those commands implemented by the first PTrace
module are supported by all subsystems: ALLOW, COUNT, ENV, FC, EXIT, FIND,
FROM, HELP, LIMIT, LOG, NEXT, OBEY, OUT, PAGESIZE, RECORD, and RESET.
Those additional commands implemented by the subsystem-specific PTrace modules
vary from subsystem to subsystem. Of the commands that fall into the subsystem-
dependent category, the NonStop™ IPX/SPX subsystem supports the following:
HEX
LABEL
OCTAL
SELECT
The following PTrace commands are not supported:
DETAIL
EBCDIC
FILTER