$S N

Function

To start an SNA application-to-application session with another node and to automatically start dedicated lines.

Syntax


>>-$S--N--+-------------+--+---------------+-------------------->
          '-,LINE--nnnn-'  '-,A=--applname-'   

>--+---------------+-------------------------------------------><
   '-,N=--nodename-'

Parameters

N: Identifies this as a start networking command.
LINEnnnn: The started logical line that is used for the application-to-application session. The physical SDLC line(s) involved are managed by VTAM® and the Network Control Program (NCP). If you omit this parameter, JES2 will select an SNA logical line from a pool of available, idle SNA logical lines. At least one SNA line must be available to establish an SNA session. If you specify a currently-used or drained line, the command is rejected. If a line has been dedicated to this application, (LINE= on the APPL statement) or to this node (LINE= on the NODE statement) it will be automatically started and an SNA connection will be established.
A=applname: The name of the application with which an SNA application-to-application session is started. This name corresponds to the APPLID= value on the LOGON(1) initialization statement at the node with which a session is desired.
Note: When a $SN is applid qualified and the applid is not defined but happens to be a known node name, it dynamically adds the applid and then tries to start the connection with that applid.
N=nodename: The 1 to 8 alphanumeric or special ($, #, or @) character name of the node used to start networking. Use an APPLID= associated with node or dynamically create an application with this nodename.

Authority Required

This command requires system authority. The description of the $T RDRnn command explains how to ensure that the authority of the appropriate MVS™ system command group is assigned. $T NODE(nnnn) sets the command authority for a node.

This command requires control security access authority. For a description of assigning command input authority, see z/OS JES2 Initialization and Tuning Guide, SA32-0991.

Processing Considerations

If a node is a multi-access spool node, each member of that node must be uniquely defined as an application to VTAM and the application names used must be defined to JES2 with APPL initialization statements. APPL initialization statements must be supplied at every node in the network that may initiate SNA sessions with these applications.
When processing the $SN,N=nodename command, JES2 gives priority to dedicated lines, and to TCP/IP over SNA/VTAM.

Scope

Single member. This command will be in effect for this member only. There is no need to have this command issued to all members of the MAS.

Note: All the members of the MAS are connected to that node.

Messages

The $HASP200 message indicates that the NJE node at which this SNA session is requested has correctly identified itself to this JES2 system.

Examples

 1   $s n,a=wsc

  $HASP200 POK STARTED ON LINE15   SESSION DENVER

This JES2 system tries to initiate an SNA application-to-application session with the application defined to JES2 and VTAM as DENVER.

        NJEDEF OWNNODE=1                    NJEDEF OWNNODE=2
        NODE(1) NAME=POK                    NODE(1) NAME=POK,
        NODE(2) NAME=WSC,                           LINE=21
                LINE=20                     NODE(2) NAME=WSC
        LINE20  UNIT=SNA                    LINE21  UNIT=SNA
        APPL(POK) NODE=1                    APPL(WSC) NODE=2,
        LOGON1 APPL=POK                     LOGON1 APPL=WSC
      -------------------------------------------------------

        $SLOGON1                            ...
        ...                                 $SLOGON1
        $SN,N=WSC                           ...

At NODE(POK), $SN searches for an APPL that is assigned to node 2. If none is found, APPL(WSC) is created. NODE(WSC) points to LINE20, which is automatically started. The node password is automatically obtained from NODE(WSC).

At NODE(WSC), HASPSNA searches for an APPL assigned to node 1. If none is found, APPL(POK) is created. NODE(POK) points to LINE21, which is automatically started.

 2   $SN,A=XXXXXX where WASHDC is not defined as applid, but is a valid node name.

$HASP000 OK
$HASP094 I/O ERROR ON LNE37    SNA ,17,0000,

The $SN fails because the applid is not known

087D0001,141001000000002484800000,XXXXXX
$DAPPL(XXXXXX)
$HASP821 APPL(XXXXXX) 240
$HASP821 APPL(XXXXXX)    NODE=38,COMPACT=0,LINE=0,LOGMODE=,