Configuring JES2

BARR/NJE

Configure MVS/JES2 to add an NJE node for Barr. You must also define lines and streams for the node. Later we will test to make sure the NJE node has been configured correctly.

For SNA connections, after you configure JES2 and configure the SNA gateway, you have the option of configuring the NJE auto-start feature.

See also:


Adding a BARR/NJE node

Define the BARR/NJE node to JES2 by adding another NODE and APPL Application program. macro An instruction in a source language that points to a sequence of instructions in the same language to replace it. in SYS1.PARMLIB(JES2PARM). The following JES2 NJE definition contains statements your host programmer must enter for each Barr node. More advanced macros and parameters are documented in IBM's OS/390: JES2 Initialization and Tuning Reference.

For a Barr SNA or SNA connection

NODE(n)
APPL(luname)

NAME=nodename,PATHMGR=NO
NODE=n

For a CTC connection

NODE(n)

NAME=nodename,PATHMGR=NO,LINE=i

Parameter

Description

NODE(n)

Replace n with the node number.

NAME=nodename

Replace nodename with the BARR/NJE node name. This is the value the BARR/NJE node will be identified as on your NJE network. It is used for routing, messages, and JCL. This value is also the Barr node name specified when you configure BARR/NJE for Barr SNA, SNA, or CTC.

PATHMGR=NO

The Barr NJE node does not support the JES2 Path Manager protocol.

APPL(luname)

Replace luname with the NJE LU name specified during VTAM configuration. This must also match the NJE LU name specified when configuring BARR/NJE for Barr SNA or SNA and the SNA gateway. If you are only configuring a CTC NJE node, the APPL macro can be left out.

LINE=i

Replace i with the line definition, which is described in the following section. The host programmer must define a JES2 line if you are defining a CTC NJE node.

The host programmer must define a JES2 line if you need to define the number of streams in a specific line or node. The host programmer must also set the number of streams for an NJE node.

Remember to set the JES2 parameters TPDEF, EXTBUF, and BUFSIZE to their maximum values.

A JES2 configuration example has been provided to show the configuration for a single host node connected to BARR/NJE.

Defining lines for the node

Lines define an NJE to NJE connection. Each line has a number of streams associated with it. Streams consist of SYSIN (job) transmitters & receivers, and SYSOUT (print data sets) transmitters and receivers. You will need to define an explicit JES2 line only if you need to define the number of streams in a specific line or node or if you are defining a CTC NJE node. An explicit JES2 line is not needed if you are using the default number of streams.

For a Barr SNA or SNA connection

LINE(i)
NODE(n)

UNIT=SNA
NAME=
xxxx,PATHMGR=NO,LINE=i

For a CTC connection

LINE(i)

UNIT=yyyy

Parameter

Description

LINE(i)

Replace i with the same line number referenced in the NJE node definition.

UNIT=yyyy

Replace yyyy with the CTC device number entered in CTC host configuration.

Defining streams for the node

These stream values will also be entered later as BARR/NJE stream numbers in when you configure BARR/NJE for Barr SNA, SNA, or CTC. There are three ways to define streams for the node in JES2. For more information, refer to the JES2 configuration example.

JES2 limits the number of transmitters to 8 and the number of receivers to 8.

Specify streams using default settings

If you choose not to define the number of streams, JES2 uses the following defaults.

1 SYSIN transmitter

1 SYSOUT transmitter

1 SYSIN receiver

1 SYSOUT receiver

Specify streams using LINE( ) and NODE( ) macros

Use the LINE(i) macro to specify the number of streams, and then link the line to a node with the NODE macro's LINE parameter. To customize the number of streams per node, set the number and type of streams in the LINE() macro. The node then indicates which line to use with the LINE parameter.

LINE(i)
NODE(n)

UNIT=SNA,JTNUM=j,JRNUM=k,STNUM=l,SRNUM=m
NAME=xxxx,LINE=i,PATHMGR=NO

Parameter

Description

JTNUM=j

Replace j with the number of SYSIN (job) transmitters.

JRNUM=k

Replace k with the number of SYSIN receivers.

STNUM=l

Replace l with the number of SYSOUT (print data sets) transmitters.

SRNUM=m

Replace m with the number of SYSOUT receivers.

Specify streams using NJEDEF

To set the default number of streams per node you can use the NJEDEF macro.

NJEDEF

JTNUM=j,JRNUM=k,STNUM=l,SRNUM=m

Parameter

Description

JTNUM=j

Replace j with the default number of SYSIN (job) transmitters.

JRNUM=k

Replace k with the default number of SYSIN receivers.

STNUM=l

Replace l with the default number of SYSOUT (print data sets) transmitters.

SRNUM=m

Replace m with the default number of SYSOUT receivers.

Review JES2 configuration example

The following is a sample SYS1.PARMLIB(JES2PARM) configuration for a single host node connected to BARR/NJE.

NJEDEF
NJEDEF
NJEDEF
LINE(1)
LINE(2)
LINE(3)
LOGON1
NODE(1)
APPL(BAR2JES2)
NODE(2)
APPL(TB201N01)
NODE(3)
APPL(TB202N01)
NODE(4)

NODENUM=3,OWNNODE=1
JTNUM=4,JRNUM=4,STNUM=4,SRNUM=4
LINENUM=2
UNIT=SNA
UNIT=SNA,JTNUM=2,JRNUM=4,STNUM=6,SRNUM=4
UNIT=E60
APPLID=BAR2JES2
NAME=BAR2JES2
NODE=1
NAME=BAR1JES2,PATHMGR=NO
NODE=2
NAME=BAR1JES3,PATHMGR=NO,LINE=2
NODE=3
NAME=BAR1JES4,PATHMGR=NO,LINE=3

Parameter

Description

LINE(3)

E60 has been configured as a CTC device elsewhere on the host.

NODE(1)

The host's NJE node.

NODE(2)

The NJE node definition for BARR/NJE's node. It has 4 SYSIN transmitters, 4 SYSOUT transmitters, 4 SYSIN receivers, and 4 SYSOUT receivers. It can start on the lines configured for SNA or for CTC device E60.

NODE(3)

An NJE node definition for BARR/NJE's node that starts on line 2. Using line 2 makes it an SNA node. It has 2 SYSIN transmitters, 6 SYSOUT transmitters, 2 SYSIN receivers, and 4 SYSOUT receivers.

NODE(4)

An NJE node definition for BARR/NJE's node that starts on line 3. Using line 3 makes it a CTC node. It has 4 SYSIN transmitters, 4 SYSIN receivers, 4 SYSOUT transmitters, and 4 SYSIN receivers.

JES2 limits the number of transmitters to 8 and the number of receivers to 8.