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

197 lines
6.4 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>Copy Configuration List (CPYCFGL)</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="CPYCFGL.Top_Of_Page"></a>
<h2>Copy Configuration List (CPYCFGL)</h2>
<table width="100%">
<tr>
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
<b>Threadsafe: </b>No
</td>
<td valign="top" align="right">
<a href="#CPYCFGL.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CPYCFGL.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CPYCFGL.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CPYCFGL"></a>
<p>The Copy Configuration List (CPYCFGL) command creates a configuration list as a copy of an existing configuration list.
</p>
<p>
<b>Note: </b>The asynchronous network address list is the only type of configuration list that can be copied.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYCFGL.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CPYCFGL.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"><a href="#CPYCFGL.FROMCFGL"><b>FROMCFGL</b></a></td>
<td valign="top">From configuration list</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#CPYCFGL.CFGL"><b>CFGL</b></a></td>
<td valign="top">Configuration list</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Required, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#CPYCFGL.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="#CPYCFGL.AUT"><b>AUT</b></a></td>
<td valign="top">Authority</td>
<td valign="top"><b><u>*CHANGE</u></b>, *ALL, *USE, *EXCLUDE</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CPYCFGL.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CPYCFGL.FROMCFGL"></a>
<h3>From configuration list (FROMCFGL)</h3>
<p>Specifies the configuration list from which to copy.
</p>
<dl>
<dt><b><i>from-configuration-list</i></b></dt>
<dd>Specify the configuration list being copied from.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYCFGL.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CPYCFGL.CFGL"></a>
<h3>Configuration list (CFGL)</h3>
<p>Specifies the name of the configuration list.
</p>
<dl>
<dt><b><i>list-to-create</i></b></dt>
<dd>Specify the configuration list being created.
</dd>
</dl>
<p>This is a required parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYCFGL.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CPYCFGL.TEXT"></a>
<h3>Text 'description' (TEXT)</h3>
<p>Specifies the text that briefly describes the object.
</p>
<dl>
<dt><b>*BLANK</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="#CPYCFGL.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CPYCFGL.AUT"></a>
<h3>Authority (AUT)</h3>
<p>Specifies the authority you are giving to users who do not have specific authority for the object, who are not on an authorization list, and whose group profile or supplemental group profiles do not have specific authority for the object.
</p>
<dl>
<dt><b><u>*CHANGE</u></b></dt>
<dd>The user can perform all operations on the object except those limited to the owner or controlled by object existence (*OBJEXIST) and object management (*OBJMGT) authorities. The user can change and perform basic functions on the object. *CHANGE authority provides object operational (*OBJOPR) authority and all data authority. If the object is an authorization list, the user cannot add, change, or remove users.
</dd>
</dl>
<dl>
<dt><b>*ALL</b></dt>
<dd>The user can perform all operations except those limited to the owner or controlled by authorization list management (*AUTLMGT) authority. The user can control the object's existence, specify the security for the object, change the object, and perform basic functions on the object. The user also can change ownership of the object.
</dd>
</dl>
<dl>
<dt><b>*USE</b></dt>
<dd>The user can perform basic operations on the object, such as running a program or reading a file. The user cannot change the object. Use (*USE) authority provides object operational (*OBJOPR), read (*READ), and execute (*EXECUTE) authorities.
</dd>
</dl>
<dl>
<dt><b>*EXCLUDE</b></dt>
<dd>The user cannot access the object.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYCFGL.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CPYCFGL.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
CPYCFGL FROMCFGL(CONFIG01) CFGL(CONFIG02)
</pre>
</p>
<p>This command copies the configuration list named CONFIG01 to a new configuration list name CONFIG02.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYCFGL.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CPYCFGL.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF2182</b></dt>
<dd>Not authorized to library &amp;1.
</dd>
<dt><b>CPF260D</b></dt>
<dd>Configuration list &amp;1 already exists.
</dd>
<dt><b>CPF260E</b></dt>
<dd>Configuration list &amp;1 not created.
</dd>
<dt><b>CPF260F</b></dt>
<dd>Configuration list &amp;1 not found.
</dd>
<dt><b>CPF2612</b></dt>
<dd>List type &amp;1 not correct for copy.
</dd>
<dt><b>CPF2625</b></dt>
<dd>Not able to allocate object &amp;1.
</dd>
<dt><b>CPF2634</b></dt>
<dd>Not authorized to object &amp;1.
</dd>
<dt><b>CPF2663</b></dt>
<dd>Configuration list &amp;1 previously deleted.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYCFGL.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>