324 lines
11 KiB
HTML
324 lines
11 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>Add Node List Entry (ADDNODLE)</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="ADDNODLE.Top_Of_Page"></a>
|
|
<h2>Add Node List Entry (ADDNODLE)</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="#ADDNODLE.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#ADDNODLE.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#ADDNODLE.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="ADDNODLE"></a>
|
|
<p>The Add Node List Entry (ADDNODLE) command adds a new entry to an existing node list object.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDNODLE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="ADDNODLE.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="#ADDNODLE.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>, *CURLIB, <b><u>*LIBL</u></b></td>
|
|
</tr><tr>
|
|
<td valign="top" rowspan="3"><a href="#ADDNODLE.RMTLOCNAME"><b>RMTLOCNAME</b></a></td>
|
|
<td valign="top">Remote location</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Name or address</td>
|
|
<td valign="top">
|
|
<i>Character value</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Type</td>
|
|
<td valign="top">
|
|
<b><u>*SNA</u></b>, *IP</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDNODLE.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" rowspan="3"><a href="#ADDNODLE.CPNAME"><b>CPNAME</b></a></td>
|
|
<td valign="top">SNA node name</td>
|
|
<td valign="top">Single values: <b><u>*RMTLOC</u></b><br>Other values: <i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Network identifier</td>
|
|
<td valign="top">
|
|
<i>Communications name</i>, *NETATR</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Control point</td>
|
|
<td valign="top">
|
|
<i>Communications name</i></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDNODLE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="ADDNODLE.NODL"></a>
|
|
<h3>Node list (NODL)</h3>
|
|
<p>Specifies the qualified name of the node list object to which the entry is added.
|
|
</p>
|
|
<p>The node list name can be qualified by one of the following library values:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the job is searched. 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 to be searched.
|
|
</dd>
|
|
</dl>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>node-list-name</i></b></dt>
|
|
<dd>Specify the name of the node list to which the entry is added.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDNODLE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDNODLE.RMTLOCNAME"></a>
|
|
<h3>Remote location (RMTLOCNAME)</h3>
|
|
<p>Specifies the name and address type of the system to add to the list object. The name can be an SNA network ID and control point name, an internet protocol host name, or an internet address.
|
|
</p>
|
|
<p>An SNA node name is specified using the format nnnnnnnn.cccccccc, where nnnnnnnn is the network ID and cccccccc is the control point name. If only the control point name is specified, the local network ID (LCLNETID) network attribute is used as the value of the network identifier (ID) of the system being added to the node list. If the LCLNETID network attribute is changed, the new value does not affect the existing entries.
|
|
</p>
|
|
<p>A host name must follow these conventions:
|
|
</p>
|
|
<ul>
|
|
<li>The first character must be either an English alphabetic character or a numeric character.
|
|
</li>
|
|
<li>The last character must be either an English alphabetic character or a numeric character.
|
|
</li>
|
|
<li>Blanks ( ) are not allowed.
|
|
</li>
|
|
<li>The special characters, period (.) and minus (-), are allowed.
|
|
</li>
|
|
<li>Parts of the name separated by periods (.) cannot exceed 63 characters in length.
|
|
</li>
|
|
<li>Internet address names (in the form nnn.nnn.nnn.nnn) are not allowed.
|
|
</li>
|
|
<li>Names must be from 1 to 255 characters in length.
|
|
</li>
|
|
</ul>
|
|
<p>The internet address is specified in the form <i>nnn.nnn.nnn.nnn</i>, where <i>nnn</i> is a decimal number ranging from 0 through 255. An internet address is not valid if it has a value of all binary ones or all binary zeros for the network identifier (ID) portion or the host ID portion of the address. If the internet address is entered from a command line, the address must be enclosed in apostrophes.
|
|
</p>
|
|
<p>The possible Name or Address value is:
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>remote-location-name</i></b></dt>
|
|
<dd>Specify the remote location name to add to the node list.
|
|
</dd>
|
|
</dl>
|
|
<p>The possible Address Type values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SNA</u></b></dt>
|
|
<dd>The node name has a Systems Network Architecture (SNA) address type.
|
|
</dd>
|
|
<dt><b>*IP</b></dt>
|
|
<dd>The node name has an Internet Protocol (IP) address type.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDNODLE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDNODLE.TEXT"></a>
|
|
<h3>Text 'description' (TEXT)</h3>
|
|
<p>Specifies text that briefly describes the node list entry.
|
|
</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="#ADDNODLE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDNODLE.CPNAME"></a>
|
|
<h3>SNA node name (CPNAME)</h3>
|
|
<p>Specifies the SNA node name that is being added to the node list object. This system is specified as two elements: the network ID and the control point name.
|
|
</p>
|
|
<p><b>Notes:</b>
|
|
</p>
|
|
<ol>
|
|
<li>The RMTLOCNAME parameter is recommended for use in specifying the network ID and the control point name.
|
|
</li>
|
|
<li>When the RMTLOCNAME parameter is used to specify the name of a system to add to the node list, *RMTLOC must be specified for this parameter.
|
|
</li>
|
|
</ol>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*RMTLOC</u></b></dt>
|
|
<dd>The network ID and control point name are specified using the RMTLOCNAME parameter.
|
|
</dd>
|
|
</dl>
|
|
<p>The possible Network ID values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b>*NETATR</b></dt>
|
|
<dd>The local network ID (LCLNETID) network attribute is used as the value of the network identifier (ID) of the system being added to the node list. If the LCLNETID network attribute is changed, the new value does not affect the existing entries.
|
|
</dd>
|
|
<dt><b><i>network-ID</i></b></dt>
|
|
<dd>Specify the network ID of the system being added to the node list.
|
|
</dd>
|
|
</dl>
|
|
<p>The possible Control Point Name value is:
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>control-point-name</i></b></dt>
|
|
<dd>Specify the control point name of the system being added to the node list.
|
|
<p>
|
|
<b>Note: </b>This field is left blank when *RMTLOC is specified as the network ID.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDNODLE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="ADDNODLE.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Adding a System in the Local Network to a Node List</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ADDNODLE NODL(MYLIB/NODL02) RMTLOCNAME(AS400A01 *SNA)
|
|
TEXT('THE FIRST ISERIES 400 SERVER IN MY NETWORK')
|
|
</pre>
|
|
</p>
|
|
<p>This command adds an entry for system AS400A01, which is in the local network, to the node list NODL02 in library MYLIB. The entry has an address type of SNA. The text description for the entry is 'THE FIRST ISERIES 400 SERVER IN MY NETWORK'.
|
|
</p>
|
|
<p><b>Example 2: Adding a Host Name to a Node List</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ADDNODLE NODL(MYLIB/NODL02) RMTLOCNAME(MYSYS.NET1.LOCAL *IP)
|
|
TEXT('SYSTEM AT HEADQUARTERS')
|
|
</pre>
|
|
</p>
|
|
<p>This command adds an entry for host name MYSYS.NET1.LOCAL to the node list NODL02 in library MYLIB. The entry has an address type of IP. The text description for the entry is 'SYSTEM AT HEADQUARTERS'.
|
|
</p>
|
|
<p><b>Example 3: Adding an Internet Address to a Node List</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ADDNODLE NODL(MYLIB/NODL02) RMTLOCNAME('9.13.156.8' *IP)
|
|
TEXT('MINNEAPOLIS OFFICE')
|
|
</pre>
|
|
</p>
|
|
<p>This command adds an entry for internet address 9.13.156.8 to the node list NODL02 in library MYLIB. The entry has an address type of IP. The text description for the entry is 'MINNEAPOLIS OFFICE'.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDNODLE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="ADDNODLE.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF7AD4</b></dt>
|
|
<dd>Network ID &1 not in correct format.
|
|
</dd>
|
|
<dt><b>CPF7B18</b></dt>
|
|
<dd>Control point &1 not in correct format.
|
|
</dd>
|
|
<dt><b>CPF813E</b></dt>
|
|
<dd>Node list &4 in &9 damaged.
|
|
</dd>
|
|
<dt><b>CPF96B3</b></dt>
|
|
<dd>Node list entry already exists.
|
|
</dd>
|
|
<dt><b>CPF96B5</b></dt>
|
|
<dd>Remote location name not in correct format.
|
|
</dd>
|
|
<dt><b>CPF9801</b></dt>
|
|
<dd>Object &2 in library &3 not found.
|
|
</dd>
|
|
<dt><b>CPF9802</b></dt>
|
|
<dd>Not authorized to object &2 in &3.
|
|
</dd>
|
|
<dt><b>CPF9803</b></dt>
|
|
<dd>Cannot allocate object &2 in library &3.
|
|
</dd>
|
|
<dt><b>CPF9807</b></dt>
|
|
<dd>One or more libraries in library list deleted.
|
|
</dd>
|
|
<dt><b>CPF9808</b></dt>
|
|
<dd>Cannot allocate one or more libraries on library list.
|
|
</dd>
|
|
<dt><b>CPF9810</b></dt>
|
|
<dd>Library &1 not found.
|
|
</dd>
|
|
<dt><b>CPF9820</b></dt>
|
|
<dd>Not authorized to use library &1.
|
|
</dd>
|
|
<dt><b>CPF9830</b></dt>
|
|
<dd>Cannot assign library &1.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDNODLE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|