Trailing-Edge
-
PDP-10 Archives
-
BB-CH23A-BM_1986
-
documentation/snt.hlp
There is 1 other file named snt.hlp in the archive. Click here to see a list.
The DECnet/SNA Gateway Trace Utility (SNT) is a program that collects
snapshots of SNA protocol message sequences and displays each message
in a readable format.
SNT has the following commands:
TRACE ANALYZE HELP EXIT PUSH TAKE
TRACE
The TRACE command initiates a protocol trace operation. A logical link
is created to the trace server on the gateway node and information
about the type of trace to be performed is passed to it. The trace
server returns trace data over the logical link where it is recorded in
a file or displayed.
Format:
TRACE node-spec:: circuit-id switches
Parameters
node-spec
Gateway node name and access control e.g. SNAGWY"USER PASSWORD"::
Note: The trace server requires the Priviledged access control that
was built into the gateway image during installation.
circuit-id
Gateway circuit specification, e.g. SDP-0.
Switches:
/ANALYZE
Causes the trace data to be formatted and recorded as ASCII data.
If /OUTPUT is not specified with this switch, the analyzed data will
be written to the terminal.
/BUFFERS:n
Specifies the number of buffers that should be used to capture data.
If this switch is not specified, the trace server on the gateway
will specify a default value.
/CHARACTER-SET:file-spec
Identifies the input file containing the EBCDIC to DEC multinational
character set (DMCS) translation table and the DMCS to EBCDIC
translation table.
If /CHARACTER-SET is not specified, the SNT software uses its own
built-in table.
If the default translation table does not meet your needs, the
DECnet-20 system manager can produce a translation table for you
by using the information provided in the DECnet/SNA TOPS-20 Gateway
Management Guide.
No wildcard characters are allowed in the file specification.
/CIRCUIT
Indicates that an SDLC circuit level trace operation is to be
performed. This switch cannot be used with the /PU switch or the
/SESSION:n switch.
/ENTRIES:n
This switch causes the trace output file to be closed after the
specified number of trace data entries has been received. The value
of n must be between 1 and 32767. If this switch is not specified,
the number of trace data entries will not be checked.
/VERSION-LIMIT:n
Specifies the maximum number of trace output files that can exist at
any point in time. An automatic purge is performed each time the
output file is opened. The value of n must be between 2 and 32767.
If /VERSION-LIMIT is not specified, only a single output file will be
maintained. Once any stopping criteria is satisfied, tracing will be
terminated.
/OUTPUT[:file-spec]
Identifies the output file for storing the collected trace data. By
default, this file receives a name of SNT and a file type of DAT.
If /ANALYZE is specified the default file type is LST.
No wildcard characters are allowed in the file specification.
/PU
Indicates that a physical unit trace operation is to be performed.
This switch cannot be used with the /CIRCUIT switch or the
/SESSION switch.
/SESSION:n
Indicates that a session level trace is to be performed. This switch
cannot be used with the /CIRCUIT switch or the /PU switch.
The value of n must be between 0 and 255.
/SIZE:n
Indicates the maximum number of message data bytes to be returned
for each trace entry. This parameter is used to reduce the amount
of trace data transmitted over the logical link and written into the
data file. The value of n must be between 0 and 32767. If this
switch is not specified, the trace server on the gateway will supply
a default value.
/WIDE
Use this switch with /ANALYZE to specify the width of the formatted
trace data. /WIDE specifies an output width of 132 columns. The
default is an output width of 80 columns.
ANALYZE
The ANALYZE command causes the information in the specified trace
data file to be formatted in a way in which it can be easily read.
Format:
ANALYZE file-spec switches
Parameters:
file-spec
Specifies the name of the trace data file to be analyzed. The
default file type is DAT.
No wildcard characters are allowed in the file specification.
Switches:
/CHARACTER-SET:file-spec
Identifies the input file containing the EBCDIC to DEC multinational
character set (DMCS) translation table and the DMCS to EBCDIC
translation table.
If /CHARACTER-SET is not specified, the SNT software uses its own
built-in table.
If the default translation table does not meet your needs, the
DECnet-20 system manager can produce a translation table for you
by using the information provided in the DECnet/SNA TOPS-20 Gateway
Management Guide.
No wildcard characters are allowed in the file specification.
/OUTPUT[:file-spec]
Identifies the output file for storing the results of the analysis.
By default, this file receives a file type of LST. If the file name
is omitted, the output is directed to a file with the name SNT.LST.
If /OUTPUT is not specified, the analyzed data is written to the
terminal.
No wildcard characters are allowed in the file specification.
/WIDE
Use this switch to specify the width of the formatted trace data.
/WIDE specifies an output width of 132 columns. The default is an
output width of 80 columns.
EXIT
The EXIT command causes the SNT utility to terminate.
PUSH
The PUSH command creates a lower TOPS-20 command level (EXEC) than
you were using while running SNT. The the TOPS-20 POP command can
be used to return back to SNT.
TAKE
The TAKE command tells the SNT utility to process SNT commands stored
in the specified file.
Format:
TAKE file-spec
No default file-spec is provided.
Switches:
/DISPLAY
This switch causes the SNT commands in the specified file to be
displayed as they are processed. The default is to not display them.