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

1438 lines
45 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 Line Desc (Token-Ring) (CHGLINTRN)</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="CHGLINTRN.Top_Of_Page"></a>
<h2>Change Line Desc (Token-Ring) (CHGLINTRN)</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="#CHGLINTRN.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGLINTRN.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGLINTRN.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGLINTRN"></a>
<p>The Change Line Description (Token-Ring Network) (CHGLINTRN) command changes a line description for a token-ring network line.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLINTRN.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGLINTRN.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="#CHGLINTRN.LIND"><b>LIND</b></a></td>
<td valign="top">Line description</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Required, Key, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#CHGLINTRN.RSRCNAME"><b>RSRCNAME</b></a></td>
<td valign="top">Resource name</td>
<td valign="top"><i>Name</i>, <b><u>*SAME</u></b>, *NWID, *NWSD</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGLINTRN.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="#CHGLINTRN.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="#CHGLINTRN.MAXCTL"><b>MAXCTL</b></a></td>
<td valign="top">Maximum controllers</td>
<td valign="top">1-256, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGLINTRN.LINESPEED"><b>LINESPEED</b></a></td>
<td valign="top">Line speed</td>
<td valign="top"><b><u>*SAME</u></b>, 4M, 16M, 100M, *AUTO, *NWI</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGLINTRN.DUPLEX"><b>DUPLEX</b></a></td>
<td valign="top">Duplex</td>
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *HALF, *FULL, *AUTO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGLINTRN.MAXFRAME"><b>MAXFRAME</b></a></td>
<td valign="top">Maximum frame size</td>
<td valign="top">265-16393, <b><u>*SAME</u></b>, 265, 521, 1033, 1466, 1600, 1994, 4060, 8156, 16393</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGLINTRN.LECFRAME"><b>LECFRAME</b></a></td>
<td valign="top">LEC frame size</td>
<td valign="top"><b><u>*SAME</u></b>, 1516, 4544, 9234, 18190</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGLINTRN.ACTLANMGR"><b>ACTLANMGR</b></a></td>
<td valign="top">Activate LAN manager</td>
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGLINTRN.TRNLOGLVL"><b>TRNLOGLVL</b></a></td>
<td valign="top">TRLAN manager logging level</td>
<td valign="top"><b><u>*SAME</u></b>, *OFF, *MIN, *MED, *MAX</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGLINTRN.TRNMGRMODE"><b>TRNMGRMODE</b></a></td>
<td valign="top">TRLAN manager mode</td>
<td valign="top"><b><u>*SAME</u></b>, *OBSERVING, *CONTROLLING</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGLINTRN.LOGCFGCHG"><b>LOGCFGCHG</b></a></td>
<td valign="top">Log configuration changes</td>
<td valign="top"><b><u>*SAME</u></b>, *LOG, *NOLOG</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGLINTRN.TRNINFBCN"><b>TRNINFBCN</b></a></td>
<td valign="top">Token-ring inform of beacon</td>
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGLINTRN.ADPTADR"><b>ADPTADR</b></a></td>
<td valign="top">Local adapter address</td>
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *ADPT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGLINTRN.FCNADR"><b>FCNADR</b></a></td>
<td valign="top">Functional address</td>
<td valign="top">Single values: <b><u>*SAME</u></b>, *NONE<br>Other values (up to 31 repetitions): C00000000001, C00000000002, C00000000004, C00000000008, C00000000010, C00000000020, C00000000040, C00000000080, C00000000100, C00000000200, C00000000400, C00000000800, C00000001000, C00000002000, C00000004000, C00000008000, C00000010000, C00000020000, C00000040000, C00000080000, C00000100000, C00000200000, C00000400000, C00000800000, C00001000000, C00002000000, C00004000000, C00008000000, C00010000000, C00020000000, C00040000000</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="4"><a href="#CHGLINTRN.SSAP"><b>SSAP</b></a></td>
<td valign="top">SSAP list</td>
<td valign="top">Single values: <b><u>*SAME</u></b>, *SYSGEN<br>Other values (up to 24 repetitions): <i>Element list</i></td>
<td valign="top" rowspan="4">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Source service access point</td>
<td valign="top">
02-FE</td>
</tr>
<tr>
<td valign="top">Element 2: SSAP maximum frame</td>
<td valign="top">
265-16393, <b><u>*MAXFRAME</u></b>, 265, 521, 1033, 1466, 1994, 4060, 8156, 16393</td>
</tr>
<tr>
<td valign="top">Element 3: SSAP type</td>
<td valign="top">
<b><u>*CALC</u></b>, *NONSNA, *SNA, *HPR</td>
</tr>
<tr>
<td valign="top"><a href="#CHGLINTRN.ELYTKNRLS"><b>ELYTKNRLS</b></a></td>
<td valign="top">Early token release</td>
<td valign="top">*YES, *NO, <b><u>*SAME</u></b>, *LINESPEED</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGLINTRN.THRESHOLD"><b>THRESHOLD</b></a></td>
<td valign="top">Error threshold level</td>
<td valign="top"><b><u>*SAME</u></b>, *OFF, *MIN, *MED, *MAX</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CHGLINTRN.PVCID"><b>PVCID</b></a></td>
<td valign="top">PVC identifiers</td>
<td valign="top">Single values: <b><u>*SAME</u></b><br>Other values: <i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Virtual path identifier</td>
<td valign="top">
0-7</td>
</tr>
<tr>
<td valign="top">Element 2: Virtual circuit identifier</td>
<td valign="top">
32-4095</td>
</tr>
<tr>
<td valign="top"><a href="#CHGLINTRN.USELECSADR"><b>USELECSADR</b></a></td>
<td valign="top">Use LECS address</td>
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="4"><a href="#CHGLINTRN.LESATMADR"><b>LESATMADR</b></a></td>
<td valign="top">LES ATM address</td>
<td valign="top">Single values: <b><u>*SAME</u></b>, *NONE<br>Other values: <i>Element list</i></td>
<td valign="top" rowspan="4">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Network prefix</td>
<td valign="top">
<i>Hexadecimal value</i></td>
</tr>
<tr>
<td valign="top">Element 2: End system identifier</td>
<td valign="top">
<i>Hexadecimal value</i></td>
</tr>
<tr>
<td valign="top">Element 3: Selector byte</td>
<td valign="top">
<i>Hexadecimal value</i></td>
</tr>
<tr>
<td valign="top"><a href="#CHGLINTRN.EMLLANNAME"><b>EMLLANNAME</b></a></td>
<td valign="top">Emulated LAN 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="#CHGLINTRN.LECDSCTIMO"><b>LECDSCTIMO</b></a></td>
<td valign="top">LEC disconnect time out</td>
<td valign="top">1-30, <b><u>*SAME</u></b>, *NOMAX</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGLINTRN.LINKSPEED"><b>LINKSPEED</b></a></td>
<td valign="top">Link speed</td>
<td valign="top">1200-603979776000, <b><u>*SAME</u></b>, 4M, 10M, 16M, 100M, *MIN, *MAX</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGLINTRN.COSTCNN"><b>COSTCNN</b></a></td>
<td valign="top">Cost/connect time</td>
<td valign="top">0-255, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGLINTRN.COSTBYTE"><b>COSTBYTE</b></a></td>
<td valign="top">Cost/byte</td>
<td valign="top">0-255, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGLINTRN.SECURITY"><b>SECURITY</b></a></td>
<td valign="top">Security for line</td>
<td valign="top"><b><u>*SAME</u></b>, *NONSECURE, *PKTSWTNET, *UNDGRDCBL, *SECURECND, *GUARDCND, *ENCRYPTED, *MAX</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGLINTRN.PRPDLY"><b>PRPDLY</b></a></td>
<td valign="top">Propagation delay</td>
<td valign="top"><b><u>*SAME</u></b>, *MIN, *LAN, *TELEPHONE, *PKTSWTNET, *SATELLITE, *MAX</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGLINTRN.USRDFN1"><b>USRDFN1</b></a></td>
<td valign="top">User-defined 1</td>
<td valign="top">0-255, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGLINTRN.USRDFN2"><b>USRDFN2</b></a></td>
<td valign="top">User-defined 2</td>
<td valign="top">0-255, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGLINTRN.USRDFN3"><b>USRDFN3</b></a></td>
<td valign="top">User-defined 3</td>
<td valign="top">0-255, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGLINTRN.AUTOCRTCTL"><b>AUTOCRTCTL</b></a></td>
<td valign="top">Autocreate controller</td>
<td valign="top">*YES, *NO, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGLINTRN.AUTODLTCTL"><b>AUTODLTCTL</b></a></td>
<td valign="top">Autodelete controller</td>
<td valign="top">1-10000, *NONE, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CHGLINTRN.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>
<tr>
<td valign="top" rowspan="3"><a href="#CHGLINTRN.MSGQ"><b>MSGQ</b></a></td>
<td valign="top">Message queue</td>
<td valign="top">Single values: <b><u>*SAME</u></b>, *SYSVAL, *SYSOPR<br>Other values: <i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Message queue</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top">Qualifier 2: Library</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top"><a href="#CHGLINTRN.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="#CHGLINTRN.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGLINTRN.LIND"></a>
<h3>Line description (LIND)</h3>
<p>Specifies the name of the line description
</p>
<p>This is a required parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLINTRN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGLINTRN.RSRCNAME"></a>
<h3>Resource name (RSRCNAME)</h3>
<p>Specifies the resource name that identifies the hardware 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. The resource name is on the port. For example, the resource name may be CMN01 on an Ethernet port.
</p>
<p>
<b>Note: </b>The value specified on the RSRCNAME parameter cannot be changed from *NWSD to another value or from another value to *NWSD.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b>*NWID</b></dt>
<dd>The resource name specified on the attached frame relay network interface description is used.
</dd>
<dt><b>*NWSD</b></dt>
<dd>The resource name is determined by the network server description used.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the resource name of the communications port.
</dd>
</dl>
<p>This is a required parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLINTRN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGLINTRN.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>
</dl>
<dl>
<dt><b>*YES</b></dt>
<dd>The line is automatically varied on at initial program load (IPL).
</dd>
<dt><b>*NO</b></dt>
<dd>This line is not automatically varied on at IPL.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLINTRN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGLINTRN.VRYWAIT"></a>
<h3>Vary on wait (VRYWAIT)</h3>
<p>Specifies whether the line is varied on asynchronously or synchronously. For synchronous vary on, this parameter 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>
</dl>
<dl>
<dt><b>*NOWAIT</b></dt>
<dd>The system does not wait for vary on completion. The line 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 line is varied on, or until the specified time passes, before completing the Vary Configuration (VRYCFG) command.
</dd>
</dl>
<p><b>Notes:</b>
</p>
<ol>
<li>When ONLINE(*YES) is used, specifying a wait time in the line description affects system IPL time. In such cases, system IPL time is influenced by the amount of time required to synchronously vary on the line or reach the wait-time value.
</li>
<li>The time required to vary on a line is the time it takes to:
<ul>
<li>Put tasks in place to manage the line
</li>
<li>Activate the communications I/O processor (IOP), including downloading the IOP model-unique Licensed Internal Code
</li>
<li>Establish the communications tasks and processes
</li>
</ul>
</li>
</ol>
<p>Normal vary-on time ranges from 5 through 45 seconds, but can be longer, depending on the system, line protocol, and other factors.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLINTRN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGLINTRN.MAXCTL"></a>
<h3>Maximum controllers (MAXCTL)</h3>
<p>Specifies the maximum number of controllers that the line supports.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b><i>maximum-controllers</i></b></dt>
<dd>Specify value ranging from 1 to 256. The number must be large enough to account for all of the controllers that are currently active to this line, and for those controllers you know will be attached in the near future.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLINTRN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGLINTRN.LINESPEED"></a>
<h3>Line speed (LINESPEED)</h3>
<p>Specifies the line speed in bits per second (bps).
</p>
<p>
<b>Note: </b>When RSRCNAME(*NWID) and NWITYPE(*FR) are specified, *NWI must be specified on this parameter.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b>4M</b></dt>
<dd>The line speed is 4M bps.
</dd>
<dt><b>16M</b></dt>
<dd>The line speed is 16M bps.
</dd>
<dt><b>100M</b></dt>
<dd>The line speed is 100M bps.
</dd>
<dt><b>*AUTO</b></dt>
<dd>The line speed value will be determined by the hardware using auto-negotiation.
</dd>
<dt><b>*NWI</b></dt>
<dd>The line speed used is for a network interface.
</dd>
</dl>
<p>
<b>Note: </b>LINESPEED(*NWI) is only valid when RSRCNAME(*NWID) and NWITYPE(*FR) are specified.
</p>
<p>Duplex (DUPLEX) parameter set to *AUTO, if it has a default value and line speed (LINESPEED) parameter has 100M or *AUTO.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLINTRN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGLINTRN.DUPLEX"></a>
<h3>Duplex (DUPLEX)</h3>
<p>Specifies whether the hardware can send and receive data simultaneously. In half duplex mode, the hardware must alternate between sending data and receiving data. In full duplex mode, one cable is dedicated to send data and another cable is dedicated to receive data. Therefore, data can be sent and received simultaneously. A hub is required for full duplex.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b>*HALF</b></dt>
<dd>The line communicates using half duplex mode.
</dd>
<dt><b>*FULL</b></dt>
<dd>The line communicates using full duplex mode.
</dd>
<dt><b>*AUTO</b></dt>
<dd>The duplex value will be determined by the hardware using auto-negotiation.
</dd>
</dl>
<p>
<b>Note: </b>Duplex (DUPLEX) parameter set to *AUTO, if it has a default value and line speed (LINESPEED) parameter has 100M or *AUTO.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLINTRN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGLINTRN.MAXFRAME"></a>
<h3>Maximum frame size (MAXFRAME)</h3>
<p>Specifies the maximum frame size that can be transmitted and received on this line description.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b><i>maximum-frame-size</i></b></dt>
<dd>Specify the maximum frame size value to be used. The valid frame sizes (in bytes) range from 265 through 8148 bytes when the network interface is a frame relay. Otherwise, valid frame sizes (in bytes) range from 265 through 16393.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLINTRN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGLINTRN.LECFRAME"></a>
<p>
<b>Note: </b>This parameter is no longer supported. It exists solely for compatibility with releases earlier than Version 5 Release 3 Modification 0 of the operating system.
</p>
<h3>LEC frame size (LECFRAME)</h3>
<p>Specifies the LAN emulation client (LEC) frame size that can be transmitted and received on this line description.
</p>
<p>
<b>Note: </b>MAXFRAME must always be at least 20 less than this field.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b>4544</b></dt>
<dd>The LEC frame size is 4544 bytes.
</dd>
<dt><b>1516</b></dt>
<dd>The LEC frame size is 1516 bytes.
</dd>
<dt><b>9234</b></dt>
<dd>The LEC frame size is 9234 bytes.
</dd>
<dt><b>18190</b></dt>
<dd>The LEC frame size is 18190 bytes.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLINTRN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGLINTRN.ACTLANMGR"></a>
<h3>Activate LAN manager (ACTLANMGR)</h3>
<p>Specifies whether Local Area Network (LAN) Manager is activated for this line.
</p>
<p><b>NOTES:</b>
</p>
<ol>
<li>ACTLANMGR(*YES) must be specified when RSRCNAME(*NWID) is specified.
</li>
<li>ACTLANMGR(*NO) will ignore the values in TRNLOGLVL, TRNMGRMODE, LOGCFGCHG, and TRNINFBCN.
</li>
</ol>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b>*YES</b></dt>
<dd>LAN manager support is activated for this line.
</dd>
<dt><b>*NO</b></dt>
<dd>LAN manager support is not activated for this line.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLINTRN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGLINTRN.TRNLOGLVL"></a>
<h3>TRLAN manager logging level (TRNLOGLVL)</h3>
<p>Specifies the error logging level used by the TRLAN Manager.
</p>
<p>
<b>Note: </b>TRNLOGLVL(*OFF) must be specified when RSRCNAME(*NWID) is specified.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b>*OFF</b></dt>
<dd>All error reporting on the specified line is stopped.
</dd>
<dt><b>*MIN</b></dt>
<dd>The minimum reporting level, which reports only conditions that indicate degraded performance, is used.
</dd>
<dt><b>*MED</b></dt>
<dd>The medium reporting level, which reports conditions that indicate potential degraded performance in addition to the minimum reporting level, is used.
</dd>
<dt><b>*MAX</b></dt>
<dd>The maximum reporting level, which reports all error conditions, including the information that would be reported for *MIN and *MED reporting levels, is used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLINTRN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGLINTRN.TRNMGRMODE"></a>
<h3>TRLAN manager mode (TRNMGRMODE)</h3>
<p>Specifies which mode of network manager will be active on this line. A controlling manager can do functions that an observing manager can not do such as removing stations and performing a path test.
</p>
<p>However, only one controlling manager should be active on any one ring.
</p>
<p>
<b>Note: </b>TRNMGRMODE(*OBSERVING) must be specified when RSRCNAME(*NWID) is specified.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b>*OBSERVING</b></dt>
<dd>This line's manager will function as an observing network manger.
</dd>
<dt><b>*CONTROLLING</b></dt>
<dd>This line's manager will function as a controlling network manger.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLINTRN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGLINTRN.LOGCFGCHG"></a>
<h3>Log configuration changes (LOGCFGCHG)</h3>
<p>Specifies if this line's network manager will keep track of changes that happen to the nearest active upstream neighbor (NAUN).
</p>
<p>
<b>Note: </b>LOGCFGCHG(*LOG) must be specified when RSRCNAME(*NWID) is specified.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b>*LOG</b></dt>
<dd>The line manager logs the changes.
</dd>
<dt><b>*NOLOG</b></dt>
<dd>This line's manager will not log changes.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLINTRN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGLINTRN.TRNINFBCN"></a>
<h3>Token-ring inform of beacon (TRNINFBCN)</h3>
<p>Specifies if this line's network manager will send a message to the QSYSOPR message queue when a beaconing condition occurs.
</p>
<p>
<b>Note: </b>TRNINFBCN(*YES) must be specified when RSRCNAME(*NWID) is specified.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b>*YES</b></dt>
<dd>This line's manager will send a message to the QSYSOPR message queue when a beaconing condition occurs.
</dd>
<dt><b>*NO</b></dt>
<dd>This line's manager will not send a message to the QSYSOPR message queue when a beaconing condition occurs but will instead log an entry in the QHST log.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLINTRN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGLINTRN.ADPTADR"></a>
<h3>Local adapter address (ADPTADR)</h3>
<p>Specifies the local system's token-ring adapter address.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b>*ADPT</b></dt>
<dd>This value gives the user the present token-ring address for this token-ring adapter card. This address can be shown by using the Display Line Description (DSPLIND) command for this line description after it has successfully varied on.
<p>
<b>Note: </b>This value is not valid when RSRCNAME(*NWID) and NWITYPE(*FR) are specified, or RSRCNAME(*NWSD) is specified.
</p>
</dd>
<dt><b><i>local-adapter-address</i></b></dt>
<dd>Specify an adapter address of your choice to describe this system in the token-ring network. Valid values are hexadecimal 400000000000 through 7FFFFFFFFFFF.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLINTRN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGLINTRN.FCNADR"></a>
<h3>Functional address (FCNADR)</h3>
<p>Specifies whether token ring functional addresses are used.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b>*NONE</b></dt>
<dd>A functional address is not used.
</dd>
</dl>
<dl>
<dt><b><i>functional-address</i></b></dt>
<dd>Specify a group of hexadecimal functional addresses that are encoded in bit-significant format. Valid values range from hex C00000000001 through hex C00040000000. The first digit must be C. Functional addresses must be unique.
</dd>
</dl>
<dl>
<dt><b>Active Monitor</b></dt>
<dd>C00000000001
</dd>
<dt><b>Ring Parameter Server</b></dt>
<dd>C00000000002
</dd>
<dt><b>Network Server Heartbeat</b></dt>
<dd>C00000000004
</dd>
<dt><b>Ring Error Monitor</b></dt>
<dd>C00000000008
</dd>
<dt><b>Configuration Report Server</b></dt>
<dd>C00000000010
</dd>
<dt><b>Synchronous Bandwidth Manager</b></dt>
<dd>C00000000020
</dd>
<dt><b>Locate Directory Server</b></dt>
<dd>C00000000040
</dd>
<dt><b>NetBIOS</b></dt>
<dd>C00000000080
</dd>
<dt><b>Bridge</b></dt>
<dd>C00000000100
</dd>
<dt><b>IMPL Server</b></dt>
<dd>C00000000200
</dd>
<dt><b>Ring Authorization Server</b></dt>
<dd>C00000000400
</dd>
<dt><b>LAN Gateway</b></dt>
<dd>C00000000800
</dd>
<dt><b>Ring Wiring Concentration</b></dt>
<dd>C00000001000
</dd>
<dt><b>LAN Manager</b></dt>
<dd>C00000002000
</dd>
<dt><b>User-defined</b></dt>
<dd>C00000004000 through C00040000000
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLINTRN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGLINTRN.SSAP"></a>
<h3>SSAP list (SSAP)</h3>
<p>Specifies the source service access point (SSAP) information, including an SSAP value, a maximum frame size, and an SSAP type.
</p>
<p>You can enter multiple values for this parameter.
</p>
<p>The possible <b>source service access point</b> values are:
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b>*SYSGEN</b></dt>
<dd>The system generates the source service access points 04, 06 or AA.
</dd>
</dl>
<p>The possible SSAPs value is:
</p>
<dl>
<dt><b><i>source-service-access-point</i></b></dt>
<dd>Specify a source service access point for receiving and transmitting data. A maximum of 24 SSAP values can be specified.
<ul>
<li>For Transmission Control Protocol/Internet Protocol (TCP/IP) applications, the SSAP must be AA.
</li>
<li>For Systems Network Architecture (SNA) applications, the SSAP must be a hex value ranging from 04 through 9C in multiples of four (04, 08, 0C, and so on).
</li>
<li>For high-performance routing (HPR) applications, the SSAP must be hex C8.
</li>
<li>For non-SNA applications, the SSAP must be a hex value ranging from 02 through FE in multiples of two (02, 04, 06, and so on).
</li>
</ul>
</dd>
</dl>
<ul>
<li>For local area network (LAN) printer applications, specify hex 12 for the SSAP value and *NONSNA for the SSAP type.
</li>
</ul>
<p>The possible <b>SSAP maximum frame size</b> values are:
</p>
<dl>
<dt><b>*MAXFRAME</b></dt>
<dd>The system uses the value specified on the MAXFRAME parameter of this command for the SSAP maximum frame size.
</dd>
<dt><b><i>SSAP-maximum-frame</i></b></dt>
<dd>Specify the maximum SSAP frame size (the maximum size of the data field that can be transmitted or received). When RSRCNAME(*NWID) and NWITYPE(*FR) are specified, valid values for this parameter range from 265 through 8148 bytes. Otherwise, valid values for this parameter range from 265 through 16393 bytes.
<p>
<b>Note: </b>This value cannot be larger than the value specified on the MAXFRAME parameter.
</p>
</dd>
</dl>
<p>The possible <b>SSAP type</b> values are:
</p>
<dl>
<dt><b>*CALC</b></dt>
<dd>The system calculates the value to use.
</dd>
</dl>
<dl>
<dt><b>*SNA</b></dt>
<dd>The SSAP used is used for SNA communications. Valid values range from 04 through hex 9C in multiples of four (04, 08, 0C, and so on).
</dd>
<dt><b>*NONSNA</b></dt>
<dd>The SSAP is used for non-SNA communications. Valid values range from hex 02 through hex FE in multiples of two (02,04, 06, and so on).
</dd>
<dt><b>*HPR</b></dt>
<dd>The SSAP is used for HPR communications. It also can be used for SNA applications. The valid value is hex C8.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLINTRN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGLINTRN.ELYTKNRLS"></a>
<h3>Early token release (ELYTKNRLS)</h3>
<p>Specifies if the early token release option is used by this line.
</p>
<p>
<b>Note: </b>ELYTKNRLS(*LINESPEED) must be specified when RSRCNAME(*NWID) is specified.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b>*LINESPEED</b></dt>
<dd>This line's LINESPEED parameter will select if the early token release option will be used or not used.
</dd>
<dt><b>*YES</b></dt>
<dd>This line will use the early token release option.
</dd>
<dt><b>*NO</b></dt>
<dd>This line will not use the early token release option.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLINTRN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGLINTRN.THRESHOLD"></a>
<h3>Error threshold level (THRESHOLD)</h3>
<p>This parameter, and its values *SAME, *OFF, *MIN, *MED, and *MAX, can be specified but it is not used by the system starting in release V2R3M0. The parameter may be removed in a later release.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLINTRN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGLINTRN.PVCID"></a>
<p>
<b>Note: </b>This parameter is no longer supported. It exists solely for compatibility with releases earlier than Version 5 Release 3 Modification 0 of the operating system.
</p>
<h3>PVC identifiers (PVCID)</h3>
<p>Specifies the virtual path identifier and virtual circuit identifier pairs associated with this permanent virtual circuit.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<p>The possible <b>Virtual Path Identifier</b> value is:
</p>
<dl>
<dt><b><i>virtual-path-id</i></b></dt>
<dd>Specify a number that represents the virtual path identifier. This number must be in the range of 0 to 7.
</dd>
</dl>
<p>The possible <b>Virtual Circuit Identifier</b> value is:
</p>
<dl>
<dt><b><i>virtual-circuit-id</i></b></dt>
<dd>Specify a number that represents the virtual circuit identifier. This number must be in the range of 32 to 4095.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLINTRN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGLINTRN.USELECSADR"></a>
<p>
<b>Note: </b>This parameter is no longer supported. It exists solely for compatibility with releases earlier than Version 5 Release 3 Modification 0 of the operating system.
</p>
<h3>Use LECS address (USELECSADR)</h3>
<p>Specifies whether the LAN emulation configuration server (LECS) should be connected to request the remote LAN emulation server (LES) address.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b>*YES</b></dt>
<dd>The LECS address is used.
</dd>
<dt><b>*NO</b></dt>
<dd>The LECS address is not used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLINTRN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGLINTRN.LESATMADR"></a>
<p>
<b>Note: </b>This parameter is no longer supported. It exists solely for compatibility with releases earlier than Version 5 Release 3 Modification 0 of the operating system.
</p>
<h3>LES ATM address (LESATMADR)</h3>
<p>Specifies the ATM network address of the remote LAN emulation server.
</p>
<p>
<b>Note: </b>This parameter cannot be *NONE if USELECSADR(*NO) is specified.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<p>The possible <b>Single Value</b> is:
</p>
<dl>
<dt><b>*NONE</b></dt>
<dd>The ATM network address is not used.
</dd>
</dl>
<p>The possible <b>Network prefix</b> value is:
</p>
<dl>
<dt><b><i>network-prefix</i></b></dt>
<dd>Specify the network prefix of the ATM address of the remote server. This is a 26 digit hexadecimal value.
</dd>
</dl>
<p>The possible <b>End system identifier</b> value is:
</p>
<dl>
<dt><b><i>end-system-identifier</i></b></dt>
<dd>Specify the end system identifier of the remote server. This is a 12 digit hexadecimal value.
</dd>
</dl>
<p>The possible <b>Selector byte</b> value is:
</p>
<dl>
<dt><b><i>selector byte</i></b></dt>
<dd>Specify the selector byte of the remote server. This is a two digit hexadecimal value.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLINTRN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGLINTRN.EMLLANNAME"></a>
<p>
<b>Note: </b>This parameter is no longer supported. It exists solely for compatibility with releases earlier than Version 5 Release 3 Modification 0 of the operating system.
</p>
<h3>Emulated LAN name (EMLLANNAME)</h3>
<p>Specifies the emulated LAN name.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b>*NONE</b></dt>
<dd>The emulated LAN name not used.
</dd>
<dt><b><i>emulated-LAN-name</i></b></dt>
<dd>Specify the emulated LAN name. A maximum of 32 characters can be specified.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLINTRN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGLINTRN.LECDSCTIMO"></a>
<p>
<b>Note: </b>This parameter is no longer supported. It exists solely for compatibility with releases earlier than Version 5 Release 3 Modification 0 of the operating system.
</p>
<h3>LEC disconnect time out (LECDSCTIMO)</h3>
<p>Specifies the amount of time in minutes a LAN emulation (LE) client waits before disconnecting an idle virtual circuit connection to another client.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b>*NOMAX</b></dt>
<dd>The LE client waits indefinitely.
</dd>
<dt><b><i>LEC-disconnect-timeout</i></b></dt>
<dd>Specify the number of minutes the LE client waits before disconnecting an idle virtual circuit connection to another client. The value must be in the range of 1 to 30 minutes.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLINTRN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGLINTRN.LINKSPEED"></a>
<h3>Link speed (LINKSPEED)</h3>
<p>Specifies the link speed in bits per second (bps). This parameter is valid only if advanced peer-to-peer networking (APPN) is used on the system.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b>4M</b></dt>
<dd>The link speed is 4 million bits per second.
</dd>
<dt><b>10M</b></dt>
<dd>The link speed is 10 million bits per second.
</dd>
<dt><b>16M</b></dt>
<dd>The link speed is 16 million bits per second.
</dd>
<dt><b>100M</b></dt>
<dd>The link speed is 100 million bits per second.
</dd>
</dl>
<dl>
<dt><b>*MIN</b></dt>
<dd>A link speed of less than 1200 bps is used.
</dd>
</dl>
<dl>
<dt><b>*MAX</b></dt>
<dd>A link speed greater than 100M bps is used.
</dd>
</dl>
<dl>
<dt><b><i>link-speed</i></b></dt>
<dd>Specify the link speed. Valid values range from 1200 to 603979776000 bps.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLINTRN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGLINTRN.COSTCNN"></a>
<h3>Cost/connect time (COSTCNN)</h3>
<p>Specifies the relative cost of being connected on the line. This parameter is required only if APPN is used on the system.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b><i>cost-per-connect-time</i></b></dt>
<dd>Specify a value ranging from 0 through 255.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLINTRN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGLINTRN.COSTBYTE"></a>
<h3>Cost/byte (COSTBYTE)</h3>
<p>Specifies the relative cost per byte for sending and receiving data on the line. This parameter is required only if APPN is used on the system.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b><i>cost-per-byte</i></b></dt>
<dd>Specify a value ranging from 0 through 255.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLINTRN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGLINTRN.SECURITY"></a>
<h3>Security for line (SECURITY)</h3>
<p>Specifies the security level of the physical line. This parameter is valid only if APPN is used on the system.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b>*NONSECURE</b></dt>
<dd>There is no security on the line.
</dd>
<dt><b>*PKTSWTNET</b></dt>
<dd>A packet switched network is used. Data does not always follow the same path through the network.
</dd>
<dt><b>*UNDRGRDCBL</b></dt>
<dd>An underground cable is used.
</dd>
<dt><b>*SECURECND</b></dt>
<dd>A secure, but unguarded, conduit is used.
</dd>
<dt><b>*GUARDCND</b></dt>
<dd>A guarded conduit, protected against physical tapping, is used.
</dd>
<dt><b>*ENCRYPTED</b></dt>
<dd>Data flowing on the line is encrypted.
</dd>
</dl>
<dl>
<dt><b>*MAX</b></dt>
<dd>A guarded conduit, protected against physical and radiation tapping is used.
</dd>
</dl>
<dl>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLINTRN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGLINTRN.PRPDLY"></a>
<h3>Propagation delay (PRPDLY)</h3>
<p>Specifies the level of propagation delay on the line. This parameter is valid only if advanced peer-to-peer networking (APPN) is used on the system. The order of the values from shortest to longest delay is *MIN, *LAN, *TELEPHONE, *PKTSWTNET, and *SATELLITE.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b>*LAN</b></dt>
<dd>Propagation delay using a local area network.
</dd>
</dl>
<dl>
<dt><b>*MIN</b></dt>
<dd>The minimum propagation delay is used.
</dd>
</dl>
<dl>
<dt><b>*TELEPHONE</b></dt>
<dd>Propagation delay using telephone lines.
</dd>
<dt><b>*PKTSWTNET</b></dt>
<dd>Propagation delay using a packet switched network.
</dd>
<dt><b>*SATELLITE</b></dt>
<dd>Propagation delay using satellite communications.
</dd>
</dl>
<dl>
<dt><b>*MAX</b></dt>
<dd>The maximum propagation delay is used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLINTRN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGLINTRN.USRDFN1"></a>
<h3>User-defined 1 (USRDFN1)</h3>
<p>Specifies the first of the three user-defined fields. This field is used to describe unique characteristics of the line that is controlled. This parameter is valid only if APPN is used on the system.
</p>
<p>
<b>Note: </b>Information about the values that are specified for this parameter is provided in the APPN Support information in the iSeries Information Center at http://www.iseries.ibm.com/infocenter.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b><i>user-defined-1</i></b></dt>
<dd>Specify a value ranging from 0 through 255.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLINTRN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGLINTRN.USRDFN2"></a>
<h3>User-defined 2 (USRDFN2)</h3>
<p>Specifies the second of the three user-defined fields. This field is used to describe unique characteristics of the line that is controlled. This parameter is valid only if APPN is used on the system.
</p>
<p>
<b>Note: </b>Information about the values that are specified for this parameter is provided in the APPN Support information in the iSeries Information Center at http://www.iseries.ibm.com/infocenter.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b><i>user-defined-2</i></b></dt>
<dd>Specify a value ranging from 0 through 255.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLINTRN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGLINTRN.USRDFN3"></a>
<h3>User-defined 3 (USRDFN3)</h3>
<p>Specifies the third of the three user-defined fields. This field is used to describe unique characteristics of the line that is controlled. This parameter is valid only if APPN is used on the system.
</p>
<p>
<b>Note: </b>Information about the values that are specified for this parameter is provided in the APPN Support information in the iSeries Information Center at http://www.iseries.ibm.com/infocenter.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b><i>user-defined-3</i></b></dt>
<dd>Specify a value ranging from 0 through 255.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLINTRN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGLINTRN.AUTOCRTCTL"></a>
<h3>Autocreate controller (AUTOCRTCTL)</h3>
<p>Specifies whether the system automatically creates an advanced program-to-program communications (APPC) controller description when an incoming advanced peer-to-peer networking (advanced peer-to-peer networking (APPN)) call is received from an adjacent system on the Local Area Network (LAN).
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b>*NO</b></dt>
<dd>A controller description is not automatically created for this line.
</dd>
<dt><b>*YES</b></dt>
<dd>A controller description is automatically created for this line.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLINTRN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGLINTRN.AUTODLTCTL"></a>
<h3>Autodelete controller (AUTODLTCTL)</h3>
<p>Specifies how many minutes the system waits before automatically varying off and deleting automatically created advanced program-to-program communications (APPC) controller descriptions (associated with this line) which have gone to an idle state.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b>*NONE</b></dt>
<dd>The controller descriptions for this line are not automatically deleted.
</dd>
<dt><b><i>auto-delete-controller</i></b></dt>
<dd>Specify a value ranging from 1 through 10000 minutes. The value 1440 is 24 hours.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLINTRN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGLINTRN.CMNRCYLMT"></a>
<h3>Recovery limits (CMNRCYLMT)</h3>
<p>Specifies the second-level communications recovery limits to be used for this line description.
</p>
<p>The possible <b>count-limit</b> values are:
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b>*SYSVAL</b></dt>
<dd>The value in the QCMNRCYLMT system value is used.
</dd>
</dl>
<dl>
<dt><b><i>count-limit</i></b></dt>
<dd>Specify the number of recovery attempts to be performed by the system. Valid values range from 0 through 99.
</dd>
</dl>
<p>The possible <b>time-interval</b> values are:
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b><i>time-interval</i></b></dt>
<dd>Specify the number of minutes within which recovery attempts are made. Valid values range from 0 through 120 in 1-minute intervals.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLINTRN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGLINTRN.MSGQ"></a>
<h3>Message queue (MSGQ)</h3>
<p>Specifies the message queue to which operational messages are sent.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b>*SYSVAL</b></dt>
<dd>Messages are sent to the message queue defined in the QCFGMSGQ system value.
</dd>
</dl>
<dl>
<dt><b>*SYSOPR</b></dt>
<dd>Messages are sent to the system operator message queue (QSYS/QSYSOPR).
</dd>
</dl>
<p><b>Qualifier 1: Message queue</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the message queue to which operational messages are sent.
</dd>
</dl>
<p><b>Qualifier 2: Library</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the library where the message queue is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLINTRN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGLINTRN.TEXT"></a>
<h3>Text 'description' (TEXT)</h3>
<p>Specifies text that briefly describes the line description.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<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="#CHGLINTRN.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGLINTRN.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
CHGLINTRN LIND(TRLAN1) MAXCTL(50)
</pre>
</p>
<p>This command changes the maximum number of controllers for line description TRLAN1 to 50.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLINTRN.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGLINTRN.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF261E</b></dt>
<dd>Line description &amp;1 not changed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLINTRN.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>