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

214 lines
7.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>Create Node List (CRTNODL)</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="CRTNODL.Top_Of_Page"></a>
<h2>Create Node List (CRTNODL)</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="#CRTNODL.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CRTNODL.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CRTNODL.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CRTNODL"></a>
<p>The Create Node List (CRTNODL) command allows the user to create a node list object. This object is used to store node names that identify a set of systems in a network.
</p>
<p>
<b>Note: </b>Node lists can be used by system functions to indicate an operation is to be performed on a set of systems.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTNODL.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CRTNODL.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="#CRTNODL.NODL"><b>NODL</b></a></td>
<td valign="top">Node 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: Node 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="#CRTNODL.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="#CRTNODL.AUT"><b>AUT</b></a></td>
<td valign="top">Authority</td>
<td valign="top"><i>Name</i>, <b><u>*LIBCRTAUT</u></b>, *CHANGE, *ALL, *USE, *EXCLUDE</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CRTNODL.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CRTNODL.NODL"></a>
<h3>Node list (NODL)</h3>
<p>Specifies the qualified name of the node list object to be created.
</p>
<p>The node list name can be qualified by one of the following library values:
</p>
<dl>
<dt><b><u>*CURLIB</u></b></dt>
<dd>The node list is created in the current library for the job. If no library is specified as the current library for the job, the QGPL library is used.
</dd>
<dt><b><i>library-name</i></b></dt>
<dd>Specify the name of the library where the node list is to be created.
</dd>
</dl>
<p>The possible values are:
</p>
<dl>
<dt><b><i>node-list-object-name</i></b></dt>
<dd>Specify the name of the node list to be created.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTNODL.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTNODL.TEXT"></a>
<h3>Text 'description' (TEXT)</h3>
<p>Specifies text that briefly describes the node list.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*BLANK</u></b></dt>
<dd>Text is not specified.
</dd>
<dt><b><i>'description'</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="#CRTNODL.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTNODL.AUT"></a>
<h3>Authority (AUT)</h3>
<p>Specifies the authority given to users who do not have specific authority to the object, who are not on the authorization list, and whose user group has no specific authority to the object.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*LIBCRTAUT</u></b></dt>
<dd>The public authority for the object is taken from the CRTAUT value of the target library (the library that is to contain the object). This value is determined when the object is created. If the CRTAUT value for the library changes after the object is created, the new value does not affect any existing objects.
</dd>
<dt><b>*CHANGE</b></dt>
<dd>The user can perform all operations on the file except those limited to the owner or controlled by object existence authority and object management authority. The user can perform basic functions on the file, and the user can change it. Change authority provides object operational authority and all data authority.
</dd>
<dt><b>*ALL</b></dt>
<dd>The user can perform all operations except those limited to the owner or controlled by authorization list management 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 can transfer 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 is prevented from accessing the object.
</dd>
<dt><b><i>authorization-list-name</i></b></dt>
<dd>Specify the name of the authorization list used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTNODL.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CRTNODL.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Node List Creation without Text Description</b>
</p>
<p>
<pre>
CRTNODL NODL(QGPL/NODL01)
</pre>
</p>
<p>This command creates a node list in library QGPL called NODL01. The node list has the same public authority as that defined for QGPL and it does not have a text description.
</p>
<p><b>Example 2: Node List Creation with Text Description</b>
</p>
<p>
<pre>
CRTNODL NODL(MYLIB/NODL02) AUT(*EXCLUDE)
TEXT('This is my Node List number 2')
</pre>
</p>
<p>This command creates node list NODL02 in library MYLIB with public *EXCLUDE authority. The text description for this node list is 'This is my Node List number 2'.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTNODL.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CRTNODL.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>CPF2283</b></dt>
<dd>Authorization list &amp;1 does not exist.
</dd>
<dt><b>CPF9810</b></dt>
<dd>Library &amp;1 not found.
</dd>
<dt><b>CPF9820</b></dt>
<dd>Not authorized to use library &amp;1.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTNODL.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>