Create Validation List (CRTVLDL)

The Create Validation List (CRTVLDL) command creates a validation list. Validation lists contain entries consisting of an identifier, data that will be encrypted by the system when it is stored, and free-form data. Entries can be added, changed, removed, found, and validated. Entries are validated by providing the correct entry identifier and data that is encrypted. See the APIs topic collection in the Programming category in the IBM i Information Center at http://www.ibm.com/systems/i/infocenter/. for information on how to use validation lists.

Parameters

Keyword Description Choices Notes
VLDL Validation list Qualified object name Required, Positional 1
Qualifier 1: Validation list Name
Qualifier 2: Library Name, *CURLIB
TEXT Text 'description' Character value, *BLANK Optional
AUT Authority Name, *EXCLUDE, *USE, *CHANGE, *ALL Optional

Validation list (VLDL)

Specifies the validation list to be created.

This is a required parameter.

Qualifier 1: Validation list

name
Specify the name to be given to the validation list object.

Qualifier 2: Library

*CURLIB
The validation list is created in the current library. If no library is specified as the current library for the job, QGPL is used.
name
Specify the name of the library where the validation list is created.

Text 'description' (TEXT)

Specifies the text that briefly describes the validation list to be created.

*BLANK
No text is specified.
character-value
Specify no more than 50 characters of text, enclosed in apostrophes.

Authority (AUT)

The authority you are giving to users who do not have specific authority to the object, who are not on an authorization list, and whose group profile or supplemental group profiles have no specific authority to the object.

*EXCLUDE
Exclude authority prevents the user from accessing the object.
*USE
Use authority allows the user to perform finds and validate entries in the validation list.
*CHANGE
Change authority allows the user to add, change, remove, find, and validate entries in the validation list.
*ALL
All authority allows the user to add, change, remove, find, and validation entries in the validation list, and delete the validation list.
name
The name of an authorization list to be used for authority to the object. Users included in the authorization list are granted authority to the object as specified in the list. The authorization list must exist when the object is created.

Examples

CRTVLDL   VLDL(WEBLIB/WEBUSRS)  AUT(*EXCLUDE)
          TEXT('My WEB users')

This command creates a validation list (WEBUSRS) in the WEBLIB library.

Error messages

*ESCAPE Messages

CPF2108
Object &1 type *&3 not added to library &2.
CPF2112
Object &1 in &2 type *&3 already exists.
CPF2113
Cannot allocate library &1.
CPF2151
Operation failed for &2 in &1 type *&3.
CPF2182
Not authorized to library &1.
CPF2183
Object &1 cannot be moved into library &3.
CPF9802
Not authorized to object &2 in &3.
CPF9803
Cannot allocate object &2 in library &3.
CPF9810
Library &1 not found.
CPF9818
Object &2 in library &3 not created.
CPF9819
Object &2 in library &3 not created.