Configuring BARR/RJE for MS/LUA

RJE Configuration Utility

Use the RJE Configuration Utility to define and configure MS/LUA connections for communicating with the host. MS/LUA connections require the installation of an SNA gateway (Microsoft SNA Server, SNA Workstation, or HIS). See the System Requirements topic for more information. The procedures outlined in this topic are required. Refer to the Configuring BARR/RJE optional settings topic to configure more advanced BARR/RJE settings.

You must be a member of the local Administrators group to operate the RJE Configuration Utility. If you are assigned the Configure - RJE user access right on the computer to which you are trying to connect, but are not a member of the Administrators group, the RJE Configuration Utility will operate in read-only mode.

You must configure and test the SNA gateway before you can configure an MS/LUA communication link.

See also:


Defining a connection

Complete the following steps to define a BARR/RJE connection. If you are working with connections located on a different computer, click More on the RJE Configuration Utility. Under Computer, select the appropriate Domain and computer Name from the drop-down lists. Then click List Connections to display the connections on the selected computer.

  1. Open the RJE Configuration Utility.

  2. Click Add. The Add Host Configuration dialog box displays.

  3. Type a connection name and click OK. The Connection Properties dialog box displays. Use the tabs to specify the settings for the connection.

Entering the RJE description

Complete the following steps to configure the RJE settings and print sample host definitions. These settings must match the parameters specified when configuring JES2, JES3, or POWER.

  1. Select the RJE Description tab.

    RJE Description Tab

  2. From the RJE system drop-down list, select JES2, JES3, or POWER as your host spooler.

  3. Enter the Remote name and Password that the host programmer assigned to the BARR/RJE system. These values must match the values entered when configuring JES2, JES3, or POWER.

  4. In the APPLID box, enter the application name of your host RJE system used for running JES2 on the host.

  5. In the LOGMODE box, enter the name of the associated logmode file. For JES2 and JES3, the IBM default value is BATCH and will not need to be changed for most users. For POWER, the default value is RJE3790B.

  6. Select the Logon type. The default type is Formatted. If you selected a Formatted Override or Character Coded logon type, you can enter Logon data.

  7. Select the number of Printers, Punches, and Readers. The numbers you specify must match the NUMPRT, NUMPUN, and NUMPDR parameters defined in the remote definition statement (RMTnnnn) when configuring JES2, JES3, or POWER. For POWER, there can only be three printers, one punch, and one reader.

If you specify one or more readers, when you close the RJE Configuration Utility, a dialog displays asking if you would like the RJE Configuration Utility to automatically create the RJE readers needed for communicating with the host. We recommend selecting Yes and allowing BARR/RJE to create the following necessary devices. You must restart the BARR SpoolCore service for your changes to take effect.

  1. The host programmer must set certain host parameters for BARR/RJE to operate. You will save time and effort getting your system running if you adhere to the recommended host definition. We recommend you print these dialog boxes and provide them to the host programmer to ensure the correct parameters are used. Click Remote Definition and Logmode Table Entry to view sample statements the host programmer will need to enter in the RJE system parameter libraries. The parameters that display vary depending on the settings configured on the RJE Description tab. The parameters that may change are displayed in blue text.

Configuring the communication link

Complete the following steps to add an MS/LUA communication link and configure the link properties. Your host programmer can help configure the link settings. To modify a link, select a link from the Name list and click Modify. To remove a link, select a link from the Name list and click Remove.

  1. Make sure you have configured and tested the SNA gateway before you configure an MS/LUA communication link.

  2. Select the Communication Link tab.

    Communication Link Tab

  3. Under Link options, an MS/LUA link has been created by default. To update the default link, select MS/LUA (RJEPOOL) and click Modify. The MS/LUA Configuration dialog box displays. To create a new link, click Add, select the MS/LUA link type and click OK. In the MS/LUA Configuration dialog box, type the appropriate Pool name and click OK. This name must be in all uppercase characters and match the pool name created when configuring the SNA gateway.

  1. Specify the number of Non-RJE LUs. This sets the starting LU Acronym for Logical Unit. In an IBM SNA network, a point denoting the beginning or end of a communications session. number, allowing you to skip any non-RJE LUs defined in the RJE remote definition. This skips any 3270 or IPDS/AFP LUs. The default value is 0.

  2. Select whether to use the software in Test mode. During test mode, you can use all the BARR/RJE functions, but the software does not connect to the host computer. Test mode is a useful tool when you are learning about the software or testing software features.

  3. Configure additional settings if necessary.

  4. When you finish configuring the connection, click OK. If you created a reader on the RJE Description tab, a dialog displays asking if you would like the RJE Configuration Utility to automatically create the RJE readers needed for communicating with the host. We recommend selecting Yes and allowing BARR/RJE to create the following necessary devices. Change the state of all printers in the Spool Window to Disabled before BARR/RJE creates the devices. Once the readers have been created, you must restart the BARR SpoolCore service for your changes to take effect. If you select No, you will need to manually configure the RJE readers.

  5. To route files from a program to the Spool Window, the printer Connection name - Send to Host is created. This allows you to print directly from a program by selecting File | Print on the menu bar.

  6. To route files from the Spool Window to the host, a spool printer is created for each reader specified. These printers appear in the Spool Window with the name Connection name - RDn. After the BARR SpoolCore service is restarted, you can view the newly created printers.