RIGHT—Scroll Right

The RIGHT macro command scrolls data to the right of the current panel position.

Syntax


Macro command syntax

>>-ISREDIT--RIGHT--amount--------------------------------------><

amount

The scroll amount. The number of columns (0-9999) to scroll,

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

Description

The editor stops scrolling when it reaches the current BOUNDS setting. For example, if the right bound is position 100, and positions 9 to 80 are displayed, issuing ISREDIT RIGHT 100 leaves positions 29 to 100 being displayed, not positions 109 to 180.

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

If you define a macro named RIGHT, it overrides RIGHT when used from another macro, but has no effect for you. RIGHT does not change the cursor position and cannot be used in an initial macro. See BOUNDS—Set or Query the Edit Boundaries and DISPLAY_COLS—Query Display Columns for further information.

Return codes

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

Examples

To scroll the display to the right by the number of columns specified in variable &RCOL:

ISREDIT RIGHT &RCOL