Use this file- or record-level keyword to inform the remote program that the data sent or received was not valid.
This keyword has no parameters.
The FAIL keyword must have an option indicator when it applies to a record that has data fields (use of B or blank) or for which any of the following keywords apply:
| CANCEL |
RQSWRT |
At run time, data fields and these keywords are ignored when the FAIL keyword is in effect. If a FAIL keyword with no option indicator applies to a record for which any of these keywords apply, error messages are issued and these keywords are ignored at creation time. If a FAIL keyword with no option indicator applies to a record with data fields, a severe error is issued and the file will not be created.
The FAIL keyword is ignored at run time when the EOS keyword is in effect. EOS must have an option indicator when it applies to a record for which the FAIL keyword applies. If an EOS keyword with no option indicator applies to a record for which FAIL applies, an error message is issued and the FAIL keyword is ignored at creation time.
FAIL cannot be specified with the TIMER keyword.
Option indicators are valid for this keyword. When you specify this keyword at the file level, you should specify an option indicator.
The following example shows how to specify the FAIL keyword.
|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
00010A R INQ
00020A 99 FAIL
A