SNAX Connection Manager (SNAX/CM) Manual

TRACE Command
SNAX/CM Commands
097842 Tandem Computers Incorporated 3–37
TRACE Command The SNAX/CM TRACE command is used to trace connection manager activities to a
trace file on disk or to stop a previously activated trace. The SNAX/CM trace file
allocates 32 pages (with 2,048 bytes per page) in a wrap-around disk trace file; the
maximum record size is 120 bytes, and longer records are truncated. To format a trace,
use the PTrace utility.
SNAX/CM creates a trace file if one does not already exist. If the user creates a trace
file before starting a trace, the file code for that trace file must be set to 830. All trace
record types are recorded.
Note Use the SCF TRACE command to trace SNAX/XF lines over X.25 or Token-Ring networks.
The syntax for the SNAX/CM TRACE command is as follows:
TR[ACE] { TO trace-file | STOP }
return : (OUTFILE)
Returned Display for TRACE TO trace-file :
TRACE STARTED SUCCESSFULLY
(or)
TRACE START FAILED, GUARDIAN ERROR: fe-error
Returned Display for TRACE STOP:
TRACE STOPPED SUCCESSFULLY
(or)
TRACE NOT STOPPED: NO TRACE ACTIVE
return : ($RECEIVE)
STRUCT Common^Reply(*);
BEGIN
INT RC;
INT Ferror;
END;
return : (OUTFILE)
if received from the IN file, SNAX/CM replies to the OUT file with one of the text
messages shown above. See Appendix B for detailed descriptions of error
messages.
return : ($RECEIVE)
if received from the $RECEIVE file, SNAX/CM returns a structured buffer defined
above. See Appendix B for detailed descriptions of return codes and error
messages.