Asynchronous Terminals and Printer Processes Configuration and Management Manual

PTrace Facility for ATP6100
Asynchronous Terminals and Printer Processes Configuration and Management Manual—424280-003
7-3
Determining the Subsystem
The following general description of the steps involved in recording and displaying
trace data selects CLIP level-2 trace information.
1. Start the trace with the SCF TRACE command, which allows you to specify
parameters such as the size of the trace records and the name and maximum size
of the trace file. The command that follows traces the line $ATPL1 and puts the
result of the trace in a file called MYFILE.
TRACE LINE $ATPL1,TO MYFILE,SELECT (CLIPL2) &
PAGES 64, RECSIZE 2000
PAGES indicates 64 units of space in the extended data segment. The RECSIZE
option indicates a maximum of 2000 bytes of data in a trace data record.
2. Collect 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 $ATPL1:
TRACE LINE $ATPL1, 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 to indicate the ATP6100 subsystem. PTrace reads
this information when it opens the trace file.
The device type for ATP6100 is 53. The only valid subtype is 0.
PTrace Commands
You 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 ATP6100 subsystem.
Some PTrace commands are common to all subsystems while other commands are
subsystem-specific. The subsystem commands common to all subsystems are listed in
Table 7-1
on page 7-4; only the subsystem-specific commands are described later in
this section.