ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/crtvldl.htm

200 lines
6.7 KiB
HTML

<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Create Validation List (CRTVLDL)</title>
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
</head>
<body bgcolor="white">
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<a name="CRTVLDL.Top_Of_Page"></a>
<h2>Create Validation List (CRTVLDL)</h2>
<table width="100%">
<tr>
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
<b>Threadsafe: </b>Yes
</td>
<td valign="top" align="right">
<a href="#CRTVLDL.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CRTVLDL.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CRTVLDL.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CRTVLDL"></a>
<p>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 System API Reference information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter. for information on how to use validation lists.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTVLDL.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CRTVLDL.PARAMETERS.TABLE">Parameters</a></h3>
<table border="1" cellpadding="4" cellspacing="0">
<!-- col1="10" col2="15" col3="30" col4="10" -->
<tr>
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CRTVLDL.VLDL"><b>VLDL</b></a></td>
<td valign="top">Validation list</td>
<td valign="top"><i>Qualified object name</i></td>
<td valign="top" rowspan="3">Required, Positional 1</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Validation list</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top">Qualifier 2: Library</td>
<td valign="top"><i>Name</i>, <b><u>*CURLIB</u></b></td>
</tr><tr>
<td valign="top"><a href="#CRTVLDL.TEXT"><b>TEXT</b></a></td>
<td valign="top">Text 'description'</td>
<td valign="top"><i>Character value</i>, <b><u>*BLANK</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTVLDL.AUT"><b>AUT</b></a></td>
<td valign="top">Authority</td>
<td valign="top"><i>Name</i>, <b><u>*EXCLUDE</u></b>, *USE, *CHANGE, *ALL</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CRTVLDL.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CRTVLDL.VLDL"></a>
<h3>Validation list (VLDL)</h3>
<p>Specifies the validation list to be created.
</p>
<p>This is a required parameter.
</p>
<p><b>Qualifier 1: Validation list</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name to be given to the validation list object.
</dd>
</dl>
<p><b>Qualifier 2: Library</b>
</p>
<dl>
<dt><b><u>*CURLIB</u></b></dt>
<dd>The validation list is created in the current library. If no library is specified as the current library for the job, QGPL is used.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the library where the validation list is created.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTVLDL.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTVLDL.TEXT"></a>
<h3>Text 'description' (TEXT)</h3>
<p>Specifies the text that briefly describes the validation list to be created.
</p>
<dl>
<dt><b><u>*BLANK</u></b></dt>
<dd>No text is specified.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify no more than 50 characters of text, enclosed in apostrophes.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTVLDL.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTVLDL.AUT"></a>
<h3>Authority (AUT)</h3>
<p>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.
</p>
<dl>
<dt><b><u>*EXCLUDE</u></b></dt>
<dd>Exclude authority prevents the user from accessing the object.
</dd>
<dt><b>*USE</b></dt>
<dd>Use authority allows the user to perform finds and validate entries in the validation list.
</dd>
<dt><b>*CHANGE</b></dt>
<dd>Change authority allows the user to add, change, remove, find, and validate entries in the validation list.
</dd>
<dt><b>*ALL</b></dt>
<dd>All authority allows the user to add, change, remove, find, and validation entries in the validation list, and delete the validation list.
</dd>
<dt><b><i>name</i></b></dt>
<dd>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.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTVLDL.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CRTVLDL.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
CRTVLDL VLDL(WEBLIB/WEBUSRS) AUT(*EXCLUDE)
TEXT('My WEB users')
</pre>
</p>
<p>This command creates a validation list (WEBUSRS) in the WEBLIB library.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTVLDL.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CRTVLDL.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF2108</b></dt>
<dd>Object &amp;1 type *&amp;3 not added to library &amp;2.
</dd>
<dt><b>CPF2112</b></dt>
<dd>Object &amp;1 in &amp;2 type *&amp;3 already exists.
</dd>
<dt><b>CPF2113</b></dt>
<dd>Cannot allocate library &amp;1.
</dd>
<dt><b>CPF2151</b></dt>
<dd>Operation failed for &amp;2 in &amp;1 type *&amp;3.
</dd>
<dt><b>CPF2182</b></dt>
<dd>Not authorized to library &amp;1.
</dd>
<dt><b>CPF2183</b></dt>
<dd>Object &amp;1 cannot be moved into library &amp;3.
</dd>
<dt><b>CPF9802</b></dt>
<dd>Not authorized to object &amp;2 in &amp;3.
</dd>
<dt><b>CPF9803</b></dt>
<dd>Cannot allocate object &amp;2 in library &amp;3.
</dd>
<dt><b>CPF9810</b></dt>
<dd>Library &amp;1 not found.
</dd>
<dt><b>CPF9818</b></dt>
<dd>Object &amp;2 in library &amp;3 not created.
</dd>
<dt><b>CPF9819</b></dt>
<dd>Object &amp;2 in library &amp;3 not created.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTVLDL.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>