Limiting Processing With FILEDF - Code-1_Plus - 5.0

CODE-1 Plus Reference for all Platforms

Product type
Product family
Data Quality - Postals
CODE-1 Plus
Product name
CODE-1 Plus
CODE-1 Plus Reference for all Platforms
First publish date

To limit the number of records CODE-1 Plus processes, use the following methods:

  • Skip a portion of the file before any records are selected.

  • Enter a fraction to select a portion of the records, evenly spaced throughout the file.

  • Specify the maximum number of records to process. CODE-1 Plus will start at the beginning of the file and process every record until the maximum number is reached.

You can use these fields in conjunction with each other. For example, you could enter a number of records to skip, and a maximum number of records to read if you wanted to process the middle of the file, but not the beginning or the end.

Fractional Record Selection

The fractional record selection feature enables you to sample records throughout the file, from beginning to end, without processing consecutive records. To determine the number to enter in this 7-byte field, divide the number of records you want to process by the number of records in the file. This will give you a decimal number. Drop the decimal, and enter the first 7 digits of the number. For example, you have a file with 102986 records, and you want to process 2000 records. You would divide 2000 by 102986 and get .0194201153. Dropping the decimal, you would enter 0194201 in the fractional record selection field. This will ensure that the 2,000 records processed are evenly distributed throughout the file.

Note: iThe maximum sample is every other record (half of the file). If you enter a fraction greater than .5000000, the record selection process yields every record in the file.
Note: iLimiting the number of records to process (by skipping records, specifying a maximum, or sampling the file) should be done on the input FILEDF parameter. If you limit processing on an output FILEDF parameter, CODE-1 Plus processes all of your input records, but limits the number of records written to the output file.


Field Name




Required. FILEDF is the only acceptable entry.


File Name

Required. Specify the name of the input or output file:

  • C1BMNAM — Input file.

  • C1BMCOK — Matched records output file.

  • C1BMNCO — Unmatched records output file.

  • C1BMIZP — Invalid ZIP Code output file.

  • C1BMZP4 — ZIP+4 coded records output file.

  • C1BMSTA — Output statistics file. The only required field on the parameter is record length, positions 19-22, and may be any numeric value.

  • Blank — No default.


Record Format

Required. Specify a code to indicate the format of the input and output file records:

  • F — Fixed length with no end of record delimiter, pads with blanks to set record length (byte stream, mainframe fixed blocked and unblocked).

  • V — Mainframe (4-byte record) input and output files.

  • L — Line-sequential with delimiter(s) at end of record (for UNIX: new line, 1 byte).

  • U — Variable-length records. File contains an end-of-file indicator. (UNIX environments only).

  • Blank — Default is F.

NOTE: Under UNIX and Windows, variable means ACUCOBOL-GT variable format files. Output files can also be variable in UNIX and Windows.

NOTE: Not valid for file C1BMSTA.


Record Length

Required, except for z/OS. The length, in bytes, of the records in the file. For variable-length records, this is the maximum record length. Maximum is 32,760. No default.

NOTE: If you need to enter a 5-digit number, use columns 18-22.


Block Size

Required, except for z/OS and UNIX. Specify the size, in bytes, of the blocks in the file. No default.

NOTE: Not valid for file C1BMSTA.


Label Type

Optional. Specify a code to indicate whether the records on the file have standard or omitted labels:

  • N — No labels

  • S — Standard labels.

  • Blank — Default is S.

NOTE: Not valid for file C1BMSTA.


Exit Routine Name

Optional. Name of the input exit routine that should be called when CODE-1 Plus is ready to read a record from this file, or the name of the output exit routine that should be called when CODE-1 Plus is ready to write a record to the file. Name must be entered left-justified. No default.

NOTE: Not valid for file C1BMSTA.


Number of Records to Skip

Optional. Number of records CODE-1 Plus should skip before selecting the first record. No default.

NOTE: Not valid for file C1BMSTA.


Fractional Record Selection

Optional. Number indicating the fraction of records in the file that should be processed. CODE-1 Plus assumes a decimal point before the first digit. No default.

NOTE: A number greater than 5000000 selects the entire file.

NOTE: Not valid for file C1BMSTA.


Maximum Number of Records

Optional. Maximum number of records CODE-1 Plus should read from or write to this file. No default.

NOTE: Not valid for file C1BMSTA.