WINDOW NEXT
Authorization
General User
Purpose
Use the WINDOW NEXT command to move the window toward the bottom of the virtual screen the number of lines specified.
Operands
- wname
- is the name of the window being scrolled. An = indicates the topmost window is scrolled. If this operand is not specified, = is the default. Only a window defined with the TOP option can qualify as the topmost window.
- n
- if you specify a number for n, the window is scrolled down
n
lines. The * means scroll to the bottom. The default is 1 line.
Usage Notes
- WINDOW NEXT is the same as WINDOW DOWN.
- The WINDOW NEXT command is valid only when the window is connected to a virtual screen. For more information, see WINDOW HIDE and WINDOW SHOW.
- With WINDOW NEXT, only the data area of the screen moves; the reserved lines (PF key definition area and title line) are static.
- If the window is positioned in the middle of the virtual screen and you scroll forward by specifying an "n" which results in scrolling past the bottom, the window is repositioned at the virtual screen bottom, and stops.
- When you receive the status area message
Scroll forward for more information in vscreen vname
(in full-screen CMS) and there are multiple windows showing the specified virtual screen, it is recommended you scroll forward the window closest to the top of the ordered list of windows. This enables data in the virtual screen queue to be written to the virtual screen and displayed. - If the window has been cleared, WINDOW NEXT has no effect. For more information, see WINDOW CLEAR.
Messages and Return Codes
- DMS386E Missing operand(s) [RC=24]
- DMS388E Invalid keyword: keyword [RC=24]
- DMS389E Invalid operand: operand [RC=24]
- DMS391E Unexpected operand(s): operand [RC=24]
- DMS921E Window wname is not defined [RC=28]
- DMS929E Window wname is not connected to a virtual screen [RC=36]
Additional system messages may be issued by this command. The reasons for these messages and their location are:
Reason | Location |
---|---|
Errors in command syntax | Command Syntax Error Messages |
Return codes:
- RC
- Meaning
- 0
- Normal
- 1
- Vscreen top or bottom reached, or window is cleared