SNA Link/iX Node Managers Guide (30291-90009)

164 Chapter6
MPE Commands
SNACONTROL TRACEON
SNACONTROL TRACEON
Turns on link-level tracing, SNA Transport intrinsic tracing, and SNA
Transport node tracing.
Syntax
SNACONTROL TRACEON;NODE =NodeName
[;LINKTRACE[=[ TraceType ][, TraceFile ]]]
[;INTRINSIC= LUName [, TraceFile ]]
[;NODETRACE[= TraceFile ]]
[;TFILESIZE= NumRecords ]
Use
SNACONTROL TRACEON can be issued from a session, a job, a program, or
in break. Pressing
[BREAK] has no effect on this command.
Parameters
NodeName Conditionally required. The name of the active SNA
node for which you want to turn tracing on. The name
can be up to eight alphanumeric characters long; the
first character must be alphabetic.
If only one SNA node is active, this parameter is
optional: If you do not include it, the specified tracing
for the active node is turned on. If
more than one node
is active, this parameter is required: If you do not
include it, an error message is displayed and no tracing
is started.
TraceType The kind of link-level tracing to be started:
• FULL = Full line tracing: All of the bytes of each link
frame are traced.
• PARTIAL = Partial line tracing: Only the first 16
bytes of each link frame are traced.
Default: PARTIAL
TraceFile The name of the disk file that is to contain the trace
data. This must be a valid MPE file name or fully
qualified MPE file reference. Standard MPE file
naming conventions apply.
If you specify a file that does not exist, NMS builds a
new one and opens it to record tracing. If you specify an
existing file that NMS does not currently have open to
record tracing, NMS will overwrite the file’s previous