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

Use these file- or record-level keywords to specify that you want to use your program to handle any situation where the workstation user has pressed the Page Down or Page Up keys and the i5/OS™ operating system cannot page through the display.

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

See the System/36 environment considerations for display files topic for special considerations when specifying 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 i5/OS 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 i5/OS 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 i5/OS 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 the SFLROLVAL (Subfile Roll Value) keyword for display files topic.

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