Move Window (QsnMovWin) API


  Required Parameter Group:

1 Window handle Input Binary(4)
2 Upper left row Input Binary(4)
3 Upper left column Input Binary(4)

  Omissible Parameter:

4 Error code I/O Char(*)

  Returned Value:

Return code Output Binary(4)

  Default Public Authority: *USE

  Service Program: QSNAPI

  Threadsafe: No

The QsnMovWin API moves the window to the new upper left coordinate (upper left row, upper left column) specified. If the window can fit within the display at the location specified, it is moved to the new position. If a Change Window Coordinates exit routine is specified on the window description, it is called after the window is successfully moved. If the window is a full screen window, the API will complete successfully, but the window will not be moved.


Authorities and Locks

None.


Required Parameter Group

Window handle
INPUT; BINARY(4)

A handle for the window to be moved.

Upper left row
INPUT; BINARY(4)

The absolute screen row for the new upper left corner of the window.

Upper left col
INPUT; BINARY(4)

The absolute screen column for the new upper left corner of the window.


Omissible Parameter

Error code
I/O; CHAR(*)

The structure in which to return error information. For the format of the structure, see Error code parameter. If this parameter is omitted, diagnostic and escape messages are issued to the application.


Returned Value

Return code
OUTPUT; BINARY(4)

A return code indicating the result of the operation. The value returned will be 0 if the operation was successful, or -1 otherwise.


Error Messages

Message ID Error Message Text
CPF24B4 E Severe error while addressing parameter list.
CPF3CF1 E Error code parameter not valid.
CPF3CF2 E Error(s) occurred during running of &1 API.
CPFA318 E Error calling exit routine.
CPFA31E E Required parameter &1 omitted.
CPFA343 E Output operation not done.
CPFA344 E The file &2 in library &3 is not valid.
CPFA345 E The invite active flag is not valid.
CPFA3A2 E Window does not fit on screen.
CPFA3A4 E Specified window is not active.
CPFA3AA E Window handle incorrect.


API introduced: V2R3

[ Back to top | Dynamic Screen Manager APIs | APIs by category ]