WINDOW BACKWARD

Read syntax diagramSkip visual syntax diagram WINdow BAckward =1wname=1n*

Authorization

General User

Purpose

Use the WINDOW BACKWARD command to move the window toward the top of the virtual screen so the first data line displayed in the window becomes the last data line displayed.

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 moved backward n displays. The * means scroll to the top. The default is 1 display.

Usage Notes

  1. The WINDOW BACKWARD command is valid only when the window is connected to a virtual screen. For more information, see WINDOW HIDE and WINDOW SHOW.
  2. When you scroll a window backward, only the data area of the screen moves; the reserved lines (PF key definition area and title line) are static.
  3. If the window has been cleared and you scroll the window using WINDOW BACKWARD, you scroll to the bottom of the virtual screen. For more information, see WINDOW CLEAR.
  4. If the window is positioned in the middle of the virtual screen and you scroll backward by specifying an n that would result in moving past the virtual screen top, the window is repositioned at the virtual screen top and stops. If the window is positioned at the virtual screen top and you scroll backward, the window is repositioned at the virtual screen bottom and stops.

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
Virtual screen top or bottom reached, or window is cleared