Settings file syntax

The settings file is a standard text file that you can create and edit using any text editor. It consists of up to seven lines (excluding comments):

To mark a line as a comment, include a semicolon (;) at the start of a line.

Line 1 - Input file format

Set the file format to either csv for Comma Separated Values or fixed for Fixed Record Length.

Line 2 - Input fields

Specify the position and length of the fields to be validated, separated with a space. For csv files, set the length to zero.

The number of input fields varies from country to country. If the country includes optional fields, include them but set the start position to zero.

Example:

File format

Value

Meaning

fixed 1 6 7 8 1st input field begins in position 1 with length 6
2nd input field begins in position 7 with length 8
csv 3 0 4 0 1st input field is the 3rd field in the CSV record2nd input field is the 4th field in the
csv 0 0 1 0 1st input field is optional and is not in the input CSV record
2nd input field is the 1st field in the CSV record

Line 3 - Record length

If the input file is a continuous stream of Fixed Length records, use this to specify the length of each record. If the input file contains new line characters, set this to zero.

Line 4 - Skip start of file

Specify the number of records or bytes to skip at the start of the file.

Usage:

File format

Record length

Usage

csv N/A Number of records to skip
fixed not zero Number of bytes to skip
fixed Zero Number of records to skip

Lines 5 and 6 - End of file marker position and end of file marker

If the input file contains an end of file marker or trailer where the FSM should stop processing, use line 5 to specify the position of the marker and line 6 to define the marker.

Usage of line 5:

File format

Usage

csv Field number in the record which contains the string defined in line 6
fixed Input record position of the string defined in line 6

Line 7 - Additional output fields

Specify up to 10 additional fields you want to include in the output file with a position and length for each field separated by spaces. For csv files, set the length to zero.

Example:

File format

Value

Meaning

fixed 28 19 1st additional field begins in position 28 with length 19
csv 7 0 1 0 1st additional field is the 7th field in the CSV record
2nd additional field is the 1st field in the CSV record