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

142 Chapter6
MPE Commands
SNACONTROL START
SNACONTROL START
Starts an SNA node, link-level tracing, and SNA Transport node
tracing.
Syntax
SNACONTROL START;NODE= NodeName
[;LINKTRACE[=[ TraceType ][, TraceFile ]]]
[;NODETRACE[= TraceFile ]]
[;ERROPT= ErrorOption ]
[;TFILESIZE= NumRecords ]
Use
SNACONTROL START 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 configured
SNA node you want to start. The name can be up to
eight alphanumeric characters long; the first character
must be alphabetic.
If only one SNA node is configured, this parameter is
optional: If you do not include it, the configured node is
started. If
more than one node is configured, this
parameter is required: If you do not include it, a list of
all configured nodes is displayed, but no node is started;
you can then reissue this command with the
appropriate node name.
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. Note that standard MPE
file naming conventions apply, with one exception:
When link-level tracing is started with this command
(SNACONTROL START), its file must be written to the SYS
account. If you specify an account other than SYS, an