Expand Configuration and Management Manual (G06.24+)

Tracing
Expand Configuration and Management Manual—523347-008
16-5
PTrace Command Overview
PTrace Command Overview
When you are using the PTrace facility, consider the following:
•
You have not been provided trace-format information to read these formats
because you do not have the source code. Therefore, when reporting problems,
select the ALL option available in the SCF TRACE command.
•
You should always specify the source disk file using the PTrace FROM command
before any other PTrace command.
•
Use the SELECT and FILTER commands to format and print a subset of the
records that have been traced.
When using PTrace commands, remember that the SELECT and FILTER commands
establish criteria against which records are compared. Records that match are
formatted and displayed; those that do not are ignored. The FIND, NEXT, and
RECORD commands determine the range of records in the currently opened trace file
that will be examined.
Table 16-1 briefly describes commands that are useful when formatting Expand trace
records using the PTrace facility.
For details about the PTrace facility, refer to the PTrace Reference Manual. The
remainder of this section describes the commands that are of particular interest to
persons tracing Expand information.
Table 16-1. PTrace Commands Summary
Command Description
FILTER Prevents the selected types of information within a record from being displayed
or printed to the output device.
FIND Searches the trace records sent from the disk file for the specified string.
FROM Opens the specified trace disk file.
HEX Displays or prints the data portion of the trace record in hexadecimal.
LABEL Formats state machine entries, frames, packets, message headers, and data.
NEXT Specifies the number of records or specifies a time after which records are to
be displayed or printed.
OCTAL Displays or prints the data portion of the trace record in octal.
OUT Directs the trace records to a line printer or a spooler.
RECORD Prints records within the specified range or prints all records.
SELECT Selects records by type to be sent to the output device.