HP 3000 Manuals

SNACONTROL STOP [ SNA Link/iX Node Manager's Guide ] MPE/iX 5.0 Documentation


SNA Link/iX Node Manager's Guide

SNACONTROL STOP 

Stops an SNA node and all activity on the node.

Syntax 

SNACONTROL STOP;NODE=NodeName[;TYPE=StopType]

Use 

SNACONTROL STOP 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 you want to stop.  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 active node
                    is stopped.  If more than one node is active, this
                    parameter is required:  If you do not include it, a
                    list of all configured SNA nodes is displayed, but no
                    node is stopped; you can then reissue this command
                    with the appropriate node name.

StopType            How SNA Transport is to stop the node:

                       *   K = (Kill) The node is stopped immediately.
                           To the users of the node, this is like a link
                           failure.  The remote system is not notified
                           that SNA Transport is stopping.

                           _____________________________________________ 

                           CAUTION  Data can be lost in a kill shutdown.

                           _____________________________________________ 

                       *   P = (Protocol) SNA Transport notifies the SNA
                           services that it is stopping.  Each service
                           interrupts sending and receiving all active
                           data sets, and tries to stop the LU-LU
                           sessions.  SNA Transport then stops the
                           LU-SSCP sessions and the PU-SSCP session, but
                           it does not stop the node until all SNA
                           Transport users have terminated their
                           sessions.

                       *   Q = (Quiesce) The node is stopped in an
                           orderly way.  SNA Transport notifies the SNA
                           services that it is stopping.  Each service
                           completes sending and receiving all active
                           data sets.  As the LUs become inactive, the
                           services stop the LU-LU sessions, and SNA
                           Transport stops the LU-SSCP sessions.  Then,
                           SNA Transport shuts down the PU-SSCP session.

                    Default:  Q

Description 

SNACONTROL STOP stops an SNA node and all activity on the node:
link-level tracing, SNA Transport intrinsic tracing, SNA Transport node
tracing, and any SNA services that are running (and their associated
tracing).  Once all sessions are closed, a logging message is generated
and SNA Transport begins releasing its resources.  When all resources are
released, SNA Transport logs a "SHUTDOWN COMPLETE" message and
terminates.

Examples 

SNACONTROL STOP;NODE=PU8100F

Node PU8100F is to be stopped in an orderly way (a quiesce).  A quiesce
is done because no StopType was specified.

SNACONTROL STOP;TYPE=K

The only active node is to be immediately stopped (a kill).  Note that if
more than one node was active, this command would not be valid:  A list
of configured nodes would be displayed, and the command would have to be
reissued with the proper NODE=NodeName parameter included.



MPE/iX 5.0 Documentation