friedkiwi/ibm-information-center
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
14ed2849c6
ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/chgnwifr.htm

445 lines
16 KiB
HTML
Raw Blame History

<!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 Network Interface (FR) (CHGNWIFR)</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="CHGNWIFR.Top_Of_Page"></a>
<h2>Change Network Interface (FR) (CHGNWIFR)</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="#CHGNWIFR.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGNWIFR.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGNWIFR.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGNWIFR"></a>
<p>The Change Network Interface (Frame-Relay Network) (CHGNWIFR) command changes a network interface for a frame-relay network (FR) interface. More information about using this command is in the Communications Configuration book, SC41-5401.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNWIFR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGNWIFR.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="#CHGNWIFR.NWID"><b>NWID</b></a></td>
<td valign="top">Network interface description</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Required, Key, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#CHGNWIFR.RSRCNAME"><b>RSRCNAME</b></a></td>
<td valign="top">Resource name</td>
<td valign="top"><i>Name</i>, <b><u>*SAME</u></b></td>
<td valign="top">Optional, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#CHGNWIFR.ONLINE"><b>ONLINE</b></a></td>
<td valign="top">Online at IPL</td>
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGNWIFR.VRYWAIT"><b>VRYWAIT</b></a></td>
<td valign="top">Vary on wait</td>
<td valign="top">15-180, <b><u>*SAME</u></b>, *NOWAIT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGNWIFR.NRZI"><b>NRZI</b></a></td>
<td valign="top">NRZI data encoding</td>
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGNWIFR.CLOCK"><b>CLOCK</b></a></td>
<td valign="top">Clocking</td>
<td valign="top"><b><u>*SAME</u></b>, *MODEM, *LOOP, *INVERT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGNWIFR.LINESPEED"><b>LINESPEED</b></a></td>
<td valign="top">Line speed</td>
<td valign="top">56000-2048000, <b><u>*SAME</u></b>, 56000, 64000, 128000, 192000, 256000, 320000, 384000, 448000, 512000, 1024000, 1536000, 2048000</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGNWIFR.LMIMODE"><b>LMIMODE</b></a></td>
<td valign="top">LMI mode</td>
<td valign="top"><b><u>*SAME</u></b>, *TE, *FH, *NONE, *ANNEXA</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGNWIFR.POLLITV"><b>POLLITV</b></a></td>
<td valign="top">Polling interval</td>
<td valign="top">5-30, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGNWIFR.FULLINQITV"><b>FULLINQITV</b></a></td>
<td valign="top">Full inquiry interval</td>
<td valign="top">1-255, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGNWIFR.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>
<tr>
<td valign="top" rowspan="3"><a href="#CHGNWIFR.CMNRCYLMT"><b>CMNRCYLMT</b></a></td>
<td valign="top">Recovery limits</td>
<td valign="top">Single values: <b><u>*SAME</u></b>, *SYSVAL<br>Other values: <i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Count limit</td>
<td valign="top">
0-99</td>
</tr>
<tr>
<td valign="top">Element 2: Time interval</td>
<td valign="top">
0-120</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CHGNWIFR.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGNWIFR.NWID"></a>
<h3>Network interface description (NWID)</h3>
<p>This is a required parameter.
</p>
<p>Specifies the name of the network interface description.
</p>
<dl>
<dt><b><i>network-interface-description-name</i></b></dt>
<dd>Specify the name of a network interface description.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNWIFR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGNWIFR.RSRCNAME"></a>
<h3>Resource name (RSRCNAME)</h3>
<p>This is a required parameter.
</p>
<p>Specifies the resource name identifying the hardware that the description represents.
</p>
<p>
<b>Note: </b>Use the Work with Hardware Resources (WRKHDWRSC) command with *CMN specified for the TYPE parameter to help determine the resource name. Specify the resource name of the communications port. The resource name consists of the input/output adapter (IOA) resource name and the port number on the IOA. For example, if the resource name of the IOA is LIN01 and the port on the IOA is 1, then the resource name is LIN011.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b><i>resource-name</i></b></dt>
<dd>Specify a resource name.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNWIFR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGNWIFR.ONLINE"></a>
<h3>Online at IPL (ONLINE)</h3>
<p>Specifies whether this object is automatically varied on at initial program load (IPL).
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*YES</b></dt>
<dd>The network interface is automatically varied on at initial program load (IPL).
</dd>
<dt><b>*NO</b></dt>
<dd>This network interface is not automatically varied on at IPL.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNWIFR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGNWIFR.VRYWAIT"></a>
<h3>Vary on wait (VRYWAIT)</h3>
<p>Specifies whether the network interface is varied on asynchronously or synchronously. For synchronous vary on, specifies how long the system waits for the vary on to complete.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*NOWAIT</b></dt>
<dd>The system does not wait for the vary on to complete. The network interface is varied on asynchronously.
</dd>
<dt><b><i>vary-on-wait</i></b></dt>
<dd>Specify the time (in seconds) to wait. Valid values range from 15 through 180. The system waits until the network interface is varied on, or until the specified time passes, before completing the Vary Configuration (VRYCFG) command.
<p><b>Notes:</b>
</p>
<ol>
<li>Specifying a wait time in the network interface description affects system IPL time, if ONLINE(*YES) is used, by the amount of time it takes to synchronously vary on the network interface or reach the wait-time value.
</li>
<li>The time required to vary on a network interface is the time it takes to put tasks in place to manage the network interface, to activate the communications I/O processor (IOP) (including downloading the IOP model-unique Licensed Internal Code), and to establish communications with the data circuit-terminating equipment (DCE). Normal vary-on time ranges from 5 through 45 seconds but can be longer depending on the system, network interface protocol, and other factors.
</li>
</ol>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNWIFR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGNWIFR.NRZI"></a>
<h3>NRZI data encoding (NRZI)</h3>
<p>Specifies whether non-return-to-zero-inverted (NRZI) data encoding is used for modems that are sensitive to certain bit patterns in the data stream. This ensures that the signal does not stay the same for an extended period of time.
</p>
<p>
<b>Note: </b>All data communications equipment on the line must use the same transmission method.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*YES</b></dt>
<dd>NRZI data encoding is used.
</dd>
<dt><b>*NO</b></dt>
<dd>NRZI data encoding is not used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNWIFR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGNWIFR.CLOCK"></a>
<h3>Clocking (CLOCK)</h3>
<p>Specifies the method in which the clocking function is provided for the network interface.
</p>
<dl>
<dt><b><u>*MODEM</u></b></dt>
<dd>The modem provides the clocking.
</dd>
<dt><b>*LOOP</b></dt>
<dd>The system inverts the clock from the modem and uses it as the transmit clock on the line.
</dd>
<dt><b>*INVERT</b></dt>
<dd>The transmit clock provided by the modem data circuit-terminating equipment (DCE) is inverted before use. This option can be used when having problems with high speed data transmission and the modem (DCE) does not support looped clocking.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNWIFR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGNWIFR.LINESPEED"></a>
<h3>Line speed (LINESPEED)</h3>
<p>Specifies the line speed in bits per second (bps)
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>56000</b></dt>
<dd>The line speed is 56000 bps.
</dd>
<dt><b>64000</b></dt>
<dd>The line speed is 64000 bps.
</dd>
<dt><b>128000</b></dt>
<dd>The line speed is 128000 bps.
</dd>
<dt><b>192000</b></dt>
<dd>The line speed is 192000 bps.
</dd>
<dt><b>256000</b></dt>
<dd>The line speed is 256000 bps.
</dd>
<dt><b>320000</b></dt>
<dd>The line speed is 320000 bps.
</dd>
<dt><b>384000</b></dt>
<dd>The line speed is 384000 bps.
</dd>
<dt><b>448000</b></dt>
<dd>The line speed is 448000 bps.
</dd>
<dt><b>512000</b></dt>
<dd>The line speed is 512000 bps.
</dd>
<dt><b>1024000</b></dt>
<dd>The line speed is 1024000 bps.
</dd>
<dt><b>1536000</b></dt>
<dd>The line speed is 1536000 bps.
</dd>
<dt><b>2048000</b></dt>
<dd>The line speed is 2048000 bps.
</dd>
<dt><b><i>line-speed</i></b></dt>
<dd>Specify the line speed. Valid values range from 56000 bps through 2048000 bps.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNWIFR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGNWIFR.LMIMODE"></a>
<h3>LMI mode (LMIMODE)</h3>
<p>Specifies whether the local management interface (LMI) for this adapter is configured as terminal equipment or a frame handler.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*TE</b></dt>
<dd>The local system is configured to interface with a frame relay network as terminal equipment. The frame relay network must be set to operate at ANSI T1.617 Annex D, to be compatible with system link management frames.
</dd>
<dt><b>*FH</b></dt>
<dd>The local system is configured to interface with another system as a frame handler. In this configuration, the local system is performing as the frame relay network.
</dd>
<dt><b>*ANNEXA</b></dt>
<dd>The local system is configured to interface with a frame relay network as terminal equipment. The frame relay network must operate as an ITU (previously CCITT) Q.933 Annex A to be compatible with system link management frames.
</dd>
<dt><b>*NONE</b></dt>
<dd>The local system is configured to interface with the frame relay network or another system without performing any LMI function.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNWIFR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGNWIFR.POLLITV"></a>
<h3>Polling interval (POLLITV)</h3>
<p>Specifies the rate of the polling cycle. The polling cycle consists of a status inquiry message and a status message exchange. The status message includes the status of the DLCI.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>10</b></dt>
<dd>A polling interval of 10 seconds is used.
</dd>
<dt><b><i>polling-interval</i></b></dt>
<dd>Specify the polling interval to be used within a 5 to 30 second range.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNWIFR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGNWIFR.FULLINQITV"></a>
<h3>Full inquiry interval (FULLINQITV)</h3>
<p>Specifies the number of polling cycles that occur before a full status inquiry is requested.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>6</b></dt>
<dd>A full inquiry interval of 6 polling cycles is used.
</dd>
<dt><b><i>full-inquiry-interval</i></b></dt>
<dd>Specify the number of polling cycles for a full status cycle to be requested. Valid values range from 1 through 255.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNWIFR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGNWIFR.TEXT"></a>
<h3>Text 'description' (TEXT)</h3>
<p>Specifies text that briefly describes the network interface.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*BLANK</b></dt>
<dd>Text is not specified.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify no more than 50 characters of text, enclosed in apostrophes.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNWIFR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGNWIFR.CMNRCYLMT"></a>
<h3>Recovery limits (CMNRCYLMT)</h3>
<p>Specifies the number of recovery attempts made by the system before an inquiry message is sent to the system operator. Also specifies the time (in minutes) that must elapse before the system sends an inquiry message to the system operator indicating that the recovery attempt count limit is reached.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*SYSVAL</b></dt>
<dd>The recovery limits specified in the QCMNRCYLMT system value are used.
</dd>
<dt><b>2</b></dt>
<dd>Two recovery attempts are made within the interval specified.
</dd>
<dt><b><i>count-limit</i></b></dt>
<dd>Specify the number of recovery attempts to be made. Valid values range from 0 through 99.
</dd>
<dt><b>5</b></dt>
<dd>A 15-second time-out period is used.
</dd>
<dt><b><i>time-interval</i></b></dt>
<dd>Specify the time interval (in minutes) at which the specified number of second-level recoveries are attempted. Valid values range from 0 through 120. If the value specified for <i>count-limit</i> is not 0, the value 0 specifies infinite recovery.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNWIFR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGNWIFR.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
CHGNWIFR NWID(THISONE) ONLINE(*YES) VRYWAIT(*NOWAIT)
CLOCK(*MODEM) POLLINTV(*SAME)
</pre>
</p>
<p>This command changes the network interface THISONE so it varies on automatically at initial program load (IPL) with no wait time. The clocking function for the network interface is changed so the modem provides the clocking. The polling interval remains the same as it was prior to this CHGNWIFR command.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNWIFR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGNWIFR.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF27A7</b></dt>
<dd>Network interface description &amp;1 not changed due to errors.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNWIFR.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink