DOWN—Scroll Down

The DOWN macro command scrolls data down from the current panel position.

Syntax


Macro command syntax

>>-ISREDIT--DOWN--amt------------------------------------------><

amt

The number of lines (0-9999) to scroll, or one of these operands:

MAX: Scrolls to the end of data in the specified direction.
HALF: Displays the next sequential half panel of data.
PAGE: Displays the next sequential full panel of data.
CURSOR: Scrolls until the line on which the cursor is located becomes the first data line on the panel.
DATA: Scrolls until the last data line on the current panel of data becomes the first data line on the next panel of data.

Description

To scroll down using the panel position when the macro was first issued, use USER_STATE assignment statements to save and then restore the panel position operands.

When you issue DOWN, the non-data lines on the panel affect the number of lines scrolled. However, if you define a macro named DOWN, it only overrides the DOWN command when used from another macro. DOWN does not change the cursor position and cannot be used in an initial macro.

The actual number of lines appearing on the panel is determined by:

The number of lines excluded from the display
The terminal display size and split-panel line
The number of special temporary lines appearing, such as the ==ERR>, ==CHG>, =COLS>, ======, =PROF>, ==MSG>, =NOTE=, =BNDS>, =TABS> or =MASK> lines

The first line appearing is determined in one of two ways: (1) a LOCATE command can set the line first on the panel, and (2) the first line to appear depends on whether the cursor was set explicitly by a CURSOR assignment statement or implicitly by a SEEK, FIND, CHANGE, or TSPLIT command. Since the cursor must be on the panel, the line that is the first line on the panel may be different from the line that was first when you called the macro.

Return codes

0: Normal completion
2: No more data DOWN
4: No visible lines
8: No data to display
12: Amount not specified
20: Severe error

Examples

To scroll down to the end of the data set:

ISREDIT DOWN MAX

To display the next half panel of data:

ISREDIT DOWN HALF

To display the next full panel of data:

ISREDIT DOWN PAGE

To make the line where the cursor is placed the first one on the display:

ISREDIT DOWN CURSOR

To display the next page less one line:

ISREDIT DOWN DATA