Use this field-level keyword in the subfile control record format to specify that the workstation user can type a value into this field to tell the i5/OS™ operating system how many records to page up or down when the appropriate paging key is pressed.
This field must have the keyboard shift attribute of signed numeric with zero decimal positions. It can be up to 4 digits in length, and it must be defined as an input/output or input-only field.
This keyword has no parameters.
The workstation user can page through the data being displayed up or down by first typing in the number of records to page through and then pressing the Page Up or the Page Down key. (On subsequent pages, the SFLROLVAL value stays the same unless a new number is typed in before paging.) If a negative number or zero is typed into this field and a Page key is pressed, an error message is displayed at the workstation.
This keyword is valid only for the subfile control record format. You must specify it if the i5/OS operating system is to support the page-by-record function.
If this keyword is not specified, the i5/OS operating system pages through the display by the SFLPAG value except for subfiles using the SFLDROP keyword. If using the SFLDROP keyword, more records are displayed than the SFLPAG value when records are displayed in the truncated format. For truncated records, the i5/OS operating system pages through the display by the number of records displayed in the truncated format.
If subfile size equals subfile page, SFLROLVAL is ignored. When several display sizes are used (DSPSIZ keyword specified), SFLROLVAL is ignored only for display sizes for which subfile size equals subfile page. If the subfile record format contains field selection, SFLROLVAL is not valid.
This field is returned to your program as part of the input for this subfile control record.
If records 1 through 3 are currently displayed, and a Page Up key is entered with a SFLROLVAL value greater than 0, either a message is sent to the workstation user (PAGEUP not specified) or control is returned to the user program (PAGEUP specified; the program has responsibility for paging down).
You cannot specify both the SFLROLVAL and the SFLRCDNBR keywords for the same field.
Option indicators are not valid for this keyword.
The following example shows how to specify the SFLROLVAL keyword.
|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
00010A R SFLR SFL
A*
A* (at least one displayable field)
A*
00040A R SFLCTLR SFLCTL(SFLR)
00050A SFLPAG(17)
00060A SFLSIZ(17)
00070A SFLDSP SFLDSPCTL
00080A ROLVAL 4S 0B 1 47SFLROLVAL
A
(C) Copyright IBM Corporation 1992, 2006. All Rights Reserved.