Resize Window (QsnRszWin) API


  Required Parameter Group:

1 Window handle Input Binary(4)
2 Number of rows Input Binary(4)
3 Number of columns 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 Resize Window (QsnRszWin) API allows a window to be resized. If a Change Window Coordinates exit routine is specified on the window description, it is called after the window is successfully resized. If the window is a full screen window, the API will complete successfully, but the window will not be moved. Windows where the associated low-level environment indicates DBCS support cannot be resized.


Authorities and Locks

None


Required Parameter Group

Window handle
INPUT; BINARY(4)

A handle for the window to be resized.

Number of rows
INPUT; BINARY(4)

The new value for the number of rows in the window.

Number of columns
INPUT; BINARY(4)

The new value for the number of columns in 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.
CPFA340 E Operation not supported with double-byte data.
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.
CPFA3A5 E Window dimensions not within window limits.
CPFA3AA E Window handle incorrect.


API introduced: V2R3
Top | Dynamic Screen Manager APIs | APIs by category