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

146 lines
5.9 KiB
HTML
Raw Permalink Normal View History

2024-04-02 14:02:31 +00:00
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Rename TCP/IP Host Table Entry (RNMTCPHTE)</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="RNMTCPHTE.Top_Of_Page"></a>
<h2>Rename TCP/IP Host Table Entry (RNMTCPHTE)</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="#RNMTCPHTE.PARAMETERS.TABLE">Parameters</a><br>
<a href="#RNMTCPHTE.COMMAND.EXAMPLES">Examples</a><br>
<a href="#RNMTCPHTE.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="RNMTCPHTE"></a>
<p>The Rename TCP/IP Host Table Entry (RNMTCPHTE) command is used to rename an internet address in the local host table to another internet address. This has the effect of associating the host names for the old internet address with the new internet address. Host names and the text description field are not altered with the RNMTCPHTE command.
</p>
<p>The local host table is defined to allow 1 internet address, 4 host names and 1 text description field per entry.
</p>
<p>See also the following host table commands:
</p>
<ul>
<li>Add TCP/IP Host Table Entry (ADDTCPHTE) command adds a new entry in the local host table.
</li>
<li>Change TCP/IP Host Table Entry (CHGTCPHTE) command changes one or more host names or the text description field.
</li>
<li>Merge TCP/IP Host Table (MRGTCPHT) command merges host names, internet addresses, and text comment entries from a physical file member into the local host table. A replace option is also provided that allows the entire local host table to be replaced by the physical file member.
</li>
<li>Remove TCP/IP Host Table Entry (RMVTCPHTE) command removes an entire entry from the local host table.
</li>
</ul>
<p><b>Restrictions:</b>
</p>
<ul>
<li>You must have input/output system configuration (*IOSYSCFG) special authority to run this command.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#RNMTCPHTE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="RNMTCPHTE.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="#RNMTCPHTE.INTNETADR"><b>INTNETADR</b></a></td>
<td valign="top">Internet address</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#RNMTCPHTE.NEWINTNETA"><b>NEWINTNETA</b></a></td>
<td valign="top">New internet address</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Required, Positional 2</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#RNMTCPHTE.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="RNMTCPHTE.INTNETADR"></a>
<h3>Internet address (INTNETADR)</h3>
<p>Specifies the internet address associated with the host name that you want to rename. 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>
</div>
<table width="100%">
<tr><td align="right"><a href="#RNMTCPHTE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RNMTCPHTE.NEWINTNETA"></a>
<h3>New internet address (NEWINTNETA)</h3>
<p>Specifies the new internet address that renames the existing internet address in the local host table. 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>
</div>
<table width="100%">
<tr><td align="right"><a href="#RNMTCPHTE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RNMTCPHTE.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
RNMTCPHTE INTNETADR('132.28.71.5') NEWINTNETA('142.48.81.6')
</pre>
</p>
<p>This command replaces the host table entry internet address of 132.28.71.5 with the internet address of 142.48.81.6. All host names and the text description field associated with the entry remain the same.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RNMTCPHTE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RNMTCPHTE.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>TCP1901</b></dt>
<dd>Internet address &amp;1 not valid.
</dd>
<dt><b>TCP1902</b></dt>
<dd>Internet address &amp;1 not valid.
</dd>
<dt><b>TCP1904</b></dt>
<dd>Duplicate internet address &amp;1 found in host table.
</dd>
<dt><b>TCP1907</b></dt>
<dd>Internet address entry &amp;1 does not exist.
</dd>
<dt><b>TCP1908</b></dt>
<dd>Internet address &amp;1 not valid.
</dd>
<dt><b>TCP1910</b></dt>
<dd>LOOPBACK internet address &amp;1 not valid.
</dd>
<dt><b>TCP1929</b></dt>
<dd>Host table not available.
</dd>
<dt><b>TCP8050</b></dt>
<dd>*IOSYSCFG authority required to use &amp;1.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RNMTCPHTE.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>