Parameters

NAME=

Specifies a 1-to-8 character node name. No two nodes should have the same node name. The names that can be specified are:

Node name
Home name

Note:

You cannot specify the nodenames LOCAL or ANYLOCAL or ALL. They are reserved by JES3.
See the coding considerations in Table 1 for information related to XCF group names.
If you change the TYPE parameter for a node name, you need to reroute any previously scheduled output for the node.

ALIAS=

Specifies an alias, an alternate name for the home node, such that work destined for this name is recognized as being destined for the home node.

Note:

You cannot specify the names LOCAL, or ANYLOCAL, or ALL. They are reserved by JES3.
The NAME= parameter and the ALIAS= parameter are mutually exclusive.

AUTO=

Specifies, for a directly-connected remote BSC node, whether JES3 is to automatically restart the line to the node if the remote node interrupts transmission. Specifying YES causes JES3 to automatically restart the line. If you specify NO or omit this parameter and the remote node interrupts transmission, the operator must restart the line. Code this parameter on the NJERMT statement that defines a directly-connected remote BSC node.

RDLY=

Specifies, in minutes, the amount of time that JES3 networking is to wait before it automatically restarts an interrupted line. Allowable values for mm are 0-99. Code this parameter on an NJERMT statement that defines a directly-connected remote BSC node.

BDTID=

Specifies the 1-8 character name of the MVS/BDT subsystem in your JES3 complex that is to process SNA/NJE transactions. This name must match the name specified on the MVS/BDT SYSID initialization statement.

Include this parameter only on the NJERMT statement that defines the home node. If this parameter is not included, JES3 sends SNA/NJE transactions to the default MVS/BDT subsystem that is named on the JES3 SYSID statement.

BFSIZ=

Specifies the buffer size to be used for communication with the directly-connected remote BSC node defined by this statement. The system programmer at the remote node must specify the same buffer size as you specify. Do not specify a buffer size of less than 400 bytes.

The maximum buffer size allowed is the size of the spool buffers (specified through the BUFSIZE parameter on the BUFFER statement) minus 46.

CTC=

Specifies the type of connection between the home node and the directly-connected remote BSC node defined by this statement. For a node that is connected through a channel-to-channel (CTC) adapter, specify YES. For a node that is connected through a leased line or a dial-up line, omit this parameter or specify NO. This parameter is ignored when TYPE=SNA is specified.

DEFCLASS=

Specifies whether inbound SYSOUT can be assigned a default SYSOUT class if the data set's characteristics, as specified by the sending node, do not match the characteristics of the specified SYSOUT class as defined on this, the receiving node, on the SYSOUT statement. "Characteristics" includes whether the SYSOUT is print or punch output, and whether it is held for TSO, held for external writer, or not held. This parameter is valid only when defining the home node or an alias of the home node.

DEFCLASS=YES: Indicates that default SYSOUT classes may be assigned. The PRTDEF, PUNDEF, PRTTSO, and PRTXWTR parameters can be used to specify the default classes.
DEFCLASS=NO: Indicates that default SYSOUT classes will not be assigned. The SYSOUT class specified by the sending node will be retained. The output will be held if the execution node indicated that the output should be held, or if the SYSOUT class is defined as held on the receiving node.
You might want to use DEFCLASS=NO, for example, so that you can submit jobs that produce output that is held for external writer, even if the job will execute on a non-JES3 node. If the SYSOUT class is defined on the receiving node as held for external writer, and DEFCLASS=NO is specified on the receiving node, then the output will be held.

EXPWD=

Specifies a 1-8 character password that the home node expects to receive from the directly-connected remote BSC or TCP/IP node defined by this statement. This password allows the remote node to start the line to the home node.

For the remote node to be able to send the password, the system programmer at the remote node must also specify the password by coding PWD=sendpassword1 on the NJERMT statement that defines your node. If you omit this parameter, the remote node will be able to start the line without sending a password.

EXSIG=

Specifies a 1-8 character password that the home node expects to receive from the directly-connected remote BSC node defined by this statement. This password identifies the remote node that started a dial-up line (with a dial-up line, several remote nodes can have the capability to start the same line). Once identified, the remote node can communicate with the home node.

The password, recpassword2, can be any character string. Code this password only for remote nodes that are connected to the home node by dial-up lines.

For the remote node to be able to send the password, the system programmer at the remote node must also specify the password by coding SIG=sendpassword2 on the NJERMT statement that he codes to define your node. If you omit this parameter, any remote node that can start the line to the home node will be able to communicate with the home node.

HOME=

Specifies whether this NJERMT statement defines the home node or a remote node. If it defines the home node, code YES. For all other nodes, omit this parameter or code NO.

JOBTRANS=

Specifies the number of job transmitters defined for the node. This keyword is valid only for nodes that have a type of TCPIP. The value specified must be an integer from 1-7. The sum of JOBTRANS and OUTTRANS must not exceed 8. The default is 1.

JOBRECV=

Specifies the number of job receivers defined for the node. This keyword is valid only for nodes that have a type of TCPIP. The value specified must be an integer from 1-7. The sum of JOBRECV and OUTRECV must not exceed 8. The default is 1.

LINE=

Specifies the 1-8 character name of the line that connects the home node to the directly-connected remote BSC node defined by this statement. This name must match the name specified through the JNAME parameter on the DEVICE statement that defines the line. When the operator starts the line, he can override the name you have specified with this parameter. If you omit the LINE parameter, the operator must specify a line name when starting the line.

MAXLINE=

Specifies the maximum number of lines that the operator can start to the directly-connected remote BSC node defined by this statement. For an indirectly-connected remote node or the home node, specify 0.

NETHOLD=

Specifies whether incoming NJE SYSOUT data sets that appear to be NETDATA output should always be held for a TSO user to receive (NETHOLD=YES) or should be made available for JES3 writers to process if the destination is known to JES3 as a device (NETHOLD=NO). This parameter is valid only when defining the home node by specifying HOME=YES on the initialization statement.

NJEPR=

Specifies the number (1-99) of logical network printers you want generated for the home node. Code this parameter on the NJERMT statement that defines the home node.

NJEPU=

Specifies the number (1-99) of logical network punches you want generated for the home node. Code this parameter on the NJERMT statement that defines the home node.

OUTTRANS=

Specifies the number of output transmitters defined for the node. This keyword is valid only for nodes that have a type of TCPIP. The value specified must be an integer from 1-7. The sum of JOBTRANS and OUTTRANS must not exceed 8. The default is 1.

OUTRECV=

Specifies the number of output receivers defined for the node. This keyword is valid only for nodes that have a type of TCPIP. The value specified must be an integer from 1-7. The sum of JOBRECV and OUTRECV must not exceed 8. The default is 1.

PATH=

Specifies the name of the first node in the path to an indirectly-connected node. Code this parameter on the NJERMT statement that defines the indirectly-connected node.

If you omit this parameter, JES3 networking assumes the home node and the remote node are directly connected.

PRTDEF=

Specifies the print class default for networking output received at the home node. If you omit this parameter, JES3 networking assumes print class A. This parameter is valid only when defining the home node (that is, when you also specify HOME=YES on this initialization statement) or an alias of the home node (that is, when you define the node name using the ALIAS= parameter on this initialization statement).

PRTTSO=

Specifies the TSO data set default class for networking output received at the home node. If you omit this parameter, JES3 uses the class specified on the PRTDEF parameter. This parameter is valid only when defining the home node (that is, when you also specify HOME=YES on this initialization statement) or an alias of the home node (that is, when you define the node name using the ALIAS= parameter on this initialization statement).

PRTXWTR=

Specifies the external writer data set default class for networking output received at the home node. If you omit this parameter, JES3 uses the class specified on the PRTDEF parameter. This parameter is valid only when defining the home node (that is, when you also specify HOME=YES on this initialization statement) or an alias of the home node (that is, when you define the node name using the ALIAS= parameter on this initialization statement).

PUNDEF=

Specifies the punch class default for networking output received at the home node. If you omit this parameter, JES3 networking assumes punch class B. This parameter is valid only when defining the home node (that is, when you also specify HOME=YES on this initialization statement) or an alias of the home node (that is, when you define the node name using the ALIAS= parameter on this initialization statement).

PWD=

Specifies a 1-8 character password that the home node must send to the directly-connected remote BSC or TCP/IP node defined by this statement. This password allows the home node to start the line to the remote node.

If the remote node is expecting a password and you omit this parameter or code it incorrectly, the home node will be unable to start the line. If the remote node is not expecting a password and you code this parameter, the remote node ignores the password and allows the home node to start the line.

PWCNTL=

Specifies whether you want passwords sent to the remote node encrypted (SENDENC), without encryption (SENDCLR), or verified locally (LOCALCHK). If you select password encryption, user verification is performed at the remote node only. If you select local verification, user verification is performed at the local node and no password is sent to the remote node.

JES3 uses a security product, such as RACF®, to validate job passwords for NJE. If you specify PWCNTL=LOCALCHK and RACF is not installed or it is inactive on your local node, password validation is performed only at the execution node.

RETRYCT=

Specifies the number (1-300) of attempts (retries) that a node makes to successfully transmit a buffer of data before terminating the line to a directly connected remote BSC node. The most common error detected, an adaptor timeout, takes approximately three seconds to detect (for example, if you specify a retry value of 20, JES3 will terminate the line after approximately 1 minute). Specifying a larger value allows you to maintain communication during events that can cause extensive timeouts, such as remote dumps. JES3 ignores this parameter if you specify CTC=YES.

SECSIGNON=

Specifies that a secure signon protocol will be used which uses an encryption key that is stored in the security product.

SIG=

Specifies a 1-to 8-character password that the home node must send to the directly-connected remote BSC node defined by this statement. Code this password only if the home node and the remote node are connected by a dial-up line.

If the remote node is expecting a password and you omit this parameter or code it incorrectly, the home node will be unable to communicate with the remote node. If the remote node is not expecting a password and you code this parameter, the remote node ignores the password and allows communication with the home node.

SPART=

Specifies the spool partition that JES3 is to use for inbound NJE stream. The partition name must match the partition name specified on one of the SPART statements. To accept the default spool partition for inbound NJE stream, omit this parameter. If you specify a partition name that has not been defined on an SPART statement, JES3 will ignore this parameter and use the default spool partition. If you specified an invalid subparameter, JES3 uses the parameter default. You cannot specify this parameter in alias nodes.

STREAM=

Specifies the number of concurrent data streams that JES3 networking is to transmit on one line between the home node and the directly-connected remote BSC node defined by this statement.

Note: STREAM=2 is not allowed for directly connected, remote BSC nodes, running RSCS under VM.

TLS=

Indicates whether the Transport Layer Secure facility will be used by any socket that is used to communicate with this node.

TYPE=

Specifies the networking protocol to be used for communicating with a directly-connected remote node. Include this parameter only when defining a directly-connected remote node.

BSC: Specifies a BSC networking protocol.
SNA: Specifies a SNA networking protocol.
TCPIP: Specifies a TCP/IP networking protocol.

XNAMEREQ=

Specifies whether inbound SYSOUT can be held for processing by an external writer if no external writer name was supplied by the sending node. This parameter is valid only when defining the home node or an alias of the home node.

XNAMEREQ=YES: Indicates that an external writer name must be provided for inbound SYSOUT to be held for external writer. Inbound SYSOUT with no external writer name will be put on the writer queue or held for TSO, depending on what was specified at the sending node, and may be assigned the default SYSOUT class from the PRTDEF, PUNDEF, or PRTTSO parameter.
XNAMEREQ=NO: Indicates that an external writer name is not required for inbound SYSOUT to be held for external writer. Inbound SYSOUT will be held for external writer if the SYSOUT class is defined with HOLD=EXTWTR and the sending node indicated that the output is held for external writer.

Note: The sending node must be running JES3 in order to designate the SYSOUT as held for external writer without providing an external writer name.