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

410 lines
16 KiB
HTML
Raw 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>Change TCP/IP Domain (CHGTCPDMN)</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="CHGTCPDMN.Top_Of_Page"></a>
<h2>Change TCP/IP Domain (CHGTCPDMN)</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="#CHGTCPDMN.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGTCPDMN.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGTCPDMN.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGTCPDMN"></a>
<h3>Change Local Domain and Remote DNS information</h3>
<p>Use the Change TCP/IP Domain Information (CHGTCPDMN) command to specify this system's TCP/IP host and domain name and to configure the Domain Name Server (DNS) information for this system.
</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="#CHGTCPDMN.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGTCPDMN.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="#CHGTCPDMN.HOSTNAME"><b>HOSTNAME</b></a></td>
<td valign="top">Host name</td>
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGTCPDMN.DMNNAME"><b>DMNNAME</b></a></td>
<td valign="top">Domain name</td>
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGTCPDMN.DMNSCHLIST"><b>DMNSCHLIST</b></a></td>
<td valign="top">Domain search list</td>
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *DFT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGTCPDMN.HOSTSCHPTY"><b>HOSTSCHPTY</b></a></td>
<td valign="top">Host name search priority</td>
<td valign="top">*REMOTE, *LOCAL, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="4"><a href="#CHGTCPDMN.INTNETADR"><b>INTNETADR</b></a></td>
<td valign="top">Domain name server</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="4">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Internet address</td>
<td valign="top">
<i>Character value</i>, <b><u>*SAME</u></b>, *NONE</td>
</tr>
<tr>
<td valign="top">Element 2: </td>
<td valign="top">
<i>Character value</i>, <b><u>*SAME</u></b>, *NONE</td>
</tr>
<tr>
<td valign="top">Element 3: </td>
<td valign="top">
<i>Character value</i>, <b><u>*SAME</u></b>, *NONE</td>
</tr>
<tr>
<td valign="top"><a href="#CHGTCPDMN.PORT"><b>PORT</b></a></td>
<td valign="top">Port</td>
<td valign="top">1-65535, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGTCPDMN.PROTOCOL"><b>PROTOCOL</b></a></td>
<td valign="top">Protocol</td>
<td valign="top">*UDP, *TCP, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGTCPDMN.INLDMNSVR"><b>INLDMNSVR</b></a></td>
<td valign="top">Initial domain name server</td>
<td valign="top">*FIRST, *ROTATE, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CHGTCPDMN.DMNSVRRTY"><b>DMNSVRRTY</b></a></td>
<td valign="top">Domain name server retry</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Number of retries</td>
<td valign="top">
1-99, <b><u>*SAME</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: Time interval</td>
<td valign="top">
1-99, <b><u>*SAME</u></b></td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CHGTCPDMN.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGTCPDMN.HOSTNAME"></a>
<h3>Host name (HOSTNAME)</h3>
<p>Specify the TCP/IP host name of this system.
</p>
<p>
<b>Note: </b>This system's TCP/IP host name must also be defined in the local host table or the Domain Name Server (DNS) specified in the INTNETADR parameter. If no Domain Name Server (DNS) is specified, the local TCP/IP host table is used.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The TCP/IP host name does not change if it was previously set.
</dd>
<dt><b>*NONE</b></dt>
<dd>No host name is defined for this system.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify a TCP/IP host name for this system.
</dd>
</dl>
<p>Example of how to use the HOSTNAME parameter to specify a TCP/IP host name where "asac1" is the name of the local system:
</p>
<p>
<pre>
CHGTCPDMN HOSTNAME ('asac1')
</pre>
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTCPDMN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTCPDMN.DMNNAME"></a>
<h3>Domain name (DMNNAME)</h3>
<p>Specify the name of the TCP/IP domain this i5/OS host is a member of.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The TCP/IP domain name does not change if it was previously set.
</dd>
<dt><b>*NONE</b></dt>
<dd>No TCP/IP domain name is defined for this system.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the TCP/IP domain name for this system.
</dd>
</dl>
<p>Example of how to use the DMNNAME parameter to specify this system's TCP/IP domain name:
</p>
<p>
<pre>
CHGTCPDMN DMNNAME ('dom1.abc.com')
</pre>
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTCPDMN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTCPDMN.DMNSCHLIST"></a>
<h3>Domain search list (DMNSCHLIST)</h3>
<p>Specify the TCP/IP domains to search when fully-qualified domain names (FQDN) are not given. The first name in the search list is the default domain name on all searches.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The domain search list does not change if it was previously set; otherwise *DFT is used.
</dd>
<dt><b>*DFT</b></dt>
<dd>The default behavior is to search the local domain tree. The local domain tree is the system TCP/IP domain name (DMNNAME) and each parent domain with two or more parts to the domain. The system TCP/IP domain name is the default domain name on all searches.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the list of domain names to be searched. Up to six domain names may be specified, separated by spaces and enclosed in apostrophes. The first domain name in the search list is the default domain name on all searches. Note that if a domain search list is defined then the local system TCP/IP domain name (DMNNAME) will not automatically be used in the search list. Parent domains for the domains defined in the search list will not be searched. If you want parent domains to be searched then they must be explicitly defined in the search list.
</dd>
</dl>
<p>Example of how to use the DMNSCHLIST parameter to specify this system's domain search list:
</p>
<p>
<pre>
CHGTCPDMN DMNSCHLIST('dom1.abc.com dom2.abc.com abc.com')
</pre>
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTCPDMN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTCPDMN.HOSTSCHPTY"></a>
<h3>Host name search priority (HOSTSCHPTY)</h3>
<p>Specifies whether to search a Domain Name Server (DNS) first to resolve a TCP/IP host name conflict, or to search the local TCP/IP host table first.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change if it was previously set. If the value was not previously set, *REMOTE will be used.
</dd>
<dt><b>*REMOTE</b></dt>
<dd>Specify *REMOTE if you want this system to search a remote or local Domain Name Service (DNS) to resolve TCP/IP host names before searching the local TCP/IP host table. The Domain Name Server (DNS) to use is specified by the Internet address (INTNETADR) parameter.
</dd>
<dt><b>*LOCAL</b></dt>
<dd>Specify *LOCAL if you want this system to first search the TCP/IP host table, located on this system, to resolve TCP/IP host names.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTCPDMN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTCPDMN.INTNETADR"></a>
<h3>Internet address (INTNETADR)</h3>
<p>Use this parameter to specify up to three Domain Name Servers (DNS) to be used by this system. Specify a Domain Name Server (DNS) by entering its Internet address. You may add none, one, two, or three Domain Name Server (DNS) Internet addresses.
</p>
<p>If the first Domain Name Server (DNS) in the list does not respond, the second DNS server in the list will be contacted. If the second DNS server does not respond, the third DNS server will contacted.
</p>
<p>The Domain Name Server (DNS) Internet address must be in decimal form, with a maximum of 15 characters.
</p>
<p>This is an example of how to use the INTNETADR parameter to specify a primary and secondary Domain Name Server for use by this system:
</p>
<p>
<pre>
CHGTCPDMN INTNETADR('9.131.42.251' '9.131.39.251')
</pre>
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTCPDMN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTCPDMN.PORT"></a>
<h3>Port (PORT)</h3>
<p>Use this parameter to specify the remote TCP/IP port number used to contact the Domain Name Server (DNS) or Servers listed in the INTNETADR parameter. 53 is the well-known port used for this purpose.
</p>
<p>
<b>Note: </b>Use of a TCP/IP port number other than the well-known port 53 for use by the Domain Name Server (DNS) can result in TCP/IP communication problems. You may inadvertently use a port number which is reserved for use by another TCP/IP application.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The remote port number will not be changed if it was previously set. If the remote port number was not previously set, the remote port number 53 will be used.
</dd>
<dt><b><i>1-65532r</i></b></dt>
<dd>Specify the remote port number to be used to contact the Domain Name Server (DNS) specified in the INTNETADR parameter.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTCPDMN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTCPDMN.PROTOCOL"></a>
<h3>Protocol (PROTOCOL)</h3>
<p>Specify the TCP/IP protocol used to communicate with the Domain Name Server (DNS) specified in the INTNETADR parameter. User Datagram Protocol (UDP) is typically used for this purpose. Use *TCP only if your Domain Name Server (DNS) is specifically configured to use the Transmission Control Protocol (TCP).
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The protocol value will not be changed if it was previously set. If the protocol value was not previously set, the protocol value *UDP will be used.
</dd>
<dt><b>*UDP</b></dt>
<dd>Specifies use of the User Datagram Protocol (UDP) to communicate with the Domain Name Server (DNS) specified in the INTNETADR parameter.
</dd>
<dt><b>*TCP</b></dt>
<dd>Specifies the use of Transmission Control Protocol (TCP) to communicate with the Domain Name Server (DNS) specified in the INTNETADR parameter.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTCPDMN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTCPDMN.INLDMNSVR"></a>
<h3>Initial domain name server (INLDMNSVR)</h3>
<p>Specify the initial domain name server selection method. This option determines whether the first configured Domain Name Server (DNS) should always be queried first, or if the first name server to be queried should be rotated in a round robin fashion if more than one is configured. This rotation provides a simple form of load balancing on the configured name servers.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The initial domain name server selection value will not be changed if it was previously set. If the initial domain name server selection value was not previously set, the value *FIRST will be used.
</dd>
<dt><b>*FIRST</b></dt>
<dd>The first configured domain name server is queried first. Always query the Domain Name Servers (DNS) in order as configured.
</dd>
<dt><b>*ROTATE</b></dt>
<dd>Rotate through the configured name servers in a round robin fashion to determine which to query first.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTCPDMN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTCPDMN.DMNSVRRTY"></a>
<h3>Domain name server retry (DMNSVRRTY)</h3>
<p>The Domain Name Server Retry (DMNSVRRTY) parameter consists of two elements: number-retries, and time-interval.
</p>
<p>The first element; number-retries, specifies the number of additional attempts made to establish communication with each Domain Name Server (DNS) specified in the INTNETADR parameter, in the event that the first attempt fails.
</p>
<p><b>Element 1: Number of retries</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>This is the default value. The number-retries value will not be changed if it was previously set. If the number-retries value was not previously set, the number-retries value of 2 will be used.
</dd>
<dt><b><i>1-99</i></b></dt>
<dd>Specify the number of communication retry attempts.
</dd>
</dl>
<p><b>Element 2: Time interval</b> Specifies the length of time in seconds this system will wait before initiating a retry attempt.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The time-interval value will not be changed if it was previously set. If the time-interval value was not previously set, the time-interval value of 2 will be used.
</dd>
<dt><b><i>1-99</i></b></dt>
<dd>Specify the time-interval in seconds between retry attempts.
</dd>
</dl>
<p>Here is an example of how to use the Domain Name Server Retry (DMNSVRRTY) parameter to set the number of retries to three, and the interval between each retry to ten seconds:
</p>
<p>
<pre>
CHGTCPDMN DMNSVRRTY(3 10)
</pre>
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTCPDMN.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGTCPDMN.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Change Host and Domain Names</b>
</p>
<p>
<pre>
CHGTCPDMN HOSTNAME(rs021) DMNNAME(endicott.ibm.com)
</pre>
</p>
<p>This command changes the host name and domain name.
</p>
<p><b>Example 2: Change Domain Search List</b>
</p>
<p>
<pre>
CHGTCPDMN DMNSCHLIST('endicott.ibm.com
rochester.ibm.com
ibm.com')
</pre>
</p>
<p>This command changes the domain search list to be three domain names: endicott.ibm.com, rochester.ibm.com, and ibm.com.
</p>
<p><b>Example 3: Change Domain Name Server Rotation</b>
</p>
<p>
<pre>
CHGTCPDMN INLDMNSVR(*ROTATE)
</pre>
</p>
<p>This command changes the initial domain name server selection so it rotates between the configured name servers in a round robin fashion.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTCPDMN.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGTCPDMN.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>TCP1609</b></dt>
<dd>TCP/IP domain information not changed.
</dd>
<dt><b>TCP264D</b></dt>
<dd>Error occurred processing file.
</dd>
<dt><b>TCP8050</b></dt>
<dd>*IOSYSCFG authority required to use &amp;1.
</dd>
<dt><b>TCP9503</b></dt>
<dd>File &amp;3 in library &amp;2 not available.
</dd>
<dt><b>TCP9999</b></dt>
<dd>Internal system error in program &amp;1.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTCPDMN.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>