RJE Description tab

RJE Configuration Utility

This tab lists RJE system parameters you must specify for the BARR/RJE software and the host RJE system. The parameters specified on the computer and on the host computer must match. The host programmer provides this information. You can access this tab by defining or modifying a BARR/RJE connection.

Click an option you want to learn more about.

What do you want to do?

• Enter the RJE description

See also:

• Remote definition

• Logmode table entry

Settings

RJE system

Displays the host systems supported by the BARR/RJE software. Select your host system—JES2, JES3, or POWER—from the drop-down list.

Remote name

Enter the name for your remote. The host assigns your remote a name that uniquely identifies it to the RJE system. Each RJE system has its own naming conventions (for example, a JES2 remote name begins with RMT). This is a required field. The default value is RMT9999.

Password

Enter the password the software uses to log on to the RJE system. The password restricts use of the remote connection to authorized users. You might not need a password if you use a nonswitched (dedicated) line.

APPLID

Specify the application identification. The APPLID is the application name of the host RJE system as defined for VTAM (for example, JES2, RTAM, NER1JES2, or BAR1JES2). Ask the host VTAM programmer for the names in the APPL Application program. MAJOR NODE. The host will usually have a customized name. If your Logon type is Formatted or Host Initiated, this is a required field.

An incorrect APPLID will result in a failed log on.

LOGMODE

Specify the name of the LOGMODE entry in the logmode table your host system uses during log on. The LOGMODE, also called the logmode table entry, contains more information used during formatted or character-coded log on. You can use either an IBM default LOGMODE or a custom LOGMODE, depending on your job entry subsystem and job processing requirements. The default value is BATCH.

The IBM default LOGMODE, BATCH, comes in the IBM-supplied ISTINCLM mode table. BATCH is usually the best choice for JES2, because JES2 normally builds a bind In SNA communications, the operation in which the host and remote LUs initiate a session and agree upon the protocol to be used within that session. from the RJE definition and does not rely completely on the LOGMODE.

Although this table entry is compatible with BARR/RJE, many applications require you to modify it. The host programmer must make a new table entry by copying BATCH and changing it to match the BATCH logmode table entry.

Logon type

Logon type specifies whether the logon message is formatted (composed by the Barr software) or character coded (composed by the user).

Formatted – Default. Barr software automatically composes the user data portion of the log on from the Remote name and Password you enter. The software codes the user data plus the LOGMODE and APPLID into logon fields. The software sends this information to the host using the SNA command INITSELF.

Formatted Override – With this type of log on you can manually override the user data portion of the formatted log on. When you select this option, the logon data field becomes available.

Logon data includes the remote name and password. The software sends this information to the host using the SNA command INITSELF.

Character Coded – This log on, also known as the unformatted logon type, is 80 characters of manually entered logon data. Use this selection if your host requires a different log on than the one composed by the formatted log on. The information required depends on your host system’s conventions. The Barr software sends the logon message as text to the host where VTAM analyzes it using the USSTAB tables.

You can enter logon data for the formatted override and character coded log on types. The logon data can include a password.

Host Initiated – With a host-initiated log on, BARR/RJE does not send any logon data to the host. The software connects to the host, but does not automatically log on to the host RJE system. The SSCP Acronym for System Services Control Point. A controlling program in an SNA domain. It resides in the host and is a component within VTAM. initiates the log on.

The Barr software displays mainframe messages on the RJE Console to help you diagnose initial logon problems. If the requested application is not available, the software displays the mainframe Network Services Procedure Error (NSPE) message in this format: LOGON Failed (NSPE). If the mainframe detects an incorrect parameter, such as an invalid password in the INITSELF request, the software displays this mainframe message to help you determine why the bind is not forthcoming: LOGON Failed.

Logon data

In SNA communications, an LU sends a message in response to the log on. The entire logon sequence or message is called the logon data. You can enter logon data for the formatted override and character-coded logon types.

Printers

Specify the number of RJE printers for your remote. The remote can receive output from the host computer on one to seven print streams. The number of printers must match the number defined in the remote definition statement (RMTnnnn) on the host. Data received on printer devices contains carriage control information used for printing. The default value is 1.

For JES2 and JES3, the MVS operating system restricts the number of printers and punches you can define to a total of seven devices. Of the seven devices, seven can be printers. For POWER, the VSE operating system restricts the printers to exactly three.

Punches

Specify the number of RJE punches for your remote. You can select zero to four punch devices. The number of punches must match the number defined in the remote definition statement (RMTnnnn) on the host. The default value is 1.

For JES2 and JES3, the MVS operating system restricts the number of printers and punches you can define to a total of seven devices. Of the seven devices, four can be punches. For POWER, the VSE operating system restricts the number of punches to exactly one.

Readers

The software sends data files from the computer to the host on reader devices. For JES2 and JES3, you can specify from one to four RJE readers for your remote. The number of readers must match the number defined by the remote definition statement (RMTnnnn) on the host. The default value is one. For POWER, you can only specify one reader.

Sample host definitions

The host definitions contain sample statements the host programmer needs to enter into the RJE system parameter libraries.

The host programmer must set certain host parameters for BARR/RJE to operate. An existing remote definition used for other RJE equipment might not work with BARR/RJE. You will save time and effort getting your system running if you adhere to the recommended host definition.

Remote Definition button

The remote definition contains sample statements the host programmer needs to enter into the RJE system parameter libraries. You can print this screen for the host programmer by clicking Print. You can also select a portion of the definition and right-click to copy the text to the Clipboard.

Source statements are in SYS1.PARMLIB(JES2PARM).

Logmode Table Entry button

The logmode table entry contains sample statements the host programmer needs to enter into the RJE system parameter libraries. You can print this screen for the host programmer by clicking Print. You can also select a portion of the text and right-click to copy the text to the Clipboard.

Source statements are in SYS1.VTAMLST(ISTINCLM).