Envoy Configuration and Management Manual

Tr acing
Envoy Configuration and Management Manual—429861-001
6-3
Determining the Subsystem
1. The following general description of the steps involved in recording and displaying
trace data specifies a page size of and a record size of 256.
-> TRACE LINE $ENVY1, TO MYFILE, SELECT (EVYALL) &
PAGES 64, RECSIZE 256
The PAGES option indicates that there are 64 units of space in the extended data
segment. The RECSIZE option indicates that there is a maximum of 256 bytes of
data in a trace data record.
2. Collect the trace data while you perform operations related to the problem that you
are analyzing.
3. Stop the trace with another SCF TRACE command. The following command stops
the trace on the line named $ENVY1:
-> TRACE LINE $ENVY1, STOP
4. Display the trace file with PTrace.
Run PTrace from TACL to display the trace in the file named MYFILE:
> PTRACE; FROM MYFILE
Determining the Subsystem
PTrace uses the line device type 7 to indicate the Envoy subsystem. PTrace reads this
information when it opens the trace file.
PTrace Commands
You can use PTrace commands to format trace files generated by a subsystem. This
subsection describes only those details of the PTrace commands that you use to format
the trace files generated by the Envoy subsystem.
Some PTrace commands are common to all subsystems, while other commands are
subsystem-specific. Only the subsystem-specific commands are described here; the
subsystem commands common to all subsystems are listed in Table 6-1
on page 6-3.
Table 6-1. Summary of PTrace Commands Common to All
Subsystems (page 1 of 2)
Command Description
ALLOW Specifies the number of errors or warnings permitted during the
execution of a command.
COUNT Counts the records in the trace file.
DESELECT Cancels selection criteria established by the use of the SELECT
command.
ENV (ENVironment) Displays the settings of PTrace session parameters.
EXIT Terminates a PTrace session.