Exchange/SNA Manual

TRACE Command
Exchange/SNA Commands
3–70 104700 Tandem Computers Incorporated
CY[CLES] cycles
specifies the maximum number of cycles that you want to allow. The trace is
stopped automatically when the writing of blocks has cycled through the trace
file the number of times you specify here. For example, if you specify one, the
trace stops as soon as the trace file fills up. If you specify six, the trace stops
after the writing of blocks has cycled through the trace file six times.
Regardless of how many cycles you specify, only the maximum number of the
most recent blocks are in the trace file; the older blocks are written over as the
writing cycles through the trace file.
If you omit this parameter, there is no limit to the number of times the writing
will cycle through the trace file. In this case, you must stop the trace either
with the TRACE STOP command or the STOP command, which stops the
trace server as well as the line server.
EX[TENT] size
specifies the size, in pages, of the primary extent and the secondary extents.
This number determines the size of the trace file, which is the extent size times
16 (the maximum number of extents). The maximum extent size is 65535.
If you omit this parameter, the default extent size is 2 (for a trace file size of 2 x
16 x 2K, or 64K, bytes).
ST[OP]
stops the trace operation and the trace server.
Considerations The TRACE command starts and stops the Exchange/SNA trace server, which logs the
activity on the data communications line. Before you can use the TRACE command,
the command interpreter must be connected to the line server. For information on
establishing the connection, see the CONNECT command earlier in this section.
To prevent the loss of TRACE records, the TRACE process runs at one priority higher
than the LINE process. However, if the LINE process is running at the maximum
priority of 199, the TRACE process also runs at that priority.
To list the contents of the trace file, use the DUMP command, which is described
earlier in this section.
Examples 1. This example shows the use of the TRACE command to start the trace server.
>TRACE to trfile
SNCI32 TRACE INITIATED IN CPU 7, PIN 46, PROCESS NAME IS '$Z931'
2. This example shows the use of the TRACE command to stop the trace server.
>trace stop
SNCI35 TRACE PROCESS '$Z931' HAS BEEN STOPPED