Device Control tab

RJE Configuration Utility

Use this tab to specify additional features that affect print output. These options affect output files received on the source devices. You can access this tab by defining or modifying a BARR/RJE connection.

Click an option you want to learn more about.

Device Control Tab

What do you want to do?

See also:


Printer

These options control the use of form information with print output.

Use FCBLOAD

In general, FCBLOAD is not recommended with BARR/RJE. When using the FCBLOAD method of getting FCB information, JES Acronym for Job Entry Subsystems of the IBM MVS operating system. These subsystems are used for entering jobs into the MVS operating system and dispensing the output from the jobs. uses a Set Vertical Format (SVF) command to send channel stop A code (from 1-12) assigned to lines on a form. When a printer encounters a command to advance to a channel stop, the print head moves to the next line identified by the channel stop and gets ready to print. information. The SVF mechanism provides a single line value for channel stops 2 through 12, but does not specify channel stop 1. Therefore, Skip To Channel 1 is assumed to be on line 1. This effectively means that FCBLOAD "hard codes" Skip To Channel 1 on line 1, regardless of what is actually coded in the FCB definition at the host. It also means that, in FCBs with Skip To Channel X defined on multiple lines, FCBLOAD only recognizes one Skip To Channel X, and ignores the others. Thus, the FCB that is coded on the host might not be the same FCB that is sent to the printer using FCBLOAD.

If you have so many forms that it is inefficient to organize them on your remote computer, you may prefer to organize them on the mainframe. In this situation, FCBLOAD is appropriate. The disadvantage of FCBLOAD, however, is that jobs will appear identical in the Spool Window. If you are using automatic spooling, we recommend that you use the $HASP190 FORMNAME or $HASP190 FCBNAME selections to separate jobs by form name and FCB name.

When using the $HASP190 messages, you will still not be able to distinguish between files that have the same form name or FCB name.

The FCBLOAD mechanism uses the FCB information supplied by the host computer. Selecting this option limits the Mount forms by drop-down list to $HASP190 FORMNAME (default), RJE Console, $HASP190 FCBNAME, and Power 1Q40A FORMNAME. If this option is not selected, the Mount forms by list also includes SETUP=PDIR FORMNAME (default) and SETUP=PDIR FCBNAME. By default, this option is not selected.

The FCB contains information used to format the data at print time, including lines-per-inch, lines-per-form, and carriage control stops. As a file is being received, the FCB is embedded in the data set header.

You must also enable the FCBLOAD feature at the host, so that FCB information is included with each file received from the host to the computer. For JES2, enable the LOGMODE’s PSERVIC parameter and the FCBLOAD parameter on the remote printer statement.

You cannot use the host SETUPHDR feature if FCBLOAD is enabled at the host.

If you do not use FCBLOAD, the FCB information from the host, if any, will be discarded. If you use the host SETUPHDR feature, you must disable the FCBLOAD mechanism in the Barr software and at the host computer. SETUPHDR and FCBLOAD cannot be used together.

Mount forms by

The printer uses forms to format the print data. If you are using forms, choose which method the software will use to obtain form information for a file. This process is commonly referred to as loading or mounting forms.

The RJE Console choice is the only method to manually load forms. The other choices are methods to automatically load forms, usually during unattended operation. The RJE Console choice is valid only for JES2 and JES3.

If Use FCBLOAD is selected, the only valid choices are $HASP190 FORMNAME (default), $HASP190 FCBNAME, RJE Console, and Power 1Q40A FORMNAME. The other selections are ignored. If Use FCBLOAD is not selected, the default is SETUP=PDIR FORMNAME.

SETUP=PDIR FORMNAME
SETUP=PDIR FCBNAME
– Depending on your selection, the form name or FCB name provided by the SETUPHDR (PDIR) record is used to automatically mount the printer form. This feature is supported by most host operating systems. With either SETUP=PDIR choice, you must define printer forms in the Barr software to supply format information. The information from the PDIR Acronym for Peripheral Data set Information Record. is stored in the job header and can be displayed on the Spool Window.

Both SETUP=PDIR selections provide the same information (form name, FCB name, job name, UCS Acronym for Universal Character Set. Some printers require loading a UCS buffer to match the print train or band installed. Train name, copies, and number of records), but your choice determines how you must name the forms in the resource library selected on the Resource Folders tab. If you select SETUP=PDIR FORMNAME, forms must be named to match the form name supplied by the message. If you select SETUP=PDIR FCBNAME, forms must be named to match the FCB name provided by the message. Refer to the Make FCB topic for more information about creating forms.

During software operation, if no matching form is found in the FCB folder, the software will attempt to load the standard form, STD. If the STD form has not been defined, BARR/RJE uses the form from the previous job.

The SETUPHDR feature also must be enabled in the host definition so that PDIR information is included with each file received from the host. For JES2, you must include the SETUP=PDIR parameter in the remote definition. For JES3 and POWER, you must set byte 3 of the LOGMODE’s PSERVIC to 20 or 60.

Also for JES2, you must change the work selection criteria for each printer stream to enable all files to be received automatically, regardless of their form name or FCB name. If you use SETUP=PDIR FORMNAME, eliminate F (for form) from the work selection criteria with the JES2 Set Printer command $T PR1,WS=(-F). If you use SETUP=PDIR FCBNAME, eliminate C (for FCB) from the work selection criteria with the JES2 Set Printer command $T PR1,WS=(-C).

If SETUPHDR is enabled at the host or in the Barr software, you cannot use the host FCBLOAD feature or the Use FCBLOAD option.

Although the mainframe file creation date and time are included in the PDIR, they are not used by the software. Instead, when files are received they are assigned the computer date and time.

RJE Console – The operator manually mounts forms with the mount forms options on the Forms tab. With this choice, you must define printer forms in the Barr software to supply printer format information. At print time, the operator selects the desired form from the Mount Forms dialog box in the RJE Console. This option is valid only for JES2 and JES3. Refer to the Make FCB topic for more information about creating forms.

$HASP190 FORMNAME
$HASP190 FCBNAME
– Depending on your selection, the form name or FCB name provided by the JES2 $HASP190 message is used to automatically mount the form. These selections are valid only for JES2.

Both $HASP190 selections provide the same information (form name, FCB name, and job name), but your selection determines how you must name the forms in the resource library selected on the Resource Folders tab. If you select $HASP190 FORMNAME, forms must be named to match the form name supplied by the message. If you select $HASP190 FCBNAME, forms must be named to match the FCB name provided by the message. Refer to the Make FCB topic for more information about creating forms.

During software operation, if no matching form is found in the FCB directory, the software attempts to load the standard form, STD. If STD has not been defined in the table, BARR/RJE uses the form from the previous job.

To enable the JES2 $HASP190 message, include the JES2 parameter SETUP=MSG in the remote definition. Additionally, you must change the work selection criteria for each printer stream to enable all files to be received automatically, regardless of their form name or FCB name. If you use $HASP190 FORMNAME, eliminate F (for form) from the work selection criteria with the JES2 Set Printer command $T PR1,WS=(-F). If you use $HASP190 FCBNAME, eliminate C (for FCB) from the work selection criteria with the JES2 Set Printer command $T PR1,WS=(-C).

Only the form name provided by the $HASP190 message is reliable. The other information, such as the job name, is only updated when the form name changes.

Power 1Q40A FORMNAME – The form name provided by the POWER 1Q40A message is used to automatically mount the form. This selection is valid only for POWER. However, we recommend POWER users select the SETUP=PDIR FORMNAME or SETUP=PDIR FORMNAME options instead.

If you select Power 1Q40A FORMNAME, you must appropriately name the forms in the resource library selected on the Resource Folders tab. Forms must be named to match the form name supplied by the message. The POWER 1Q40A message is sent to the computer immediately before a job.

Only the form name provided by the POWER 1Q40A message is reliable. The job name is only updated when the form name changes.

Maximum print position

Specify the maximum print position on a line. If characters on a line exceed the specified maximum, the software will wrap the extra characters to the next line as the file is received to the computer. The default length is 255 print characters, but you can customize this value. For example, if data lines contain 255 characters but your printers support a maximum of 132 characters per line, set this value to 132. Valid values are 1 to 255.

Reader

Reader control options allow you to adjust the format of files sent to the mainframe.

Minimum line length

Specify the minimum length of data lines that will be sent on the reader. Any data lines shorter than the minimum line length will be padded with blanks to the specified length. For host computers that do not require data lines sent on the reader to have the same length, use the default value of 1. Some host systems require all reader lines to be a fixed length, such as 80 characters. If your host system has such a requirement, specify the required minimum. Valid values are 1 to 254.

Maximum line length

Specify the maximum length of data lines that will be sent on the reader. The default value is 80 characters. MVS/JES2 allows a maximum reader line length of 254 characters, but some mainframe programs cannot accept lines longer than 80 characters.

If you are sending print files to another SNA RJE remote unit, set this value to 132 so that all 132 columns of your print file are sent. Valid values are 1 to 254.

Devices

Lists all of the defined printers (PRn), punches (PUn), and readers (RDn).

Configure button

Sets the device properties for printers and punches. This option is not available for readers. Select a printer or punch and click Configure to display the Device Properties dialog box. You can also double-click a printer or punch to set the device properties.