Remove Validation List Entry (QSYRMVLE) API
Required Parameter Group:
1 | Qualified validation list name | Input | Char(20) |
2 | Entry ID information | Input | Char(*) |
3 | Error code | I/O | Char(*) |
Service Program Name: QSYVLDL
Default Public Authority: *USE
Threadsafe: Yes
The Remove Validation List Entry (QSYRMVLE) API removes an entry from a
validation list object. To identify an entry to be removed, there must be an
exact match in the entry for the value that is specified in the entry ID
parameter and the length of the entry ID. For example, an entry ID value of
"SMITH" with a length of 5 would not remove an entry where the entry ID is
"SMITH " and the length is 7.
Authorities and Locks
- Validation List Object
- *USE and *DLT
- Validation List Object Library
- *EXECUTE
Required Parameter Group
- Qualified validation list name
- INPUT; CHAR(20)
The qualified object name of the validation list that contains the entry to remove. The first 10 characters specify the validation list name, and the second 10 characters specify the library. You can use these special values for the library name:
*CURLIB The current library is used to locate the validation list. If there is no current library, QGPL (general purpose library) is used. *LIBL The library list is used to locate the validation list.
- Entry ID information
- INPUT; CHAR(*)
The format of the entry ID information is as follows. See the Field Descriptions for more information.
Offset Type Field Dec Hex 0 0 BINARY(4) Length of entry ID 4 4 BINARY(4) CCSID of entry ID 8 8 CHAR(*) Entry ID
- Error code
- I/O; CHAR(*)
The structure in which to return error information. For the format of the structure, see Error code parameter.
Field Descriptions
CCSID of entry ID. An integer that represents the CCSID for the entry ID. Valid CCSID values are in the range 0 through 65535. This field is not used to remove the entry.
Entry ID. The data that is used to identify the entry to be removed from the validation list.
Length of entry ID. The number of bytes of data that is
provided as the entry ID. Possible values are 1 through 100.
Error Messages
Message ID | Error Message Text |
---|---|
CPF226B E | Validation list entry does not exist. |
CPF3CF1 E | Error code parameter not valid. |
CPF3C36 E | Number of parameters, &1, entered for this API was not valid. |
CPF3C90 E | Literal value cannot be changed. |
CPF9801 E | Object &2 in library &3 not found. |
CPF9802 E | Not authorized to object &2 in &3. |
CPF9803 E | Cannot allocate object &2 in library &3. |
CPF9804 E | Object &2 in library &3 damaged. |
CPF9872 E | Program or service program &1 in library &2 ended. Reason code &3. |
API introduced: V4R2
[ Back to top | Security APIs | APIs by category ]