$S N

Function

To establish an NJE connection with an adjacent node.

Syntax


>>-$S--N--+-------------+--+---------------+-------------------->
          '-,LINE--nnnn-'  '-,P=--password-'   

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

Parameters

N

Identifies this as a start networking command.

LINEnnnn

The BSC line with which this system tries to establish an NJE connection. The system attempts to sign on to the system at the other end of the specified line by sending an NJE sign-on record over the line.

Note:

If the line is currently signed on for RJE or NJE activity, this command is rejected.
Before starting networking on a line that is not dedicated, it is necessary that the line be started from both nodes using a $S LINE(nnnn) command.
To enter the password used previously, specify the $S,LINE command.
If a dedicated line exists but is drained, it will automatically be started and a connection will be attempted by the $S N,N= command.

P=password

The password (1 to 8 alphanumeric characters) used to verify the identity of the node attempting to establish the NJE connection. This password is transmitted in the sign-on record resulting from this command.

If you omit this parameter:

The password specified by the PASSWORD=(SEND= ) parameter on the NODE initialization statement (for the node to which JES2 is trying to connect) is used if you specify that nodename on the N= parameter of this command.
If there is no password specified by the PASSWORD=(SEND= ) parameter, the PASSWORD=(VERIFY= ) parameter on the NODE initialization statement (for the local node) is used.
If there is no SEND= or VERIFY= password, no password is used.

N=nodename

The 1 to 8 alphanumeric or special ($, #, or @) character name of the node through which you can begin networking.

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 the $S N command is unsuccessful, enter a $D U command to ensure that the BSC line is started. If it is not started, issue a $S LINE(nnnn) command.
- If the line is active, issue a $E LINE(nnnn) command to stop the current activity, and then reissue the $S N command.
If this also fails (having been attempted from both nodes, if necessary), drain the line from both nodes using a $P LINE(nnnn) command followed by a $E LINEnnnn command.
Then, start the line from both nodes with a $S LINE(nnnn) command (if dial-up line is used, you will have to re-dial after the $S).
Finally, enter the $S N command from one of the nodes.

Note:

Each side of the connection must assign the same password for the line used in the connection. For information about establishing a network connection, see z/OS JES2 Initialization and Tuning Guide, SA32-0991
When processing the $SN,N=nodename command, JES2 gives priority to dedicated lines, and to TCP/IP over SNA/VTAM.

Note: .

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 $HASP000 message indicates the command was accepted.

The $HASP200 message indicates the target node name is started on the specified line.

Examples

 1   $s n,line6,p=secret

  $HASP000 OK
  $HASP200 POK STARTED ON LINE6

JES2 tries to form a network connection with the node (POK) attached by line 6 with a node password of secret.

 2   $s n,n=wsc

         ┌─────┐                     ┌─────┐
         │ POK │                     │ WSC │
         └─────┘                     └─────┘

  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=017                    LINE21  UNIT=017

  -------------------------------------------------------
  ...                                 $SLNE21
  $SN,N=WSC                           ...

The $S N command is entered from NODE(POK) to begin networking. POK's initialization deck has LINE20 dedicated to node(2) or WSC. Since the node has a dedicated line, the line is automatically started and POK initiates signon processing to establish a connection.

Note: If POK's initialization deck did not dedicate LINE20 to WSC, a $SLINE20 would be needed to start the line before $SN,N=WSC can be issued.