138 lines
5.7 KiB
HTML
138 lines
5.7 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 IP over SNA Interface (CHGIPSIFC)</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="CHGIPSIFC.Top_Of_Page"></a>
|
|
<h2>Change IP over SNA Interface (CHGIPSIFC)</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="#CHGIPSIFC.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CHGIPSIFC.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CHGIPSIFC.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CHGIPSIFC"></a>
|
|
<p>The Change IP over SNA Interface (CHGIPSIFC) command changes an existing AF_INET Sockets over SNA interface (an IP address by which this local host is known on the SNA transport). This command changes only the subnetmask. It does not change the internet address. The internet address identifies the interface being changed.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ol>
|
|
<li>The user must have *IOSYSCFG authority to use this command.
|
|
</li>
|
|
<li>The interface cannot be active when you submit this command. Use the End IP over SNA Interface (ENDIPSIFC) CL command to deactivate the interface.
|
|
</li>
|
|
<li>There can be no configured routes whose NEXTHOP internet address can be reached only through the network associated with the IP over SNA interface to be changed.
|
|
</li>
|
|
</ol>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGIPSIFC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CHGIPSIFC.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="#CHGIPSIFC.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"><a href="#CHGIPSIFC.SUBNETMASK"><b>SUBNETMASK</b></a></td>
|
|
<td valign="top">Subnet mask</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b></td>
|
|
<td valign="top">Optional, Positional 2</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGIPSIFC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CHGIPSIFC.INTNETADR"></a>
|
|
<h3>Internet address (INTNETADR)</h3>
|
|
<p>Specifies the internet address of an interface that has previously been added to the SNA configuration with the Add IP over SNA Interface (ADDIPSIFC) CL command. 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.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGIPSIFC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGIPSIFC.SUBNETMASK"></a>
|
|
<h3>Subnet mask (SUBNETMASK)</h3>
|
|
<p>Specifies the subnet mask, which is a bit mask that defines the part of the network where this interface attaches. The mask is a 32-bit combination that is logically ANDed with the internet address to determine a particular subnetwork. The bits of the mask set to the value one (1) determine the network and subnetwork portions of the address. The bits set to the value zero (0) determine the host portion of the address.
|
|
</p>
|
|
<p><b>Notes:</b>
|
|
</p>
|
|
<ol>
|
|
<li>The network portion must be equal to one bit in the subnetmask. The host portion and the subnetmask portion of an address must both be at least two bits wide.
|
|
</li>
|
|
<li>The bits that identify the subnetwork are not required to be adjacent in the address. However, it is strongly recommended that the subnet bits be contiguous and located in the most significant bits of the host address.
|
|
</li>
|
|
</ol>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The subnet-mask value does not change.
|
|
</dd>
|
|
<dt><b><i>subnet-mask</i></b></dt>
|
|
<dd>Specify the mask for the network subnet field and host address field of the internet address that defines a subnetwork. The subnetwork mask is in the form, <i>nnn.nnn.nnn.nnn</i>, where <i>nnn</i> is a decimal number ranging from 0 through 255. The subnet mask must mask off all bits of the network class's network ID portion of the internet address. For more detailed information on subnet masks and an example, see the Add IP over SNA Interface (ADDIPSIFC) CL command.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGIPSIFC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGIPSIFC.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
CHGIPSIFC INTNETADR('9.5.1.248') SUBNETMASK('255.255.0.0')
|
|
</pre>
|
|
</p>
|
|
<p>This command changes the subnet mask of the interface with IP address 9.5.1.248 to 255.255.0.0.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGIPSIFC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGIPSIFC.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>TCP8050</b></dt>
|
|
<dd>*IOSYSCFG authority required to use &1.
|
|
</dd>
|
|
<dt><b>TCP9999</b></dt>
|
|
<dd>Internal system error in program &1.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGIPSIFC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|