IPX/SPX Configuration and Management Manual

NonStop™ IPX/SPX PTrace Facility
IPX/SPX Configuration and Management Manual—425731-001
4-2
Recording and Displaying Trace Data
Recording and Displaying Trace Data
This subsection describes the steps involved in recording and displaying trace data.
1. To start the trace interactively, issue the SCF TRACE command:
•
This example specifies an IPXPROTO process that has a record size of 1024:
TRACE PROCESS $ZNV0, TO MYFILE, &
SELECT (MSGSYSIF, SOCKETIF, IPXIF), RECSIZE 1024
•
This example specifies an IPXMGR process that has a record size of 512 and a
page size of 100:
TRACE SUBSYS $ZMGR, TO MYFILE1, &
SELECT (SPIPROC, FILEIO), RECSIZE 512, PAGES 100
PAGES indicates that there are 100 units of space in the extended data segment.
RECSIZE indicates that there are a maximum of 512 bytes of data in an IPXMGR
trace data record and 1024 bytes of data in an IPXPROTO trace data record.
2. Collect the trace data while you perform operations related to the problem that you
are analyzing.
3. Stop the trace by issuing another SCF TRACE command. The following commands
stop the traces for the IPXPROTO process named $ZNV0 and the IPXMGR process
named $ZMGR:
TRACE PROCESS $ZNV0, STOP
TRACE SUBSYS $ZMGR, STOP
4. Display the trace file by using PTrace.
Run PTrace from TACL to display the traces in the files MYFILE and MYFILE1:
PTRACE FROM MYFILE
PTRACE FROM MYFILE1
For additional information on using PTrace, refer to the PTrace Reference Manual.
In addition to using the NonStop™ IPX/SPX trace facility, you may need to trace the
activities of the lower layers to solve some problems. You also may need to use the QIO
trace facility or the SLSA trace facility.
Notes. The default record size (RECSIZE) of 120 bytes is too small to show the complete
IPX/SPX data on a trace record. When starting a trace for an IPXPROTO process, use a
RECSIZE of 1024 bytes. For the IPXMGR process, use a RECSIZE of 512 bytes.
The default trace file size is 128 KB on disk. When the file is full, tracing automatically stops.
The SCF TRACE command WRAP option allows the trace records to wrap around in the file.
Increase the trace file size by increasing the value in the PAGES option of the SCF TRACE
command.