ERRSFL (Error Subfile) keyword for display files

You use this file-level keyword to specify that messages should be displayed using a system-supplied error subfile.

Messages that display in the error subfile are system validity check messages and messages associated with the following keywords:

Validity check messages associated with the following input errors are also displayed in the error subfile:
  • Errors in floating point operations
  • Decimal position entry errors

This allows you to page through all the error messages issued when a record is written to the display, and all the validity check error messages issued when a record is read from the display. The system displays the error subfile on the message line. If the message line overlaps a record already displayed on the screen, the ERRSFL keyword is ignored.

This keyword has no parameters.

Option indicators are not valid for this keyword.

Example

The following example shows how to specify the ERRSFL keyword.

|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
00010A                                      MSGLOC(24)
00020A                                      ERRSFL
00030A          R RCD1
00040A            FIELD1        5A   B  2  3
00050A  10                                  ERRMSGID(MSG0001 MSGF1 10 &MDTA);
00060A            FIELD2        5A   B  5  7
00070A                                      ERRMSG('ERROR MSG 1' 11)
00080A            FIELD3        4S   I  7  7RANGE(1000 9999)
00090A                                      CHKMSGID(MSG0002 MSGF1 &MDTA1);
00100A            FIELD4       10A   B  8  7CHECK(VN)
00110A            MDTA         78A   P
00120A            MDTA1         4A   P
     A

In this example, when RCD1 is read from the display, any previous messages in the error subfile are cleared. Then, if FIELD3 does not contain a value in the range 1000 to 9999 and FIELD4 does not contain a valid name, the system places the message MSG0002 and the system message associated with CHECK(VN) in the error subfile and displays the error subfile on line 24 of the display. The user can view the messages by pressing the Page Up and Page Down keys.

When RCD1 is read again from the display, the previous messages in the error subfile are cleared. Then, if FIELD3 and FIELD4 are valid, control returns to the application. If FIELD1 and FIELD2 are not valid, when the application writes RCD1 to the display with indicators 10 and 11 on, the system places the message MSG0001 and the text ERROR MSG 1 in the error subfile and displays the error subfile on line 24 of the display. The user can view the messages by pressing the Page Up and Page Down keys.