$S N - Start node communication on an SNA line
Function
To start an SNA application-to-application session with another node and to automatically start dedicated lines.
Syntax
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.
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.
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
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=,