Starting and restarting NJE connections automatically

The CONNECT parameter allows you to automatically start NJE connections after JES2 initialization, and restart them if they become disconnected. Specifying the CONNECT=(YES|NO|DEFAULT,interval) parameter on the APPL, LINE, and SOCKET initialization statements indicates whether (YES) or not (NO) these NJE connections will be initially started by the network resource monitor, and restarted if they become disconnected for longer than the specified time interval. The CONNECT=(YES|NO|DEFAULT,interval) parameter can also be specified with the JES2 $ADD and $T APPL, LINE, and SOCKET commands, and with the $E LINE command, to set or to modify this NJE connection attribute. The default value is CONNECT=DEFAULT.

Specifying CONNECT=DEFAULT on the APPL, LINE, and SOCKET initialization statements indicates that processing defers to the CONNECT=(YES|NO) parameter value that is specified for the associated NODE initialization statement. The APPL and SOCKET statements use the NODE= parameter to refer to their associated NODE. A line can become associated with a node in two ways:

The NODE= parameter on the LINE statement can refer to the node
The LINE= parameter on the NODE statement can refer to the line.

The NODE default value for CONNECT is NO. The JES2 $T NODE command can be used to modify the CONNECT attribute.

The APPL, LINE, NODE, and SOCKET CONNECT interval value is the approximate time, in minutes, between attempts to restart a connection. The valid range for the interval value is 0-1440 minutes. A value of 0 (default) indicates that the interval value from the NJEDEF CONNECT parameter is being used. The valid range for the NJEDEF CONNECT parameter interval value is 1-1440 minutes, and the default is 10 minutes. To prevent simultaneous connection attempts from both ends, JES2 randomly modifies the specified interval value by adding up to 45 seconds to it

The NJEDEF initialization statement CONNECT=(YES|NO,interval) parameter specifies whether (YES) or not (NO) any NJE connections will be automatically started after JES2 initialization, or restarted if they are disconnected for longer than the applicable time interval. The default value is YES. If NJEDEF CONNECT=NO is specified, the $D NJEDEF command displays COMMAND=($TNJEDEF,CONNECT=NO), and the $JDSTATUS command displays the following JES2 NOTICES:

$HASP9150 JES2 NOTICES
$HASP9173 NJE AUTOMATIC CONNECT PROCESSING DISABLED
          (NJEDEF CONNECT=NO)

When JES2 attempts to automatically start or restart an NJE connection, JES2 issues a $HASP568 message similar to the following example:

$HASP568 LNEn - AUTOMATIC CONNECT

When an automatic attempt to start or to restart a NJE connection fails, JES2 issues a $HASP569 message similar to the following example:

$HASP569 SOCKET=Sn - NO IDLE TCP/IP LINE IS AVAILABLE, RC=08
         NEXT ATTEMPT: 13 APR 2011 AT 16:05

Using the $D command to display an NJE connection (APPL, LINE, NODE, or SOCKET) that is currently disconnected will display the projected connection restart time if CONNECT=YES is defined:

CONNECT=(YES,2,2011.103,16:05)

For more information on using each initialization statement, refer to z/OS JES2 Initialization and Tuning Reference. For more information on using each command, refer to z/OS JES2 Commands.