319 lines
15 KiB
HTML
319 lines
15 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>Change TCP/IP Host Table Entry (CHGTCPHTE)</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="CHGTCPHTE.Top_Of_Page"></a>
|
|
<h2>Change TCP/IP Host Table Entry (CHGTCPHTE)</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="#CHGTCPHTE.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CHGTCPHTE.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CHGTCPHTE.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CHGTCPHTE"></a>
|
|
<p>The Change TCP/IP Host Table Entry (CHGTCPHTE) command is used to change the host names and text description fields for an existing host table entry in the local host table. A host table entry consists of one internet address, up to four host names, and one text description.
|
|
</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>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 host table entries in a user specified physical file member.
|
|
</li>
|
|
<li>Rename TCP/IP Host Table Entry (RNMTCPHTE) command renames the internet address of a host table entry to another internet address
|
|
</li>
|
|
<li>Remove TCP/IP Host Table Entry (RMVTCPHTE) command removes an entire entry from the local host table.
|
|
</li>
|
|
</ul>
|
|
<p>The CHGTCPHTE command can change a minimum of zero and a maximum of four host names associated with a specific internet address. This command can also be used to add or remove a host-name value associated with a specific internet address. To remove a host-name value, specify *BLANK as the host name. Setting all the host names for a host table entry to *BLANK is not allowed.
|
|
</p>
|
|
<p>If the CHGTCPHTE command is prompted with an internet address specified, the current host names and text description for the host table entry associated with that internet address are displayed in the appropriate prompt fields.
|
|
</p>
|
|
<p>If a remote name server is being used by your local system, the search order used (whether the remote name server or local host table is searched first) for a resolution between a host name and an internet address depends on how the searched-first value was configured on the configuration panel of the remote name server. To change the search order, use option 13 on the Configure TCP/IP (CFGTCP) command.
|
|
</p>
|
|
<p>The TCP/IP host table is shipped with the loopback entry. This entry has an internet address of 127.0.0.1 and two host names: LOOPBACK and LOCALHOST. The loopback host name can be associated only with an internet address that has a first-byte value equal to 127.
|
|
</p>
|
|
<h5>Related APPC over TCP/IP Information</h5>
|
|
<p>APPC over TCP/IP (AnyNet) uses the host name to map location names to internet addresses. The host name must be in the form:
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
location.netid.SNA.IBM.COM
|
|
</pre>
|
|
</p>
|
|
<p>Where <i>location</i> is the remote location the program is opening to, and <i>netid</i> is the network identifier for this connection. <i>SNA.IBM.COM</i> is the qualifier that designates this as the APPC over TCP/IP domain.
|
|
</p>
|
|
<p>Location names support characters that <u> cannot</u> be present in host names (for example: $ (dollar), @ (at sign), and # (number sign)). Therefore, the APPC application can open only to locations that fulfill the TCP/IP host name syntax. This limits location names used for APPC over TCP/IP to the characters A-Z (uppercase and lowercase) and 0-9.
|
|
</p>
|
|
<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="#CHGTCPHTE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CHGTCPHTE.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="#CHGTCPHTE.INTNETADR"><b>INTNETADR</b></a></td>
|
|
<td valign="top">Internet address</td>
|
|
<td valign="top"><i>Character value</i></td>
|
|
<td valign="top">Required, Key, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="2"><a href="#CHGTCPHTE.HOSTNAME"><b>HOSTNAME</b></a></td>
|
|
<td valign="top">Host names</td>
|
|
<td valign="top">Values (up to 4 repetitions): <i>Element list</i></td>
|
|
<td valign="top" rowspan="2">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Name</td>
|
|
<td valign="top">
|
|
<i>Character value</i>, <b><u>*SAME</u></b>, *BLANK</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGTCPHTE.TEXT"><b>TEXT</b></a></td>
|
|
<td valign="top">Text 'description'</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *BLANK</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGTCPHTE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CHGTCPHTE.INTNETADR"></a>
|
|
<h3>Internet address (INTNETADR)</h3>
|
|
<p>Specifies the internet address associated with the host name (or names) or the text-description field that is to be changed 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="#CHGTCPHTE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGTCPHTE.HOSTNAME"></a>
|
|
<h3>Host names (HOSTNAME)</h3>
|
|
<p>Specifies the host names corresponding to the internet address. The host name can be either the short form or the full domain version of the name. A common practice is to define one short name that is unique within your local network and to also define the full domain version of the host name that is unique within the internet. Specify from 1 to 4 different host names to be associated with the internet address. Host names may be up to 255 characters in length.
|
|
</p>
|
|
<p>A domain name or a host name can be a text string having 1 to 255 characters. Domain names consist of one or more labels separated by periods. Each label can contain up to 63 characters. The first character of each label must be an alphabetic character or a digit. The last character of each label must be an alphabetic character, a digit, or a period. The following characters are allowed in domain names:
|
|
</p>
|
|
<ul>
|
|
<li>Alphabetical characters A through Z
|
|
</li>
|
|
<li>Digits 0 through 9
|
|
</li>
|
|
<li>Underscore (_)
|
|
</li>
|
|
<li>Minus sign (-)
|
|
</li>
|
|
<li>Period (.). Periods are allowed only when they separate labels of the domain style name or as the last character in the domain name. (Refer to RFC 1034.) A domain name cannot have two consecutive periods.
|
|
</li>
|
|
</ul>
|
|
<p>
|
|
<b>Note: </b>These characters are part of the Syntactic Character Set (character set number 640). This character set is also commonly referred to as invariant.
|
|
</p>
|
|
<p>Other domain name and host name conventions include the following:
|
|
</p>
|
|
<ul>
|
|
<li>Uppercase and lowercase characters are allowed, but no significance is attached to the case. The host name (HOSTNAME) may be converted to uppercase depending on the combination of characters and digits. If the HOSTNAME is enclosed in apostrophes ('), the case is maintained as entered.
|
|
</li>
|
|
<li>The host name returned when searching the host table for an internet address is the first host name associated with the internet address. For example, if the address 9.130.38.187 is defined in the host table with names ROCHESTER, JOHN, and RCHAS100, the name ROCHESTER would be returned. The other two host names would not be used in this type of search. However, these host names would be used when searching the host table to find the internet address associated with the names JOHN and RCHAS100.
|
|
</li>
|
|
<li>Try to limit your domain name labels to 12 characters. Shorter labels are easier to remember.
|
|
</li>
|
|
<li>It is a common practice to use hierarchical names that allow predictable extensions for change and growth. Domain names normally reflect the delegation of authority or hierarchy used to assign them. For example, the name SYS1.MFG.ABC.COM can be broken down into the following:
|
|
<dl>
|
|
<dt><b>COM</b></dt>
|
|
<dd>All commercial networks.
|
|
</dd>
|
|
<dt><b>ABC.COM</b></dt>
|
|
<dd>All systems in the ABC company's commercial network.
|
|
</dd>
|
|
<dt><b>MFG.ABC.COM</b></dt>
|
|
<dd>All manufacturing systems in the ABC company's commercial network.
|
|
</dd>
|
|
<dt><b>SYS1.MFG.ABC.COM</b></dt>
|
|
<dd>A host named SYS1 in the manufacturing area of the company's commercial network.
|
|
</dd>
|
|
</dl>
|
|
<p>The COM designation is one of several domain names used by convention when connecting to the Internet. Some of the other domain names that follow this convention are:
|
|
</p>
|
|
<dl>
|
|
<dt><b>COM</b></dt>
|
|
<dd>Commercial organizations
|
|
</dd>
|
|
<dt><b>EDU</b></dt>
|
|
<dd>Educational institutions
|
|
</dd>
|
|
<dt><b>GOV</b></dt>
|
|
<dd>Government institutions
|
|
</dd>
|
|
<dt><b>MIL</b></dt>
|
|
<dd>Military groups
|
|
</dd>
|
|
<dt><b>NET</b></dt>
|
|
<dd>Major network support centers
|
|
</dd>
|
|
<dt><b>ORG</b></dt>
|
|
<dd>Organizations other than those listed previously
|
|
</dd>
|
|
<dt><b>ARPA</b></dt>
|
|
<dd>Temporary ARPANET domain
|
|
</dd>
|
|
<dt><b>Country or Region Code</b></dt>
|
|
<dd>Countries or regions other than the USA
|
|
</dd>
|
|
</dl>
|
|
</li>
|
|
</ul>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>This host-name value is not to be modified.
|
|
<p>
|
|
<b>Note: </b>If *SAME is specified and no other host-name values are specified, all of the host-name values remain the same. If a host table entry has more than one host name identified and if the first host name is specified but no other element values are specified, the remaining host names are not changed.
|
|
</p>
|
|
</dd>
|
|
<dt><b>*BLANK</b></dt>
|
|
<dd>This host-name value is changed to blanks if it previously existed.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify a host name to be associated with the specified internet address that replaces the current host-name value. When running APPC over TCP/IP, <i>name</i> is in the form:
|
|
<p>
|
|
<pre>
|
|
location.netid.SNA.IBM.COM
|
|
</pre>
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGTCPHTE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGTCPHTE.TEXT"></a>
|
|
<h3>Text 'description' (TEXT)</h3>
|
|
<p>Specifies a comment associated with this host table entry.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>If the host table will be copied to a system using a different code page than the system it was created on, it is suggested that you avoid using certain characters in a comment. Host table entry comments will be more portable if they are limited to characters in the Syntactic Character Set (invariant).
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The text-description field for this host table entry is not to be modified.
|
|
</dd>
|
|
<dt><b>*BLANK</b></dt>
|
|
<dd>The text-description field for this host table entry is to be changed to blanks.
|
|
</dd>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify a text-description field to be associated with the specified internet address. Comments can contain a maximum of 64 characters.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGTCPHTE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGTCPHTE.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Changing a Host Name</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CHGTCPHTE INTNETADR('132.28.71.5')
|
|
HOSTNAME((*SAME) (*SAME) (NEWAS400HOST))
|
|
TEXT(*BLANK)
|
|
</pre>
|
|
</p>
|
|
<p>This command changes the third host name associated with internet address 132.28.71.5 to NEWAS400HOST but does not modify the first, second, or fourth host names. The text of the descriptive comment for this host table entry is set to blanks.
|
|
</p>
|
|
<p><b>Example 2: Changing All Host Names</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CHGTCPHTE INTNETADR('9.130.25.21')
|
|
HOSTNAME((MYHOST) (MYHOST.MYNET)
|
|
(MYHOST.MYNET.MYCORP)
|
|
(MYHOST.MYNET.MYCORP.MYFIELD))
|
|
TEXT(*SAME)
|
|
</pre>
|
|
</p>
|
|
<p>This command changes all host names associated with internet address 121.14.32.5. The first host name is specified in the short form, MYHOST. The fourth host name is specified in the fully qualified form, MYHOST.MYNET.MYCORP.MYFIELD. The descriptive comment for this host table entry is not changed.
|
|
</p>
|
|
<p><b>Example 3: Changing Host Names and Text Description</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CHGTCPHTE INTNETADR('132.28.71.5')
|
|
HOSTNAME((AS400ETH.SALES.ABC.COM)
|
|
(AS400ETH.SALES.ABC) (*BLANK) (*BLANK))
|
|
TEXT('THIS ENTRY UPDATED ON 19 FEB 1994 BY T.J.')
|
|
</pre>
|
|
</p>
|
|
<p>This command changes the first and second host names associated with internet address 132.28.71.5 to AS400ETH.SALES.ABC.COM and AS400ETH.SALES.ABC. The third and fourth host names, if they existed, are changed to blanks. The descriptive comment for this host table entry is changed to 'THIS ENTRY UPDATED ON 19 FEB 1994 BY T.J.'.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGTCPHTE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGTCPHTE.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>TCP1901</b></dt>
|
|
<dd>Internet address &1 not valid.
|
|
</dd>
|
|
<dt><b>TCP1902</b></dt>
|
|
<dd>Internet address &1 not valid.
|
|
</dd>
|
|
<dt><b>TCP1903</b></dt>
|
|
<dd>Specified host name not valid.
|
|
</dd>
|
|
<dt><b>TCP1907</b></dt>
|
|
<dd>Internet address entry &1 does not exist.
|
|
</dd>
|
|
<dt><b>TCP1908</b></dt>
|
|
<dd>Internet address &1 not valid.
|
|
</dd>
|
|
<dt><b>TCP1910</b></dt>
|
|
<dd>LOOPBACK internet address &1 not valid.
|
|
</dd>
|
|
<dt><b>TCP1929</b></dt>
|
|
<dd>Host table not available.
|
|
</dd>
|
|
<dt><b>TCP1936</b></dt>
|
|
<dd>All host names for internet address &1 are blank.
|
|
</dd>
|
|
<dt><b>TCP8050</b></dt>
|
|
<dd>*IOSYSCFG authority required to use &1.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGTCPHTE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|