File Format tab

Printers

Use this tab to specify the format of files when they are written to disk. You can access this tab when you configure a printer for writing to disk.

Files from Barr DOS products that are spooled to BARR/SPOOL can be returned to their original Barr DOS format if you select the corresponding format option.

Click an option you want to learn more about.

File Format Tab

What do you want to do?

See also:


Format

Specifies the format to use when the file is written to disk.

Option

Description

ASCII

ASCII files with ASCII carriage control (carriage return, line feed, and form feed). This option is selected by default.

Variable-length record

Records that vary in length because they contain at least one variable-length field.

Fixed-length record

Records that have a fixed length because each field within the record has a fixed length.

S/370

S/370 format, compatible with BARR/RJE (DOS). BARR/RJE PRINT370 format.

Unicode

UNICODE two-byte character format.

VBM

Variable block with machine carriage control (VBM) format with RDW Record Descriptor Words included.

Barr file transfer

Converts Barr file transfer (BARR/TRAN FILE80) files to the format specified by a field in the Start-of-File record. Refer to the Using BARR/TRAN topic for more information.

Binary

Writes the data with no format conversion. The output file will be in the same format as the original input file.

Barr archive

Barr proprietary format for archiving jobs. BARR/SPOOL NJE-wrapped data format.

Options

Specifies additional options that can be used to specify the file format. The available options vary depending on the file format selected.

DOS BARR/SPOOL header

Includes a DOS BARR/SPOOL header with the file. This option is available when the ASCII or S/370 format is selected.

ASCII – ASCII file with header and expanded carriage control. BARR/RJE ASCII format with BARR/RJE spool header. This can be used in conjunction with the ASCII with ASA carriage control option to provide the following format: ASCII file with ASA carriage control and header. BARR/RJE ASA format with BARR/RJE spool header.

S/370 – S/370 file with header, BARR/RJE compatible. BARR/RJE PRINT370 format with Barr S/370 header.

ASCII with ASA carriage control

ASCII files with ASA carriage control. This option is available when the ASCII format is selected. This can be used in conjunction with the DOS BARR/SPOOL header option to provide the following format: ASCII file with ASA carriage control and header. BARR/RJE ASA format with BARR/RJE spool header.

Routing header

Includes a routing header with the file. Usually these files will be processed by Elixir. This option is available when the VBM format or the Fixed-length record format and the EBCDIC data type is selected. If you select the Fixed-length record format and the EBCDIC data type, you must specify the record Length, Carriage control, and Delimiter.

Block length

Includes block length The length, usually in bytes, of a block of data. Block length typically ranges from 512 bytes to 4,096 KB, depending on the purpose for which the block is used. in the record. This option is available when the VBM format is selected. When this option is selected, records include a block count. The block count will directly precede the record count. In the following example, the block count is shown in blue and the record count in red: 00 0C 00 00 00 08 00 00 F1 F2 F3 F4.

This option must remain disabled for files that will be processed by Elixir.

Wrap in NJE

Includes NJE-wrapped data records in the output file. The data is written with no format conversion. This option is available when the Binary format is selected.

Data type

Specifies the data type to be used when the Variable-length record or the Fixed-length record format is selected.

ASCII

Specifies an ASCII data type for variable or fixed-length records. This option is available when the Variable-length record or the Fixed-length record format is selected. If you select the Fixed-length record format, you must specify the record Length, Carriage control, and Delimiter.

EBCDIC

Specifies an EBCDIC data type for variable or fixed-length records. This option is available when the Variable-length record or the Fixed-length record format is selected. If you select the Fixed-length record format, you must specify the record Length, Carriage control, and Delimiter.

Length

Specifies the length of the fixed records. The default value is 40.

Multiple records

Allows you to receive variable-length or fixed-length records that are shorter or longer than your print width. (Variable-length records have different lengths, while fixed-length records have the same length.) Select N ASCII lines for records that are an even multiple of x characters. For example, 80 characters (160, 240, and so on). Select Variable ASCII lines for records that are not an even multiple of x characters.

N ASCII lines

Allows you to receive files with fixed-length records longer than x characters. Some host systems can only send a limited number of characters in a record, and N ASCII lines lets you work around this limitation.

To use N ASCII lines, you must write a host program to divide each data set record into groups of x-character lines. Each record must be divided into the same number of lines, so that all records have the same length. When the x-character lines are received, Barr File port rebuilds each record by combining the specified number of lines. The data from the host is converted to ASCII format with a carriage return and line feed (CR LF) to indicate the end of each record, but no form feeds are added (FF) to indicate page boundaries.

Value – Specify the number of x-character lines that should be combined into one record.

Variable ASCII lines

Allows you to receive variable-length or fixed-length records that are shorter or longer than your print width. Some host systems can transfer only a specific number of character records. If you need to transfer records with a different length, the Variable ASCII lines selection lets you work around this limitation.

With the Variable ASCII lines selection, Barr receives x-character records from the host and rebuilds them to their original lengths. The data from the host is converted to ASCII format with a carriage return and line feed (CR LF) to indicate the end of each record, but no form feeds (FF) are added to indicate page boundaries.

To use this feature, you must write a host program to divide all records into x-character lines. If the record length is not an even multiple of x, the last line for the record can have less than x characters. The host program must insert a record indicator at the end of each record. The vertical bar (|) is the default delimiter. For example, you would divide a 120-character record into two parts: an 80-character line and a 40-character line that ends in a vertical bar. When the data is received, Barr File port rebuilds each record by combining lines until it encounters a vertical bar. The software discards the vertical bar and any trailing data in the last segment.

Delimiter – Specify the record indicator at the end of each record. The vertical bar (|) is the default delimiter.

Carriage control

Selects the type of carriage control to use.

None

Records do not contain a carriage control character. This option is available when the Fixed-length record format or the Variable-length record format and the EBCDIC data type is selected. If you select the Variable-length record format and the EBCDIC data type, you must specify the Delimiter.

ASA

Records contain an ASA carriage control character. This option is available when the Fixed-length record format or the Variable-length record format and the EBCDIC data type is selected. If you select the Variable-length record format and the EBCDIC data type, you must specify the Delimiter.

Machine

Records contain a 3211 machine carriage control character. This option is available when the Fixed-length record format or the Variable-length record format and the EBCDIC data type is selected. If you select the Variable-length record format and the EBCDIC data type, you must specify the Delimiter.

Delimiter

Selects the type of delimiter to use.

None

Records do not include delimiter characters. This option is available when the Fixed-length record format is selected. You must also specify the Data type, record Length, and Carriage control.

ASCII

Records include an ASCII delimiter. Each record ends in a carriage return and line feed character. The actual record length is two bytes more than the fixed record length specified above. This option is available when the Fixed-length record format or the Variable-length record format and the EBCDIC data type is selected. If you select the Fixed-length record, you must also specify the Data type, record Length, and Carriage control. If you select the Variable-length record format and the EBCDIC data type you must also specify the Carriage control.

EBCDIC

Records include an EBCDIC delimiter. Each record ends in a carriage return and line feed character. The actual record length is two bytes more than the fixed record length specified above. This option is available when the Fixed-length record format or the Variable-length record format and the EBCDIC data type is selected. If you select the Fixed-length record, you must also specify the Data type, record Length, and Carriage control. If you select the Variable-length record format and the EBCDIC data type you must also specify the Carriage control.