Open Display Application (QUIOPNDA) API
Required Parameter Group:
| 1 | Application handle | Output | Char(8) |
| 2 | Qualified panel group name | Input | Char(20) |
| 3 | Application scope | Input | Binary(4) |
| 4 | Exit parameter interface | Input | Binary(4) |
| 5 | Full-screen help | Input | Char(1) |
| 6 | Error code | I/O | Char(*) |
Optional Parameter Group:
| 7 | Open data receiver | Output | Char(*) |
| 8 | Length of open data receiver | Input | Binary(4) |
| 9 | Length of available open data | Output | Binary(4) |
Default Public Authority: *USE
Threadsafe: No
The Open Display Application (QUIOPNDA) API initiates a UIM display application by opening the panel group that the application program specifies. The QUIOPNDA API and the Close Application (QUICLOA) API must be used in pairs to open and close each UIM display application.
Multiple applications can be opened at the same time. Each open application
contains a complete set of dialog variables and active lists, and is
independent of other open applications. A panel group can be opened more than
once per job, but each call of the QUIOPNDA API initiates a new UIM display
application and returns a unique application handle.
Authorities and Locks
- Library Authority
- *READ
- Panel Group Authority
- *USE
- Panel Group Lock
- *SHRRD
Required Parameter Group
- Application handle
- OUTPUT; CHAR(8)
The application handle for the opened application. The QUIOPNDA API returns a unique handle for each application opened. This handle must be provided as a parameter to every other UIM API that operates on the application, including the QUICLOA API, which must be used to close the application.
- Qualified panel group name
- INPUT; CHAR(20)
The name of the *PNLGRP object opened for this UIM application. The first 10 characters contain the name of the *PNLGRP object, and the second 10 characters contain the name of the library in which the panel group resides. These special values can be used for the library name:
*CURLIB The job's current library *LIBL The library list
- Application scope
- INPUT; BINARY(4)
The scope of the resources for the application. The UIM uses the scope to determine whether or not to automatically close the application when reclaim resource processing is performed through the Reclaim Resource command (RCLRSC), the Reclaim Activation Group command (RCLACTGRP), or the End Request command (ENDRQS). During reclaim resource processing, the UIM closes all applications whose scope is no longer active.
One of the following values must be used:
-1 The calling program is the scope for the application. If the calling program is an original program model (OPM) program and the application program is no longer active, the UIM will automatically close the application during reclaim resource processing. If the calling program is an Integrated Language Environment® (ILE) program and the activation group mark is no longer active, the UIM will automatically close the application during reclaim resource processing. 0 The job is the scope for the application. The application is not automatically closed by the UIM until the job is ended.
- Exit parameter interface
- INPUT; BINARY(4)
The type of parameter interface used with exit programs and programs called as a result of the CALL dialog command for the UIM application being opened.
All exit and CALL programs receive a single parameter or multiple parameters, which are space pointers to information describing the state of the UIM application.
One of the following values must be used:
0 Used by programs written in languages that can efficiently process structures. 1 Used by programs written in languages that cannot efficiently process structures. This value indicates that all application programs called as exits or as a result of the CALL dialog command accept the parameter lists described for interface level 1. 2 Used by programs written in languages that cannot efficiently process structures. This value indicates that all application programs called as exits or as a result of the CALL dialog command accept the parameter lists described for interface level 2. For a detailed description of the structure passed for each type of exit and CALL program and for a description of the exit parameter lists, see User Interface Manager Exit Programs.
- Full-screen help
- INPUT; CHAR(1)
Determines whether or not the UIM help for the application is displayed in pop-up windows or with a full screen. One of the following values must be used:
Y The online help information is displayed with a full screen. N The online help information is displayed using pop-up windows, unless the user profile indicates that help is displayed with a full screen.
- Error code
- I/O; CHAR(*)
The structure in which to return error information. For the format of the structure, see Error code parameter.
Optional Parameter Group
- Open data receiver
- OUTPUT; CHAR(*)
The receiver variable that is to receive the open data information requested. For the format of the open data receiver variable, see Format of Data Returned.
- Length of open data receiver
- INPUT; BINARY(4)
The amount of data the application program is prepared to receive. If the length specified is larger than the amount of data available, the receiver is not changed beyond the amount of data available. If the length specified is greater than the actual length of the open data receiver parameter, unpredictable results may occur.
- Length of available open data
- OUTPUT; BINARY(4)
The length of all open data available. All available open data is returned if enough space is provided.
Format of Data Returned
The format of the data available, returned in the open data receiver parameter, is as follows:
| CHAR(1) | Whether or not an error occurred while attempting
to obtain the conversion tables needed to process the panel group. The
conversion tables are needed when the CHRID attribute of the panel group is not
equal to the CHRID attribute of the device, or when the CHRID attribute of the
panel group is *JOBCCSID and the job CCSID is not equal to the device CHRID. A
CPD6A2A diagnostic message will be logged in the job log for each conversion
table that is not found.
One of the following values is returned:
|
||||
| CHAR(1) | Whether or not the conversion of data from the
job to the device and from the device to the job will result in loss of
fidelity of the data. Conversion will be done when the CHRID attribute of the
panel group is not equal to the CHRID attribute of the device, or when the
CHRID attribute of the panel group is *JOBCCSID and the job CCSID is not equal
to the device CHRID.
One of the following values is returned:
|
Error Messages
| Message ID | Error Message Text |
|---|---|
| CPF3C90 E | Literal value cannot be changed. |
| CPF6A1E E | Object cannot be used with this device or print file. |
| CPF6A12 E | Unable to open panel group. |
| CPF6A17 E | Panel group &1 in library &2 is not at the current release level. |
| CPF6A2A E | Value for Application Scope parameter not valid. |
| CPF6A2E E | Value for Exit Parameter Interface parameter not valid. |
| CPF6A2F E | Value for Full-screen Help parameter not valid. |
| CPF6A24 E | Parameter &1 not passed correctly. |
| CPF6A25 E | Return code length of &1 not valid. |
| CPF6A26 E | Resources not available to open application. |
| CPF6A3A E | Value for Open Data Receiver is not valid. Reason code &1. |
| 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 ]