Sending files (JCL SYSIN) to the NJE host

BARR/NJE

If you have not already done so, follow the procedures in the Getting started with BARR/NJE topic to configure the host and software.

JES3 and POWER do not support sending jobs to the host.

To send files to the host, you must first define a routing table to establish a connection between Barr nodes and host nodes. Next, you must create a folder (either on your hard drive or on your network) where the SYSIN files will be placed. You will then configure Print Utility to automatically take the files from the folder, assign the files with the appropriate header field values, and send the files to BARR/SPOOL. Finally, you will configure a spool printer for sending the jobs to the host and assign the printer with the appropriate header field values. Once the configuration steps are complete, SYSIN files that are placed in the specified folder will automatically be sent by Print Utility to the Spool Window and then BARR/SPOOL will automatically route the files to the spool printer with the matching fields.

If your files require special processing (such as files with long records, binary data, or files that require BARR/TRAN processing), refer to the Sending JCL files with an embedded command topic. Using embedded commands adds flexibility to the existing BARR/NJE functionality. BARR/TRAN provides extended file transfer capabilities, including longer record length, variable length records, and so on.

Complete the following steps to send jobs to the host.

  1. Using Print Utility

  2. From a program

See also:


Configuring Print Utility to automatically send jobs to the spool

To send JCL (SYSIN) jobs to the host, we recommend that you set up Print Utility to automatically search a specified folder for SYSIN jobs. To automatically add files to the spool, you need to create folders and specify the spooling interval. You can automatically add local and LAN files.

  1. If you are adding local files, skip to step 2. If you are adding files from a network, configure the BARR Print Utility service to log on as a user rather than a system account A predefined local account used by system processes. This account is only recognized on the local computer and cannot be used to access network resources relying on NT LAN Manager (NTLM) authentication.

  1. Open the Services utility.

  2. Select the BARR Print Utility service, and on the menu bar select Action | Properties.

  3. Select the Log On tab. If a system account is selected, we recommend you uninstall and then reinstall the software selecting the user account type. If you are unable to uninstall and reinstall the software, you can configure the service to log on as a user account.

  1. If it doesn't already exist, use the Windows Explorer to create a folder for the SYSIN jobs. Print Utility will use this folder for automatic spooling.

  1. Open Print Utility.

  2. From the Automatic Spooling tab, click Add.

    Automatic Spooling Tab

  3. Navigate to the folder you just created. Click OK. The Input Data Conversion Utility displays.

  4. On the Format tab, select SYSIN data (JCL) as the file type.

  5. If you are sending a raw data file, under JCL files select the beginning and ending JCL files, the send mode, and length (if necessary). If your file is a JCL file, you can leave these fields blank.

  6. Begin – The beginning JCL file that is sent immediately before each data file. The file must be in a separate directory from the data file. Click the folder button to select the file, or enter the path and file name in the text box.

  7. End – The ending JCL file that is sent immediately after each data file. The end file must be in a separate directory from the data file. Click the folder button to select the file, or enter the path and file name in the text box.

  8. Mode – Determines the format of the data. See the Format tab for a description of each option.

  9. Length – The record length that can be specified in the following send modes: A, TF, TDF, and TBF. The default value is 80.

  1. On the Options tab, select an output statement and configure headers from data if necessary. We do not recommend using the Output statement and Headers from data options together. If you want to use both of these options, select your settings carefully.

  2. If needed, click Code Pages and choose an ASCII or EBCDIC code page from the Select Code Pages dialog box.

  3. Click OK. The Spooling Properties dialog box displays.

    Spooling Properties Dialog Box

  4. Under Folder, verify the correct folder Name is displayed.

  5. Enter a folder Description that will display on the Automatic Spooling tab.

  6. To specify the spooling interval, enter a value next to Check every and select Seconds or Minutes.

  7. Select Check subfolders to check the subfolders for automatic spooling.

  8. Select the disposition for the Original file. You can select to leave the file, delete the file, or move the file to another folder.

  9. Select the disposition for the Printed file. You can either retain the file or delete the file.

  10. Specify the document attributes. Print Utility sets these fields to specified values before sending a copy of each file to the spool.

  1. Under Document attributes, click Add. The Select Field dialog box displays.

  2. From the Section drop-down list, select Data Set Header General Section.

  3. Select NDHGNODEDest. node, and set the field Value equal to the value for the destination node.

  4. From the Section drop-down list, select Job Header General Section.

  5. Select NJHGORGNOrg. node, and set the field Value equal to the value for the originating node.

  6. Select NJHGXEQNExe. node, and set the field Value equal to the value for the execution node An NJE node that is intended as the destination for print output or jobs. Synonymous with destination node. See node.

  7. Click OK twice to return to the Spooling Controls tab.

  1. If it is not already selected, set the automatic spooling Status to Enabled. This option is available only when the BARR Print Utility service is started.

Configuring the Spool Window to release jobs to the host

Once you have defined a spool printer for printing the jobs to the host and configured Print Utility to send jobs intended for the host to the Spool Window, you are ready to send jobs to the host from the Spool Window.

Complete the following steps to send a job to the host from the Spool Window.

  1. Open the Spool Window.

  2. If the Dest. node column is not displayed, add it to the Spool Window. This field, NDHGNODE (Dest. node), is contained in the Data Set Header General Section.

  1. Disable the spool printer.

  2. Double-click the Dest. node column for your printer, enter your host’s NJE node, and click OK. This value is entered as the host node when you define a routing table.

  3. To print the document, set the document and printer criteria to match in the Spool Window, and change their states to Ready. The document will display a Printing state. After printing, the job will disappear. Check your host's output queues for the job.

When SYSIN jobs are added to the Spool Window, they appear shaded in a light blue background.