Parsing Parameter String Options
Variable Length Fields
Variable Length Field Name |
Selector |
Comments |
---|---|---|
Transit Number |
T |
Full 9 digit routing/transit number |
Bank Number |
B |
Digits 4-8 of transit number |
Check Digit |
D |
Digit 9 of transit number |
Account Number |
A |
|
Check Serial Number |
C |
Separate from account number |
Amount |
$ |
This field may not be present or readable |
Variable Length Field Optional Modifiers |
Selector |
Comments |
---|---|---|
Zero fill to length |
0 |
ASCII zero preceding maximum length |
Maximum length |
nn |
1- or 2-digit ASCII number |
Remove space/dash |
X |
|
Replace space/dash with 0 |
x |
|
Examples of Variable Length Field Format Specifications |
|
---|---|
Examples of Variable Length Field Format Specifications |
|
Account #, all characters in the field, keep spaces and dashes |
A |
Account #, all characters in the field, replace spaces and dashes |
xA |
Account #, maximum 12 characters, keep spaces and dashes |
12A |
Account #, always 12 characters zero filled, remove spaces and dashes |
012XA |
Other Parameters
Error Number |
E |
One Digit Returned |
|
|
•0—Read OK •1—Read error: bad character, empty field, invalid length, check digit invalid |
Status |
S |
Two Digits Returned |
|
|
•00—No error •01—No MICR data •09—Mexican check •08—Canadian check •05—Error in transit number •07—Error in account number •04—Error in check serial number •10—Business or commercial check •11—Amount field present |
Field Separator |
'x |
|
|
|
•Field separator preceded by a single quote, so a field separator of the letter A would be sent as 'A (0x27 0x41). •If a Carriage Return is specified as a separator (0x27 0x0D), a final Carriage Return must still terminate the parsing parameter string. |
Country Code |
Un |
One Digit Returned |
|
•N—returned if US check •(Nothing)—returned if not US check |
|
Country Code |
Km |
One Digit Returned |
|
•M—returned if Canadian check •(Nothing)—returned if not Canadian check |
|
Check Type |
L |
One Digit Returned |
|
|
•1—Personal check •2—Business or commercial check |
Ten parameters are more than enough to specify all variable length fields with a field separator each and other status information that may be helpful to an application. More than 10 parameters are not recommended because they use up space in non-volatile memory (NVRAM) available for the exception table.
The parsing parameter string is stored packed in NVRAM starting at word 10, with the total byte length stored in the high order byte of word 10. While most parameters take two bytes of NVRAM, the following parameters take only one byte: B, D, E, S, L. None of the parsing examples in the following section take more than 14 bytes (seven words) of NVRAM.
The exception table starts at word 20. If the parsing parameter string extends into word 20, then the first exception table entry is unavailable.