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 ]