WINDOW POSITION

Authorization

General User

Purpose

Use the WINDOW POSITION command to change the location of a window on the physical screen.

Operands

wname

is the name of the window to be moved. An = indicates the topmost window is moved. Only a window defined with the TOP option can qualify as the topmost window.

psline

is the line on the physical screen where the upper or lower edge of the window is positioned. A positive number positions the upper edge of the window on the specified line relative to the top of the screen. A negative number positions the lower edge of the window on the specified line relative to the bottom of the screen.

pscol

is the column on the physical screen where the left edge of the window is positioned.

Usage Notes

1. The window's size and location must be such that, excluding borders, the entire window fits on the physical screen.
2. The variable psline may be specified as either a positive or a negative number. When positive, the window's upper left corner is placed on the physical screen at the line and column number specified. When negative, the window's lower left corner is placed relative to the bottom of the physical screen. Thus, a psline value of +1 positions a window by its upper left corner to the top line of the physical screen. A psline value of -1 positions it by its lower left corner to the bottom line of the physical screen.

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]
• DMS922E Window does not fit entirely on the screen [RC=32]

Additional system messages may be issued by this command. The reasons for these messages and their location are: