SCROLL command (full-screen mode)

The SCROLL command provides horizontal and vertical scrolling in full-screen mode. Scroll commands can be made immediately effective with the IMMEDIATE command. The SCROLL keyword is optional.

The Log, Monitor, Memory, or Source window will not wrap around when scrolled.

Read syntax diagramSkip visual syntax diagramSCROLLDOWNLEFTNEXTRIGHTUPCSRDATAHALFintegerMAXPAGEBOTTOMTOintegerTOPCURSORLOGMEMORYMONITORSOURCE;
DOWN
Scrolls the specified number of lines in a window toward the top margin of that window. DOWN is equivalent to NEXT.
LEFT
Scrolls the specified number of columns in a window toward the right margin of that window. If SET MONITOR WRAP OFF is in effect, using LEFT allows you to scroll toward the right the specified number of characters in the monitor value area so data that is not visible to the left becomes visible.
NEXT
Is equivalent to DOWN.
RIGHT
Scrolls the specified number of columns in a window toward the left margin of that window. If SET MONITOR WRAP OFF is in effect, using RIGHT allows you to scroll toward the left the specified number of characters in the monitor value area so data that is not visible to the right becomes visible.
UP
Scrolls the specified number of lines in a window toward the bottom margin of that window.
CSR
Specifies scrolling based on the current position of the cursor in a selected window. The window scrolls up, down, left, or right of the cursor position until the character where the cursor is positioned reaches the edge of the window. If the cursor is not in a window or if it is already positioned at the edge of a window, a full-page scroll occurs. If the cursor is in the monitor value area then the monitor value area is scrolled left or right to the position of the cursor.
DATA
Scrolls by one line less than the window size or by one character less than the window size (if moving left or right). If the cursor is in the monitor value area then the monitor value area scrolls left or right by one character less than the monitor value area width.
HALF
Scrolls by half the window size or by half the monitor value area.
integer
Scrolls the specified number of lines (up or down) or the specified number of characters (left or right). Maximum value is 9999.
MAX
Scrolls in the specified direction until the limit of the data is reached. To scroll the maximum amount, you must use the MAX keyword. You cannot scroll the maximum amount by filling in the scroll amount field. If the cursor is placed in the monitor value area then the monitor value area is scrolled left or right until the limit of the data is reached.
PAGE
Scrolls by the window size or by the monitor value area size.
BOTTOM
Scrolls to the bottom of the data.
TO integer
Specifies that the selected window is to scroll to the given line (as indicated in the prefix area of the selected window). This can be in either the UP or DOWN direction (for example, if you are line 30 and issue TO 20, it will return to line 20). Maximum value is 999999.
TOP
Scrolls to the top of the data.
CURSOR
Selects the window where the cursor is currently positioned.
LOG
Selects the session log window.
MEMORY
Selects the Memory window.
MONITOR
Selects the monitor window.
SOURCE
Selects the source listing window.

Usage notes

  • You cannot use the following commands in the Memory window:
    • SCROLL TOP
    • SCROLL BOTTOM
    • SCROLL TO
    • SCROLL LEFT
    • SCROLL RIGHT
    • SCROLL MAX
  • If you do not specify an operand with the DOWN, LEFT, NEXT, RIGHT, or UP keywords, and the cursor is outside the window areas, the window scrolled is determined by the current default window setting (if the window is open) and the scroll amount is determined by the current default scroll setting, shown in the SCROLL field on the z/OS® Debugger session panel. Default scroll and default window settings are controlled by SET DEFAULT SCROLL and SET DEFAULT WINDOW commands.
  • When the SCROLL field on the z/OS Debugger session panel is typed over with a new value, the equivalent SET DEFAULT SCROLL command is issued just as if you had typed the command into the command line (that is, it is logged and retrievable).
  • The SCROLL command is not logged.
  • To scroll the monitor value area left or right, SET MONITOR WRAP OFF must be in effect and the cursor must be in the monitor value area.
  • When the List pop-up window displays the result of a LIST expression command and you enter a SCROLL DOWN or SCROLL UP command without specifying a window (LOG, MEMORY, MONITOR, or SOURCE), z/OS Debugger applies the command to the List pop-up window. The scrolling amount is always PAGE, regardless of the SET DEFAULT SCROLL setting.

Examples

  • Scroll one page down in the window containing the cursor. 
    SCROLL DOWN PAGE CURSOR;
  • Scroll the monitor window 12 columns to the left. 
    SCROLL LEFT 12 MONITOR;
  • Scroll the monitor value window 15 columns to the right. 
    SET MONITOR WRAP OFF;SCROLL RIGHT 15;
    (Do not press Enter.) Place cursor in the monitor value area. Press Enter.
  • Scroll the Source window to a line breakpoint. 
    LIST AT STATEMENT;
The STATEMENT COB019 ::> COB01A9 :> 56.1 breakpoint action is:
;
SCROLL TO 56;

Refer to the following topics for more information related to the material discussed in this topic.