Use this field-level keyword in the subfile control record format to specify that the workstation user can key a value into this field to tell the OS/400 program 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 output/input or input-only field.
This keyword has no parameters.
The workstation user can page through the data being displayed up or down by first keying 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 keyed in before paging.) If a negative number or zero is keyed 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 OS/400 program is to support the page-by-record function.
If this keyword is not specified, the OS/400 program 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 OS/400 program 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 pressing the Page Up key pages beyond the first page of records of the subfile, one of the following conditions occurs:
If pressing the Page Down key pages beyond the last active record of the subfile, one of the following conditions occurs:
Certain keywords are helpful when specified with SFLROLVAL:
The following examples illustrate the use of SFLROLVAL:
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).
The following shows the conditions that occur when paging beyond the ends of the subfile (when the SFLROLVAL value is greater than the SFLPAG value).
You cannot specify both the SFLROLVAL and the SFLRCDNBR keywords for the same field.
Option indicators are not valid for this keyword.
Example:
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, 2005. All Rights Reserved.