X25AM Configuration and Management Manual

PTrace for the X25AM Subsystem
X25AM Configuration and Management Manual—523424-004
6-8
Creating a Sample Trace File
Creating a Sample Trace File
You can trace a line while it is running. In most cases, you probably do not need to
stop a line to create a useful trace file. The example below selects only levels 3 and 4.
If you do not wish to stop the line, you can use the following SCF command:
-> TRACE $ldev, TO filename, SELECT (L3,L4)
If you have a particular problem, you will probably want to recreate it and make a
sample trace file. For example, if you have a problem when you start a line, you can
use the following steps to stop the line, start it again, and create a useful trace file:
1. Stop the line. The following command stops the line named $X25P1:
-> STOP LINE $x25p1
2. Start the line. The following command starts the line named $X25P1:
-> START LINE $x25p1
3. Start the trace with the SCF TRACE command and specify SELECT ALL, SPACE
64, WRAP. The WRAP option specifies that when the trace file end-of-file mark is
reached, trace data wraps around to the beginning of the file and overwrites any
data there. The following command starts a trace on the line named $SP1:
-> TRACE LINE $x25p1, TO filename, SELECT ALL, PAGES 64, WRAP
4. Wait for the X25AM line-ready console message.
5. Add a PTP subdevice suitable for use with X3PAD, as in the following example:
-> ADD SU $x25p1.#ptp, PROTOCOL PTP, DEVTYPE (9,0), &
-> RECSIZE 80, RPOA (125, 300, 5000)
6. Use X3PAD to place a call, send a few data packets, and then clear the call.
7. Stop the trace. The following command stops the trace on the line named $SP1:
-> TRACE LINE $x25p1, STOP
8. Use PTrace to format and display the trace records.
Reading X25AM Traces
The X25AM traces that you capture using the SCF TRACE command can be read
using PTrace. A trace can collect a significant amount of data, which requires sorting
before you can find the problem. Several options are available to you to make the job
easier, such as the PTrace SELECT command (described earlier in this section) and
the FIND command, described below.