Remove Print Application (QUIRMVPA) API


  Required Parameter Group:

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

  Default Public Authority: *USE

  Threadsafe: No

The Remove Print Application (QUIRMVPA) API stops print functions in a previously opened display application. The Add Print Application (QUIADDPA) API and the QUIRMVPA API are used in pairs to add and remove printing from display applications.

The QUIRMVPA API closes the printer file for the application. If the QUIRMVPA API is not performed before the application is closed, the Close Application (QUICLOA) API performs the QUIRMVPA API.


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.

Close option
INPUT; CHAR(1)

Specifies whether or not to perform a normal or abnormal close operation on the printer file. One of the following values must be specified:

A An abnormal close operation is performed, and the trailer message is not printed.
M A normal close operation is performed.

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.
CPF6A1B E Application does not have an open print file.
CPF6A11 E Value is not correct. Reason code is &3.
CPF6A24 E Parameter &1 not passed correctly.
CPF6A25 E Return code length of &1 not valid.
CPF9872 E Program or service program &1 in library &2 ended. Reason code &3.


API introduced: V2R2

[ Back to top | User Interface Manager APIs | APIs by category ]