ROLLUP/ROLLDOWN (Roll Up/Roll Down) keywords for display files

You can use these file-level or record-level keywords to specify that your program handles any situation where the workstation user has pressed the Roll Up or Roll Down keys and the IBM® i operating system cannot move the text lines on the display.

If this situation occurs and you have not specified this keyword (whichever one is appropriate), the IBM i operating system sends an error message indicating that the key is not valid at that time.

See System/36 environment considerations for display files for special considerations when you specify the ROLLUP and ROLLDOWN keywords in files that are used in the System/36 environment.

The format for each of these keywords is:

ROLLUP[(response-indicator ['text'])]
ROLLDOWN[(response-indicator ['text'])]

You can specify a response indicator with these keywords. If you do, and the appropriate paging key is pressed, the IBM i operating system sets on the specified response indicator within the input record and returns control to your program after it processes the input data. If you do not specify a response indicator and the specified paging key is pressed, the IBM i operating system performs normal input record processing.

The optional text is included on the computer printout created at program compilation to explain the intended use of the indicator. This text functions only as a comment in the file or program. The single quotation marks are required. If you specify more than 50 characters between the single quotation marks, the text is truncated to 50 characters on the program computer printout.

These keys cause data to be returned from the display device to your program (similar to command function (CF) and Enter keys).

The PAGEDOWN keyword cannot be specified with ROLLUP. The PAGEUP keyword cannot be specified with ROLLDOWN.

Note: The ROLLUP keyword is the same as the PAGEDOWN keyword. The ROLLDOWN keyword is the same as the PAGEUP keyword. Roll is the same as page.

If the operating system is performing the paging function for subfiles (SFLSIZ value does not equal SFLPAG value), you do not need to specify these keywords. For a description of what happens when the ROLLUP and ROLLDOWN keywords are specified for a subfile, see SFLROLVAL (Subfile Roll Value) keyword for display files.

Option indicators are valid for these keywords.

Example

The following example shows how to specify the ROLLUP and ROLLDOWN keywords.

|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
00010A N64                                  ROLLDOWN(52 'Roll Down')
     A                                      ROLLUP(61)
     A