AM3270 and TR3271 Configuration and Management Manual

PTrace for AM3270 and TR3271
AM3270 and TR3271 Configuration and Management Manual—529993-001
7-2
Recording and Displaying Trace Data
display and examine the trace files. The PTrace program formats the data stored in the
unstructured trace files for output to terminals, printers, or disk files. Figure 7-1 shows
the four general steps involved in recording and displaying trace data.
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. The TRACE command 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 $AM1,
and puts the result of the trace in a file called “MYFILE.”
TRACE LINE $AM1,TO MYFILE,SELECT (CLIPL2) &
PAGES 64, RECSIZE 2000
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 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 $AM1:
TRACE LINE $AM1, STOP
4. Display the trace file with PTrace.
Run PTrace from TACL to display the trace in the file named “MYFILE”:
PTRACE FROM MYFILE
Figure 7-1. Recording and Displaying Trace Data
VST007.vsd
Display the trace
file with P Trace.
Stop the trace ith
the SCF TRACE
command.
Collect trace data.
Start the trace with
the SCF TRACE
command.