PAGEDOWN/PAGEUP (Page Down/Page Up) keywords for display files

You use these file-level or record-level keywords to specify that your program handles any situation where the workstation user has pressed the Page Down or Page Up keys and the IBM® i operating system cannot page through 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 PAGEDOWN/PAGEUP keywords in files that are used in the System/36 environment.

The format for each of these keywords is:

PAGEDOWN[(response-indicator ['text'])]
PAGEUP[(response-indicator ['text'])]

You can specify a response indicator with these keywords. If you do, and the appropriate Page 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 Page 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 ROLLUP keyword cannot be specified with PAGEDOWN. The ROLLDOWN keyword cannot be specified with PAGEUP.

Note: PAGEDOWN is the same as ROLLUP; PAGEUP is the same as ROLLDOWN.

If the operating system is performing the page 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 PAGEDOWN and PAGEUP 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 PAGEDOWN and PAGEUP keywords.

|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
00010A N64                                  PAGEUP(52 'Page Up')
     A                                      PAGEDOWN(61)
     A