Remove Pop-Up Window (QUIRMVPW) API


  Required Parameter Group:

1 Application handle Input Char(8)
2 Remove option Input Char(1)
3 Error code I/O Char(*)

  Default Public Authority: *USE

  Threadsafe: No

The Remove Pop-Up Window (QUIRMVPW) API removes the pop-up window created by the Add Pop-Up Window (QUIADDPW) API. After calling the QUIRMVPW API, subsequent calls to the Display Panel (QUIDSPP) API display either a full-screen panel or a panel in a pop-up window defined by a previous call of the QUIADDPW API. A pop-up window cannot be removed if an action or exit program is currently being processed for a panel displayed in that pop-up window.


Authorities and Locks

None.


Required Parameter Group

Application handle
INPUT; CHAR(8)

The application handle assigned by the UIM and returned to the application program by the Open Display Application (QUIOPNDA) API when the application is opened.

Remove option
INPUT; CHAR(1)

The pop-up windows that are removed from the open application. One of the following values must be used:

I All inactive pop-up windows. A pop-up window is inactive if there are no panels currently displayed in that window.
L The most recently added pop-up window.

Error code
I/O; CHAR(*)

The structure in which to return error information. For the format of the structure, see Error Code Parameter.

Error Messages

Message ID Error Message Text
CPF3C90 E Literal value cannot be changed.
CPF6A0B E Application handle &3 not valid.
CPF6A0C E Application domain error for application &1.
CPF6A0F E Previous error occurred while running application &3.
CPF6A24 E Parameter &1 not passed correctly.
CPF6A25 E Return code length of &1 not valid.
CPF6A3E E Application not open for display.
CPF6A84 E Window cannot be removed at this time.
CPF6A90 E Value not correct. Reason code &3.
CPF9872 E Program or service program &1 in library &2 ended. Reason code &3.


API introduced: V2R2
Top | User Interface Manager (UIM) APIs | APIs by category