Remove List Entry (QUIRMVLE) API
Required Parameter Group:
|4||List entry handle||Output||Char(4)|
Default Public Authority: *USE
The Remove List Entry (QUIRMVLE) API removes the list entry identified by the value of the current entry pointer for the list. The current entry pointer is always updated to the entry before the one removed. If the first list entry is removed, the current entry pointer is set to the top of the list if the list is complete at the top.
If the list is incomplete at the top, the UIM calls the incomplete list extension program to add another entry to the list.
If the list entry identified by the display position attribute parameter of the Set List Attributes (QUISETLA) API is removed, the display position attribute is set at the entry before the one that was removed. If the new display position attribute is the first entry in the list, the display position attribute is set at the top of the list (logically the entry before the first entry in the list) if the list is complete at the top.
Authorities and Locks
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 or the Open Print Application (QUIOPNPA) API when the application is opened.
- List name
- INPUT; CHAR(10)
The name of the list from which an entry is removed. If the list is not currently active in the open application, an error message is reported. A list is made active the first time an entry is inserted with the Add List Entry (QUIADDLE) API, Add List Multiple Entries (QUIADDLM) API, or its attributes are set with the QUISETLA API.
- Extend option
- INPUT; CHAR(1)
Specifies whether or not an incomplete list is automatically extended in an attempt to remove the first entry from a list that is incomplete at the top. One of the following values must be specified:
Y The list is extended, if necessary, to add at least one entry to the top of the list or to mark the list as complete at the top. N The list is not extended to find the entry before the entry being removed, and the entry is not removed from the list.
- List entry handle
- OUTPUT; CHAR(4)
The list entry handle value from the current entry pointer. A list entry handle uniquely distinguishes an entry until it is removed from the list, even if other entries are inserted and removed from the list. A value of TOP indicates that the current entry pointer is positioned at the top of the list.
- Error code
- I/O; CHAR(*)
The structure in which to return error information. For the format of the structure, see Error code parameter.
|Message ID||Error Message Text|
|CPF3C90 E||Literal value cannot be changed.|
|CPF6AA0 E||Request is not allowed when extending a list that is not complete.|
|CPF6A0B E||Application handle &3 not valid.|
|CPF6A0C E||Application domain error for application &1.|
|CPF6A0F E||Previous error occurred while running application &3.|
|CPF6A13 E||Application &3 closed prematurely.|
|CPF6A14 E||Program defined by variable &4 cannot be called.|
|CPF6A15 E||Errors occurred in list exit program.|
|CPF6A24 E||Parameter &1 not passed correctly.|
|CPF6A25 E||Return code length of &1 not valid.|
|CPF6A27 E||Value for Extend Option parameter not valid.|
|CPF6A91 E||List &4 does not exist.|
|CPF6A92 E||List &4 not active.|
|CPF6A93 E||Operation not valid when current entry is &5.|
|CPF6A94 E||Incomplete list &4 requires extension.|
|CPF6A95 E||List &4 either not complete or not extended.|
|CPF9872 E||Program or service program &1 in library &2 ended. Reason code &3.|
API introduced: V2R2