The TRACE command initiates a protocol trace operation.  TRACE passes
 information about the type of trace operation to the Gateway or VMS/SNA
 trace server.  Trace data is returned to the TRACE program where it is
 recorded in a file or displayed.

 You must specify the /OLD_VERSION qualifier with the TRACE command for
 DECnet/SNA Gateway V1.3 or earlier.

 The TRACE command shows protocol sequences exchanged on circuit, physical
 unit, and session levels.  The physical unit level trace is used by
 default, if you do not specify a level.

 FORMAT:

     TRACE node-spec[::] component-id

Additional information available:

ParametersQualifiers

 node-spec

   For Gateway nodes, the node-spec is the node name of the Gateway
   followed by a privileged user name and password (you must provide
   these with the TRACE command).

   For VMS/SNA nodes, the node-spec must be "0".

 component-id

   The identification of the component to be traced.  The format of
   this parameter depends on the type of the trace operation requested
   and on the hardware and software configuration involved.  See the
   following table:

        +-----------------------+----------+----------+----------+
        | Software product name | /CIRCUIT | /PU      | /SESSION |
        +-----------------------+----------+----------+----------+
        | VMS/SNA               | SNA-0    | SNA-0    | SNA-0.m  |
        | DECnet/SNA Gateway    | LC-n     | LC-n     | LC-n.m   |
        | DECnet/SNA Gateway-ST | SDLC-n   | SNA-n    | SNA-n.m  |
        | DECnet/SNA Gateway-CT | CHAN-n   | SNA-n    | SNA-n.m  |
        +-----------------------+----------+----------+----------+

 If you enter the TRACE command without specifying any parameters or
 qualifiers, you are prompted for a node-id and a component-id.  In
 response to the component-id prompt, enter a circuit identification,
 session identification, or a PU identification, together with the
 relevant qualifier.

Additional information available:

/ANALYZE/BUFFERS/CHARACTER_SET/CIRCUIT/ENTRIES/OLD_VERSION
/OUTPUT/PU/SESSION/SIZE/VERSION_LIMIT/WIDE

 /NOANALYZE (D)
 The /ANALYZE qualifier formats and records trace data as ASCII data
 (data that is not analyzed is recorded in binary form).

 Since this qualifier causes additional processing overhead during a
 trace operation, it may result in the loss of trace data if SNATRACE
 is unable to keep up with the rate at which data is being generated.
 Digital therefore recommends you analyze the data after it is
 captured, using the ANALYZE command instead of this qualifier.

 If you do not specify /OUTPUT with /ANALYZE, the analyzed data is
 written to SYS$OUTPUT.

 This qualifier lets you specify how many buffers will be available
 for the trace server to receive data.  If you receive "trace data
 lost" errors, you should allocate more buffers.

 You can use this qualifier to identify the input file containing the
 EBCDIC to Digital Multinational Character Set (DMCS) translation
 table and the DMCS-to-EBCDIC translation table.

 If /CHARACTER_SET is not specified, the SNATRACE software uses the
 default translation table from file SYS$LIBRARY:SNATRADEF.TBL, if it
 exists.  Otherwise, it uses its own table.

 If you specify /CHARACTER_SET=ORIGINAL, SNATRACE will use its own
 table even if the SNATRADEF.TBL file is present.

 No wildcard characters are allowed in the file specification.

 This qualifier specifies a circuit-level trace.  A circuit trace
 shows the operation of the data link protocol.

 You cannot use this qualifier with either /PU or /SESSION.

 This qualifier closes the trace output file after the specified
 number of trace data entries has been received.  The value of n must
 be between the range of 1 to 32767.  If /VERSION_LIMIT qualifier is
 specified, a new output file is opened.

 If you do not specify this qualifier, an entry counter is not
 maintained, and trace data written to the specified file until
 SNATRACE is stopped by entering CTRL/C.

 This qualifier forces the SNATRACE software to use the V1 protocol.
 /OLD_VERSION should only be used to trace Gateway V1.3 or earlier.
 These versions of the Gateway are not capable of selecting the
 appropriate protocol version automatically.

 This qualifier identifies a file that will contain the trace data
 sent by the trace server.  The file-spec is a standard VMS file
 specification.

 If you do not specify a file name and file extension in the
 file-spec, the default SNATRACE.DAT is used.  (If you specify
 /ANALYZE in the command line, .LIS is the default extension.) You can
 also leave out the directory and device name.  If you do, the TRACE
 command uses your current default device and directory.  You cannot
 enter wildcard characters in the file specification.

 This qualifier specifies a physical unit trace.  This trace is the
 default if you do not specify any trace level in the command line.

 You cannot use this qualifier with either the /CIRCUIT or the
 /SESSION qualifiers.

 Indicates that a session level trace is to be performed.

 This qualifier cannot be used with the /CIRCUIT qualifier or the /PU
 qualifier.

 This qualifier indicates the maximum number of RU data bytes to be
 returned for each trace entry.  (LH, TH, and RH header sizes will be
 added to this number where appropriate.) /SIZE reduces the amount of
 trace data transmitted over the logical link and written to the data
 file.  The value of n must be in the range of 0 to 32767.  The
 default is 256.

 This qualifier specifies the maximum number of trace output files
 that can exist at once.  If /VERSION_LIMIT is specified, the files
 are purged each time the output file is opened.  The value n must be
 in the range of 2 to 32767.  If you do not specify this qualifier,
 only a single output file is opened.

 /NOWIDE  (D)

 This qualifier is used with /ANALYZE to specify the width of the
 formatted trace data.  If you specify /WIDE, the output data has a
 width of 132 columns.

 /NOWIDE is the default.  For /NOWIDE, the width is always 80 columns.