ALWROL (Allow Roll) Keyword for Display Files--Example

Figure 95 shows how to specify the ALWROL keyword.

Figure 95. Specifying the ALWROL Keyword

|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
00010A    (1)  R RECORD1                   ALWROL OVERLAY  (2)
00020A            FLDA          79   I 23  2CHECK(LC)
00030A  44                           (3)  ERRMSG('Record not found' 44)
     A

(1)
The application program can send an output operation to RECORD1, displaying FLDA on line 23, position 2. In a subsequent output operation, the program can page through RECORD1 (in this case, FLDA) up or down the display or entirely off the display. A normal case would be to page up one line. The originally keyed data is then displayed on line 22, and a new input field is displayed on line 23. The display station user cannot key into, and the program cannot read, the field on line 22. The field on line 22 can be pushed up the display by subsequent output operations in this way until it passes the start line of the window (as specified in the program) or line 1 of the display.

(2)
The OVERLAY keyword prevents paged records from being deleted.

(3)
The ERRMSG keyword is shown to illustrate how ERRMSG affects the ALWROL function. The program cannot at the same time set option indicator 44 on and send an output operation that requests the ALWROL function. If the program does so, the OS/400 program sends a notify message CPF5014.