$T NJEDEF - Control JES2 network environment

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 that is used by NJE headers and trailers.

LIMIT=nnnn

The maximum number (10-9999) of NJE header and trailer cells that are 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 that is 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 user ID 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.

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.

PRECHECK=YES|NO

Indicates whether NJE jobs that are marked dubious (due to the VFYPATH or VERIFY_SUBNET specification) must pass additional verification processing before being allowed to run on the local node. The pre-check ensures that the job can pass verification without any submitter information being passed to the security product. Specifying PRECHECK=YES can result in security failures for jobs from nodes indicated as trusted in RACF (if the job is marked as dubious). These same jobs may pass verification when PRECHECK=NO is specified. This setting has no effect on jobs that are not marked dubious.

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 is 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.

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 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 that is 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.

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 time stamp, but the time does not differ from the TOD clock value by more than the TIMEtol=value, JES2 accepts the record. If the time stamp 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.

VERIFY_SUBNET=YES|NO

Specifies whether subnet path verification is done for jobs and commands arriving by way of NJE. Verification ensures that jobs and commands that claim to originate from a node within the local subnet (subnet that the local node is in) and indicate to run on a node in the local subnet arrive from an adjacent node that is also within the local subnet. Jobs that do not match this criteria are marked dubious and are subject to a validation precheck (based on the NJEDEF PRECHECK setting). Commands that do not match this criteria are rejected. This setting has no effect if the local node is not within a subnet (NODE(xx) SUBNET= is blank for the local node) and for jobs and commands that indicate they are from a node that is not in the local subnet.

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.

Scope

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

Depending on your installation's set up, 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 for more information about using the ROUTE *ALL command.

Messages

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