Function

To specify the JES2 network environment.

Parameters

CONNECT=(Yes|No,interval)

Specifies whether NJE connections for APPLs, LINEs, or SOCKETs that specify or defer to CONNECT=YES should automatically be initiated or restarted. The interval is the time (in minutes) between attempted connections. The valid range for interval is 1 to 1440.

DELAY=nnn

The maximum length of time, in seconds (10-999) that a message or command is delayed in any stage of transmission between nodes before the system assumes that possible lockout situations have occurred. When this time interval expires, the system discards messages and commands in an attempt to clear the congestion and remove the lockout situation.

HDRBUF={LIMIT|WARN}

Allows installations to control the amount of storage used by NJE headers and trailers.

LIMIT=nnnn

The maximum number (10-9999) of NJE header and trailer cells allocated at this installation for jobs and SYSOUT data received from the network.

This command can increase, but not decrease, this value.

WARN=nnn

Specifies the percentage (0-100) of NJE header and trailer cells at use in an installation. If use of NJE header and trailer cells reaches or exceeds the number specified, JES2 processing notifies the operator by issuing a $HASP050 message.

If 0 is specified, the $HASP050 message is not issued.

MAILMSG={No|Yes}

Specifies whether (YES) or not (NO) JES2 issues the $HASP549 mail notification message automatically to notify a userid that a transmitted file has arrived from another node or a spool reload procedure.

If EXIT 40 returns a code of 8 or 12, this parameter is ignored. For more information about EXIT 40, see z/OS JES2 Installation Exits, SA32-0995.

MAXHOP=nnnn

The maximum number of nodes (0-32K) a job or output can cross to reach a destination. You can determine this variable through the following algorithm: length of the system x 2 + 2. The $HASP528 message is issued when a job has exceeded this parameter. If you specify 0, no comparison is done. If you specify 32K, JES2 checks indefinitely.

NODENUM=

Specifies the maximum number (1–32767) of nodes in the NJE network to which this member belongs. This value may only be increased if all systems are at z/OS® V1R7 and NITs in CKPT.

RESTMAX=nnnnnnnn|79992000

The maximum tolerable resistance (0 to 79992000) of a connection. If the resistance of a path is greater than the value specified in RESTMAX, the path will be ignored.

Specifying lower values on this parameter tends to eliminate longer paths; use low values when a system should wait for better connections before attempting to communicate with nodes connected through inefficient paths. (For more information, see z/OS JES2 Initialization and Tuning Guide, SA32-0991.)

Note: This parameter applies to both adjacent and non-adjacent nodes.

RESTNODE=nnnn|100

Specifies the resistance (1-2000) of this node to the flow of jobs through the network. This value provides half of this node's resistance, which is combined with the resistance of node at the other end of the connection to establish a connection's total resistance.

High values of RESTNODE tend to make JES2 systems choose other paths rather than come through this system's node (see z/OS JES2 Initialization and Tuning Guide, SA32-0991 for more information).

RESTTOL=nnnn|0

The maximum difference in resistance (0-8000) allowed between the best possible path and an acceptable alternate path. This value has no meaning unless the value specified in the PATH parameter is greater than 1.

If the value of RESTTOL is greater than or equal to the minimum resistance between any two nodes within the network, jobs and messages may be transmitted throughout the network in an erratic fashion. (For more information, see z/OS JES2 Initialization and Tuning Guide, SA32-0991.)

TIMEtol=nnnn|1440

Specifies in approximate minutes the time (0 - 1500) allowed between the TOD clock of this node and any adjacent node. For example, if you specify TIMETOL=60 and an adjacent node attempts a sign on to your node with a clock that differs from yours by 60 minutes or less, the sign on is successful. If the adjacent node's clock differs from yours by significantly more than 60 minutes, the sign on fails.

You supply a TIMEtol= value (or accept the default value) so that JES2 can determine whether to accept status information about any node in the network or permit a sign-on.

During JES2 processing, if a record is received with a future timestamp, but the time does not differ from the TOD clock value by more than the TIMEtol=value, JES2 accepts the record. If the timestamp is in the future by an amount that is significantly greater than the TIMEtol= value, JES2 rejects the record. For network topology records, rejection results in the record being ignored (with an error message). For network sign on records, the sign on to the adjacent node fails.

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. The $T NODE(nnnn) command 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.

Scope

Single member. This command will be in effect for this member only.

Depending on your installation's setup, however, you might want this command to be applied to all members of the MAS (to ensure a consistent environment across the MAS). If so, you can use the MVS ROUTE *ALL command to issue this command to all active members (if the JES2 command character is the same on all members). See z/OS MVS System Commands, SA38-0666 for more information on using the ROUTE *ALL command.

Messages

The $HASP831 message displays the current values of all the parameters on the NJEDEF initialization statement.

JES2 displays that 20 cells have been allocated for building NJE header and trailer cells. JES2 will issue the $HASP050 message when 85% of these cells have been used.