Scrolling

Describes scrolling command using the TBDISPL service.
Scrolling lets you move the viewing window up, down, left, and right across the data. In addition to the vertical scrolling supported by the ISPF TBDISPL service through the UP and DOWN system commands, the
RLX
TBDISPL service supports LEFT / RIGHT scrolling of query results too wide to fit on one screen. UP / DOWN scrolling brings new ROWS into view while LEFT / RIGHT scrolling brings new COLUMNS into view.
The headings scroll along with the data as different columns of the ISPF table come into view.
RLX
provides horizontal scroll support automatically when the width of SQL query result columns exceeds the width of the display terminal.
RLX
TBDISPL temporarily overlays any LEFT / RIGHT PF key definitions in the dialog user profile with
RLX
>LEFT and >RIGHT commands. Typically these are PF7/PF22 for >LEFT and PF8/PF23 for >RIGHT.
RLX
saves the dialog user original PF key definitions and restores them before exiting.
It is necessary to key >LEFT and >RIGHT (rather than LEFT and RIGHT) when horizontal scroll commands are entered on the Command line rather than by pressing a PF key. The > prefix ensures that the command is passed to the
RLX
TBDISPL service. Otherwise, ISPF rejects the command as an unsupported function.

Scroll Amounts

The scroll amount field at the far right of line 2 of the display governs the number of lines or columns that are scrolled with each command. You can overtype the scroll amount.
Scroll ===> HALF
Valid scroll amounts and the number of columns scrolled left or right with each command are as follows:
  • A number from 1 to 9999 scrolls by that number of characters
  • PAGE - scrolls by the amount of information currently visible on a page. The page scroll amount for >LEFT and >RIGHT commands depends on the logical screen width which varies with terminal type
  • HALF - specifies scrolling by half a page
  • MAX - specifies scrolling to the top, bottom, left margin, or right margin, depending upon which scrolling command is used.
  • CSR - behaves like a PAGE scroll when used with >LEFT and >RIGHT commands.
You can also enter a scroll amount directly in the Command field -- to be used with the current scroll command only. In the first example, both the scroll command and scroll amount are keyed into the Command field. The ENTER key is then pressed.
COMMAND ===> >RIGHT 3
In this second example, you key just the scroll amount and press the >RIGHT PF key.
COMMAND ===> 3

Horizontal Character Scrolling

Commands like >RIGHT 10 or >LEFT 4 produce a horizontal scroll by some integer number of characters or bytes. However,
RLX
TBDISPL scrolls the width of at least one query result column in response to a character scroll request. For example, when the datatype of the query result column is CHAR(5) and a >RIGHT 3 scroll command is entered,
RLX
scrolls right five characters to position to the next column.

Column Scrolling

Column scrolling shifts the display horizontally by some number of query result columns. With Column scrolling, the width of the entire column counts as one, regardless of the query result column width in characters. The next two panels, illustrate the before and after display associated with the following RIGHT column scroll command.
COMMAND ===> RIGHT COL 2
SQL Query Result 'DATATYPE' -------------------------------------- ROW 1 OF 14 Command ===> Scroll ===> HALF SEL DATE TIME MDV008 FLOAT 6(DATE) 7(TIME) 8(TIMESTAMP) 9(FLOAT) 1989-01-21 16.42.23 2003-01-21-16.42.23.123450 57 1989-01-21 16.42.23 2003-01-21-16.42.23.123450 58 1989-01-21 16.42.23 2003-01-21-16.42.23.123450 59 1989-01-21 16.42.23 2003-01-21-16.42.23.123450 3.1415920257568E+00 1989-01-21 16.42.23 2003-01-21-16.42.23.123450 3.1415920257568E+00 1989-01-21 16.42.23 2003-01-21-16.42.23.123450 3.1415920257568E+00 1988-11-23 13.24.23 - 3.1415920257568E+00 1989-01-21 16.42.23 2003-01-21-16.42.23.123450 3.1415920257568E+00 1988-11-23 13.24.23 - 3.1415920257568E+00 1989-01-21 16.42.23 2003-01-21-16.42.23.123450 3.1415920257568E+00 1989-01-21 16.42.23 2003-01-21-16.42.23.123450 3.1415920257568E+00 1992-10-18 11.16.45 - 3.1415920257568E+00 1992-10-18 11.16.45 - 3.1415920257568E+00 1992-10-18 11.16.45 - 3.1415920257568E+00
The following panel illustrates how
RLX
scrolls the display the width of two query result columns.
SQL Query Result 'DATATYPE' -------------------------------------- ROW 1 OF 14 Command ===> Scroll ===> HALF SEL MDV008 FLOAT 8(TIMESTAMP) 9(FLOAT) 2003-01-21-16.42.23.123450 57 2003-01-21-16.42.23.123450 58 2003-01-21-16.42.23.123450 59 2003-01-21-16.42.23.123450 3.1415920257568E+00 2003-01-21-16.42.23.123450 3.1415920257568E+00 2003-01-21-16.42.23.123450 3.1415920257568E+00 - 3.1415920257568E+00 2003-01-21-16.42.23.123450 3.1415920257568E+00 - 3.1415920257568E+00 2003-01-21-16.42.23.123450 3.1415920257568E+00 2003-01-21-16.42.23.123450 3.1415920257568E+00 - 3.1415920257568E+00 - 3.1415920257568E+00 - 3.1415920257568E+00