224 lines
8.2 KiB
HTML
224 lines
8.2 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>Merge TCP/IP Host Table (MRGTCPHT)</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="MRGTCPHT.Top_Of_Page"></a>
|
|
<h2>Merge TCP/IP Host Table (MRGTCPHT)</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="#MRGTCPHT.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#MRGTCPHT.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#MRGTCPHT.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="MRGTCPHT"></a>
|
|
<p>The Merge TCP/IP Host Table (MRGTCPHT) command is used to merge 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.
|
|
</p>
|
|
<p>A file format option is provided that allows either *AS400, *AIX, or *NIC file format to be merged with the local host table. The local host table is located in member QUSRSYS/QATOCHOST.HOSTS and is created as a physical file.
|
|
</p>
|
|
<p>A maximum of 4 host names per IP address is allowed when host tables are merged. For example: If the local host table already has 3 host names and the physical file member to be merged has 2 additional host names, only the first host name in the physical file is merged into the final host table. Host names that exist both in the local host table and the physical file member being merged are not duplicated.
|
|
</p>
|
|
<p><b>Attention:</b> The original copy of the local host table is not saved by the Merge TCP/IP Host Table (MRGTCPHT) command. To save the original host table, create a copy of the file QUSRSYS/QATOCHOST.HOSTS using the Copy File (CPYF) command. Do this <u> before</u> issuing the MRGTCPHT command.
|
|
</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="#MRGTCPHT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="MRGTCPHT.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="#MRGTCPHT.FROMFILE"><b>FROMFILE</b></a></td>
|
|
<td valign="top">From file</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: From file</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>*LIBL</u></b>, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#MRGTCPHT.FROMMBR"><b>FROMMBR</b></a></td>
|
|
<td valign="top">From member</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*FIRST</u></b>, *LAST</td>
|
|
<td valign="top">Optional, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#MRGTCPHT.FILEFMT"><b>FILEFMT</b></a></td>
|
|
<td valign="top">File format</td>
|
|
<td valign="top"><b><u>*AS400</u></b>, *AIX, *NIC</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#MRGTCPHT.REPLACE"><b>REPLACE</b></a></td>
|
|
<td valign="top">Replace host table</td>
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#MRGTCPHT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="MRGTCPHT.FROMFILE"></a>
|
|
<h3>From file (FROMFILE)</h3>
|
|
<p>Specifies the physical file that contains the member being used for the merge operation.
|
|
</p>
|
|
<p><b>Qualifier 1: From file</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the physical file.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the job's library list are searched.
|
|
</dd>
|
|
<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>name</i></b></dt>
|
|
<dd>Specify the name of the library where the physical file is located.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#MRGTCPHT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="MRGTCPHT.FROMMBR"></a>
|
|
<h3>From member (FROMMBR)</h3>
|
|
<p>Specifies the physical file member to be used in the merge operation.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*FIRST</u></b></dt>
|
|
<dd>The first member of the physical file is used to merge with the host table.
|
|
</dd>
|
|
<dt><b>*LAST</b></dt>
|
|
<dd>The last member of the physical file is used to merge with the host table.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the physical file member to be used.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#MRGTCPHT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="MRGTCPHT.FILEFMT"></a>
|
|
<h3>File format (FILEFMT)</h3>
|
|
<p>Specifies the format of the physical file member to be merged with the local host table.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*AS400</u></b></dt>
|
|
<dd>The physical file member to be merged with the local host table is *AS400 format.
|
|
<p>
|
|
<b>Note: </b>*AS400 can only be used if the physical file member specified is a host table from an iSeries running Version 3, Release 1, Modification 0 (V3R1M0) or later of OS/400. If you import a host table from a system running any version of OS/400 prior to V3R1M0, specify *AIX.
|
|
</p>
|
|
</dd>
|
|
<dt><b>*AIX</b></dt>
|
|
<dd>The physical file member to be merged with the local host table is *AIX format.
|
|
</dd>
|
|
<dt><b>*NIC</b></dt>
|
|
<dd>The physical file member to be merged with the local host table is *NIC format.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#MRGTCPHT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="MRGTCPHT.REPLACE"></a>
|
|
<h3>Replace host table (REPLACE)</h3>
|
|
<p>Specifies whether the physical file member is to be merged with or replaces the local host table.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NO</u></b></dt>
|
|
<dd>The physical file member is merged with the local host table.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>The physical file member replaces the local host table.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#MRGTCPHT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="MRGTCPHT.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Replacing Local Host Table</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
MRGTCPHT FROMFILE(AS400FILE) REPLACE(*YES) FILEFMT(*AS400)
|
|
</pre>
|
|
</p>
|
|
<p>This command replaces the contents of QUSRSYS/QATOCHOST.HOSTS with the contents of the first member of physical file AS400FILE. The first member of physical file AS400FILE is in *AS400 host table format.
|
|
</p>
|
|
<p><b>Example 2: Merging Local Host Table</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
MRGTCPHT FROMFILE(HOSTLIB/NICFILE) FROMMBR(NEWHOSTS) FILEFMT(*NIC)
|
|
</pre>
|
|
</p>
|
|
<p>This command merges the current contents of the local host table with the contents of the NEWHOSTS member of physical file NICFILE in library HOSTLIB. The physical file is in *NIC format. The records are converted from *NIC format to *AS400 format by this command.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#MRGTCPHT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="MRGTCPHT.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>TCP1927</b></dt>
|
|
<dd>Records of file &1, member &2 not valid.
|
|
</dd>
|
|
<dt><b>TCP1929</b></dt>
|
|
<dd>Host table not available.
|
|
</dd>
|
|
<dt><b>TCP1934</b></dt>
|
|
<dd>Merge file &1, member &3, in library &2 not found.
|
|
</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="#MRGTCPHT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|