UP—Scroll Up

The UP macro command scrolls data up from the current panel position.

Syntax


Macro command syntax

>>-ISREDIT--UP--amt--------------------------------------------><

amt

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

MAX: Displays the first panel of data.
HALF: Displays the previous half-panel of data.
PAGE: Displays the previous full panel of data.
CURSOR: Scrolls until the line on which the cursor is located becomes the last data line on the panel.
DATA: Scrolls until the first data line on the current panel becomes the last data line on the next panel.

Description

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

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

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

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

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

Return codes

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

Examples

To scroll up to the top of the data set:

ISREDIT UP MAX

To display the previous half panel of data:

ISREDIT UP HALF

To display the previous full panel of data:

ISREDIT UP PAGE

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

ISREDIT UP CURSOR

To display the previous page less one line:

ISREDIT UP DATA