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

1422 lines
50 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>Create Line Desc (Ethernet) (CRTLINETH)</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="CRTLINETH.Top_Of_Page"></a>
<h2>Create Line Desc (Ethernet) (CRTLINETH)</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="#CRTLINETH.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CRTLINETH.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CRTLINETH.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CRTLINETH"></a>
<p>The Create Line Description (Ethernet) (CRTLINETH) command creates a line description for an Ethernet line.
</p>
<h3>Common Errors for CRTLINETH</h3>
<p>In order to avoid common configuration errors, determine the port configuration of your switch or hub prior to configuring your line description. The line description parameters and the port configuration must match in order for operating system to communicate properly with the network.
</p>
<p>Use the following guidelines when configuring your line description:
</p>
<ul>
<li>If the switch or hub auto-negotiates either the line speed or duplex, specify *AUTO for both the LINESPEED and DUPLEX parameters. Do not specify LINESPEED(100M) or LINESPEED(10M) and DUPLEX(*FULL).
</li>
<li>If the switch or hub does not auto-negotiate either the line speed or duplex, specify the corresponding values on the system. For example, if the switch specifies a line speed of 100M and full duplex, specify LINESPEED(100M) and DUPLEX(*FULL) on the command.
</li>
</ul>
<p>One frequent cause of problems is a mismatch between the duplex setting of an auto-negotiation capable adapter like the 2838 and the switch or hub. In the case of auto-negotiation, duplex is not detectable by either the switch, hub, or the auto-negotiation capable adapter. So, there is no way to notify the user of a mismatch. Symptoms of a duplex mismatch include:
</p>
<ul>
<li>A6E3, A6F4 reference codes
</li>
<li>Poor performance
</li>
<li>Large numbers of TCP/IP retransmits
</li>
</ul>
<p>The following are common reference codes for 2809 and 2810 IOPs:
</p>
<dl>
<dt><b>A6E3</b></dt>
<dd>Duplex mismatch, cable problems, or an auto-negotiation timeout
</dd>
<dt><b>A6F4</b></dt>
<dd>Unable to establish link, line speed mismatch, duplex mismatch, or no cable.
</dd>
<dt><b>A42B</b></dt>
<dd>The switch or hub did not participate in auto-negotiation. A good link may not be established. The line description should be reconfigured to match the switch or hub.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINETH.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CRTLINETH.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="#CRTLINETH.LIND"><b>LIND</b></a></td>
<td valign="top">Line description</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINETH.RSRCNAME"><b>RSRCNAME</b></a></td>
<td valign="top">Resource name</td>
<td valign="top"><i>Name</i>, *NWID, *NWSD</td>
<td valign="top">Required, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINETH.ONLINE"><b>ONLINE</b></a></td>
<td valign="top">Online at IPL</td>
<td valign="top"><b><u>*YES</u></b>, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINETH.VRYWAIT"><b>VRYWAIT</b></a></td>
<td valign="top">Vary on wait</td>
<td valign="top">15-180, <b><u>*NOWAIT</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINETH.NWI"><b>NWI</b></a></td>
<td valign="top">Attached NWI</td>
<td valign="top"><i>Name</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINETH.NWITYPE"><b>NWITYPE</b></a></td>
<td valign="top">NWI type</td>
<td valign="top"><b><u>*FR</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINETH.NWIDLCI"><b>NWIDLCI</b></a></td>
<td valign="top">DLC identifier</td>
<td valign="top">1-1018, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CRTLINETH.NWS"><b>NWS</b></a></td>
<td valign="top">Network server description</td>
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values: <i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: </td>
<td valign="top">
<i>Name</i></td>
</tr>
<tr>
<td valign="top">Element 2: Port number</td>
<td valign="top">
1-2, *VRTETHPTP, *VRTETH0, *VRTETH1, *VRTETH2, *VRTETH3, *VRTETH4, *VRTETH5, *VRTETH6, *VRTETH7, *VRTETH8, *VRTETH9</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINETH.ASSOCPORT"><b>ASSOCPORT</b></a></td>
<td valign="top">Associated port resource name</td>
<td valign="top"><i>Name</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINETH.ADPTADR"><b>ADPTADR</b></a></td>
<td valign="top">Local adapter address</td>
<td valign="top"><i>Character value</i>, <b><u>*ADPT</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINETH.EXCHID"><b>EXCHID</b></a></td>
<td valign="top">Exchange identifier</td>
<td valign="top">05600000-056FFFFF, <b><u>*SYSGEN</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINETH.ETHSTD"><b>ETHSTD</b></a></td>
<td valign="top">Ethernet standard</td>
<td valign="top">*ETHV2, *IEEE8023, <b><u>*ALL</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINETH.LINESPEED"><b>LINESPEED</b></a></td>
<td valign="top">Line speed</td>
<td valign="top"><i>Character value</i>, <b><u>10M</u></b>, 100M, 1G, *AUTO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINETH.DUPLEX"><b>DUPLEX</b></a></td>
<td valign="top">Duplex</td>
<td valign="top"><i>Character value</i>, <b><u>*HALF</u></b>, *FULL, *AUTO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINETH.MAXFRAME"><b>MAXFRAME</b></a></td>
<td valign="top">Maximum frame size</td>
<td valign="top">1496-8996, <b><u>1496</u></b>, 8996</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="4"><a href="#CRTLINETH.SSAP"><b>SSAP</b></a></td>
<td valign="top">SSAP list</td>
<td valign="top">Single values: <b><u>*SYSGEN</u></b><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-8996, <b><u>*MAXFRAME</u></b>, 265, 521, 1033, 1466, 1493, 1496, 8996</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="#CRTLINETH.ACCTYPE"><b>ACCTYPE</b></a></td>
<td valign="top">ATM access type</td>
<td valign="top"><b><u>*SVC</u></b>, *PVC</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CRTLINETH.PVCID"><b>PVCID</b></a></td>
<td valign="top">PVC identifiers</td>
<td valign="top"><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="#CRTLINETH.USELECSADR"><b>USELECSADR</b></a></td>
<td valign="top">Use LECS address</td>
<td valign="top"><b><u>*YES</u></b>, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="4"><a href="#CRTLINETH.LESATMADR"><b>LESATMADR</b></a></td>
<td valign="top">LES ATM address</td>
<td valign="top">Single values: <b><u>*NONE</u></b><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="#CRTLINETH.EMLLANNAME"><b>EMLLANNAME</b></a></td>
<td valign="top">Emulated LAN name</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINETH.LECDSCTIMO"><b>LECDSCTIMO</b></a></td>
<td valign="top">LEC disconnect time out</td>
<td valign="top">1-30, <b><u>10</u></b>, *NOMAX</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINETH.TEXT"><b>TEXT</b></a></td>
<td valign="top">Text 'description'</td>
<td valign="top"><i>Character value</i>, <b><u>*BLANK</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINETH.NETCTL"><b>NETCTL</b></a></td>
<td valign="top">Network controller</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINETH.GRPADR"><b>GRPADR</b></a></td>
<td valign="top">Group address</td>
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 12 repetitions): 010000000000-FDFFFFFFFFFF</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINETH.MAXCTL"><b>MAXCTL</b></a></td>
<td valign="top">Maximum controllers</td>
<td valign="top">1-256, <b><u>40</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINETH.THRESHOLD"><b>THRESHOLD</b></a></td>
<td valign="top">Error threshold level</td>
<td valign="top"><b><u>*OFF</u></b>, *MIN, *MED, *MAX</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINETH.GENTSTFRM"><b>GENTSTFRM</b></a></td>
<td valign="top">Generate test frame</td>
<td valign="top"><b><u>*YES</u></b>, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINETH.LINKSPEED"><b>LINKSPEED</b></a></td>
<td valign="top">Link speed</td>
<td valign="top">1200-603979776000, *MIN, 4M, <b><u>10M</u></b>, 16M, 100M, *MAX</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINETH.COSTCNN"><b>COSTCNN</b></a></td>
<td valign="top">Cost/connect time</td>
<td valign="top">0-255, <b><u>0</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINETH.COSTBYTE"><b>COSTBYTE</b></a></td>
<td valign="top">Cost/byte</td>
<td valign="top">0-255, <b><u>0</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINETH.SECURITY"><b>SECURITY</b></a></td>
<td valign="top">Security for line</td>
<td valign="top"><b><u>*NONSECURE</u></b>, *PKTSWTNET, *UNDGRDCBL, *SECURECND, *GUARDCND, *ENCRYPTED, *MAX</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINETH.PRPDLY"><b>PRPDLY</b></a></td>
<td valign="top">Propagation delay</td>
<td valign="top"><b><u>*LAN</u></b>, *MIN, *TELEPHONE, *PKTSWTNET, *SATELLITE, *MAX</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINETH.USRDFN1"><b>USRDFN1</b></a></td>
<td valign="top">User-defined 1</td>
<td valign="top">0-255, <b><u>128</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINETH.USRDFN2"><b>USRDFN2</b></a></td>
<td valign="top">User-defined 2</td>
<td valign="top">0-255, <b><u>128</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINETH.USRDFN3"><b>USRDFN3</b></a></td>
<td valign="top">User-defined 3</td>
<td valign="top">0-255, <b><u>128</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINETH.AUTOCRTCTL"><b>AUTOCRTCTL</b></a></td>
<td valign="top">Autocreate controller</td>
<td valign="top">*YES, <b><u>*NO</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINETH.AUTODLTCTL"><b>AUTODLTCTL</b></a></td>
<td valign="top">Autodelete controller</td>
<td valign="top">1-10000, <b><u>1440</u></b>, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CRTLINETH.CMNRCYLMT"><b>CMNRCYLMT</b></a></td>
<td valign="top">Recovery limits</td>
<td valign="top">Single values: *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, <b><u>2</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: Time interval</td>
<td valign="top">
0-120, <b><u>5</u></b></td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CRTLINETH.MSGQ"><b>MSGQ</b></a></td>
<td valign="top">Message queue</td>
<td valign="top">Single values: <b><u>*SYSVAL</u></b>, *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="#CRTLINETH.AUT"><b>AUT</b></a></td>
<td valign="top">Authority</td>
<td valign="top"><i>Name</i>, <b><u>*CHANGE</u></b>, *ALL, *USE, *EXCLUDE, *LIBCRTAUT</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CRTLINETH.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CRTLINETH.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="#CRTLINETH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINETH.RSRCNAME"></a>
<h3>Resource name (RSRCNAME)</h3>
<p>Specifies the resource name that identifies the communications port.
</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>*NWID</b></dt>
<dd>The resource name specified on the attached frame relay network interface description is used.
</dd>
</dl>
<dl>
<dt><b>*NWSD</b></dt>
<dd>The resource name is determined by the network server used.
</dd>
</dl>
<dl>
<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="#CRTLINETH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINETH.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>*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="#CRTLINETH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINETH.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>*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="#CRTLINETH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINETH.NWI"></a>
<h3>Attached NWI (NWI)</h3>
<p>Specifies the network interface description to use.
</p>
<p>
<b>Note: </b>NWI(*NONE) must be specified when RSRCNAME(*NWID) is not specified. Otherwise, NWI(*NONE) can be specified only when NWIDLCI(*NONE) is also specified.
</p>
<dl>
<dt><b>*NONE</b></dt>
<dd>No network interface is specified.
</dd>
</dl>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the network interface description to be used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINETH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINETH.NWITYPE"></a>
<h3>NWI type (NWITYPE)</h3>
<p>Specifies the network interface type.
</p>
<p>
<b>Note: </b>This parameter is ignored when RSRCNAME is not *NWID.
</p>
<dl>
<dt><b>*FR</b></dt>
<dd>The network interface type is frame relay.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINETH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINETH.NWIDLCI"></a>
<p>Specifies the frame relay network interface data link connection identifier to be used.
</p>
<p>
<b>Note: </b>NWIDLCI(*NONE) must be specified when RSRCNAME(*NWID) is not specified. Otherwise, NWIDLCI(*NONE) can be specified only when NWI(*NONE) is also specified.
</p>
<dl>
<dt><b>*NONE</b></dt>
<dd>A DLCI is not specified for the network interface.
</dd>
</dl>
<dl>
<dt><b><i>data-link-connection-ID</i></b></dt>
<dd>Specify the DLCI for the network interface to which this line permanently attaches. Valid values range from 1 through 1018.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINETH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINETH.NWS"></a>
<h3>Network server description (NWS)</h3>
<p>Specifies the network server name to which this line is attached.
</p>
<p>
<b>Note: </b>NWS must be specified when RSRCNAME(*NWSD) is specified. NWS(*NONE) must be specified if RSRCNAME(*NWSD) is not specified.
</p>
<p>The possible Network server description values are:
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No server description is specified.
</dd>
</dl>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of an existing network server description to be used.
</dd>
</dl>
<p>The possible Network server port value is:
</p>
<dl>
<dt><b><i>network-server-port</i></b></dt>
<dd>Specify the network server port to which the line is attached. Valid values are 1,2 or virtual ports *VRTETHPTP or *VRTETHn where n is 0-9.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINETH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINETH.ASSOCPORT"></a>
<h3>Associated port resource name (ASSOCPORT)</h3>
<p>Specifies the resource name that describes the port that is used to establish a connection between a Windows network server and the network.
</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>ASSOCPORT parameter is only valid when RSRCNAME(*NWSD) is specified.
</p>
<dl>
<dt><b>*NONE</b></dt>
<dd>An associated port resource name is not associated with the line.
</dd>
</dl>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the resource name.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINETH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINETH.ADPTADR"></a>
<h3>Local adapter address (ADPTADR)</h3>
<p>Specifies the 12-character hexadecimal adapter address.
</p>
<dl>
<dt><b>*ADPT</b></dt>
<dd>The preset default address for this Ethernet adapter card is used.
<p>
<b>Note: </b>This value is not valid when RSRCNAME(*NWID) and NWITYPE(*FR) is specified.
</p>
<p>
<b>Note: </b>*ADPT must be specified when the NWS parameter specifies a virtual ethernet port number, *VRTETHPTP or *VRTETHn where n is 0-9.
</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 Ethernet network. The value specified must be an individual address that is locally administered. Valid values are *ADPT or hexadecimal 020000000000 through FEFFFFFFFFFF. The second digit must be 2, 6, A, or E.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINETH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINETH.EXCHID"></a>
<h3>Exchange identifier (EXCHID)</h3>
<p>Specifies the hexadecimal exchange identifier that is used to identify the local system to the remote system. The 8-digit hexadecimal exchange identifier contains three digits for the block number and five digits for the identifier of this system.
</p>
<dl>
<dt><b>*SYSGEN</b></dt>
<dd>This value allows the operating system to create the exchange identifier. Use the Display Line Description (DSPLIND) command to see the resulting exchange identifier.
</dd>
<dt><b><i>exchange-ID</i></b></dt>
<dd>Specify an 8-character (four hexadecimal bytes) exchange identifier ranging from 05600000 through 056FFFFF.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINETH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINETH.ETHSTD"></a>
<h3>Ethernet standard (ETHSTD)</h3>
<p>Identifies the Ethernet standard used on the network.
</p>
<dl>
<dt><b>*ALL</b></dt>
<dd>All Ethernet standards will be used on the network.
</dd>
<dt><b>*ETHV2</b></dt>
<dd>Ethernet Version 2.
</dd>
<dt><b>*IEEE8023</b></dt>
<dd>IEEE 802.3 standard.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINETH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINETH.LINESPEED"></a>
<h3>Line speed (LINESPEED)</h3>
<p>Specifies the line speed in bits per second (bps).
</p>
<dl>
<dt><b><i>10M</i></b></dt>
<dd>The line speed is 10 million bits per second.
</dd>
<dt><b><i>100M</i></b></dt>
<dd>The line speed is 100 million bits per second.
</dd>
<dt><b><i>1G</i></b></dt>
<dd>The line speed is 1 gigabit per second(1000 million bits per second).
<p>
<b>Note: </b>The value 1G specifies gigabit ethernet. Gigabit ethernet is only available when running strictly TCP/IP protocol. 1G must be specified when the NWS parameter specifies a virtual ethernet port number, *VRTETHPTP or *VRTETHn where n is 0-9.
</p>
</dd>
<dt><b>*AUTO</b></dt>
<dd>The line speed value will be determined by the hardware using auto-negotiation.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINETH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINETH.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>
<p>
<b>Note: </b>For optimum performance, this setting should match the setting on the switch or hub this line is connected to. Refer to iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter for more information.
</p>
<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.
<p>
<b>Note: </b>*FULL must be specified when the NWS parameter specifies a virtual ethernet port number, *VRTETHPTP or *VRTETHn where n is 0-9.
</p>
</dd>
</dl>
<dl>
<dt><b>*AUTO</b></dt>
<dd>The duplex value will be determined by the hardware using auto-negotiation.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINETH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINETH.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>1496</b></dt>
<dd>The maximum frame size is 1496 bytes.
</dd>
<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 1496 through 8996.
</dd>
</dl>
<p>
<b>Note: </b>When RSRCNAME(*NWID) specified, the only valid value for this parameter is 1496 bytes. If the maximum frame size is greater than 1496 bytes, LINESPEED(1G) or LINSPEED(*AUTO) and DUPLEX(*FULL) or DUPLEX(*AUTO) must be specified. 8996 is recommended when the NWS parameter specifies a virtual ethernet port number, *VRTETHPTP or *VRTETHn where n is 0-9.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINETH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINETH.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>*SYSGEN</b></dt>
<dd>The system determines the source service access points.
<ul>
<li>If ETHSTD(*ALL) or ETHSTD(*IEEE8023) is specified, the system generates the SSAPs 04, 12, AA, and C8.
</li>
<li>If ETHSTD(*ETHV2) is specified, the system generates the SSAPs 04 and 08
</li>
</ul>
</dd>
<dt><b><i>source-service-access-point</i></b></dt>
<dd>Specify a service access point for receiving and transmitting data. The SSAP must be hexadecimal 06 or AA for TCP/IP applications if ETHSTD is *ALL or *IEEE8023 (06 and AA are not allowed when ETHSTD is *ETHV2; however, TCP/IP can still be run). For SNA applications, specify a value ranging from 04 through 9C in multiples of four. For example, 7C is a valid choice. For non-SNA applications, specify a value ranging from 02 through FE in multiples of 2.
</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.
<p>
<b>Note: </b>If ETHSTD(*ETHV2) is specified, AA cannot be specified. However, TCP/IP can be run.
</p>
<p>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).
</p>
</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>
<li>For LAN printing applications, specify a SSAP value of 12 with SSAP type of *NONSNA.
</li>
<li>
</li>
</ul>
</dd>
</dl>
<p>The possible <b>SSAP maximum frame size</b> values are:
</p>
<dl>
<dt><b>*MAXFRAME</b></dt>
<dd>The system determines the maximum frame size (data field size) that can be transmitted or received. If ETHSTD(*ALL or *IEEE8023) was specified, *CALC produces a frame size of 1496 for TCP/IP and SNA SSAPs. If ETHSTD(*ETHV2) was specified, *CALC produces a frame size of 1493 for SNA SSAPs.
</dd>
<dt><b><i>SSAP-maximum-frame</i></b></dt>
<dd>Specify a maximum frame size for this SSAP. Valid values range from 265 through 8996 (265 through 1493 for SNA SSAPs when *ETHV2 is specified on the <b>Ethernet standard (ETHSTD)</b> parameter).
<p>
<b>Note: </b>When *NWID is specified on the <b>Resource name (RSRCNAME)</b> parameter and *ETHV2 is specified on the ETHSTD parameter, the valid values for this parameter range from 265 through 1486 bytes. When *NWID is specified on the RSRCNAME parameter, and *ALL or *IEEE8023 is specified on the ETHSTD parameter, the valid values for this parameter range from 265 through 1489 bytes. Maximum frame size larger than 1486 or 1489 is valid only when AA SSAP for TCP/IP is specified.
</p>
</dd>
</dl>
<p>The possible <b>SSAP type</b> values are:
</p>
<dl>
<dt><b>*CALC</b></dt>
<dd>The system determines the SSAP type based on the SSAP value specified.
</dd>
<dt><b>*SNA</b></dt>
<dd>The system uses IBM's Systems Network Architecture for communication. Only SSAP values of 04 through 9C in multiples of 4 are supported.
</dd>
<dt><b>*NONSNA</b></dt>
<dd>The system does not use SNA communications. Only SSAP values of 02 through FE in multiples of 2 are supported.
</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="#CRTLINETH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINETH.ACCTYPE"></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>ATM access type (ACCTYPE)</h3>
<p>Specifies the type of access to the ATM network.
</p>
<dl>
<dt><b>*SVC</b></dt>
<dd>This line represents a LAN emulation client using switched virtual circuits.
</dd>
<dt><b>*PVC</b></dt>
<dd>This line represents a LAN emulation client using a permanent virtual circuit.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINETH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINETH.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>
<p>
<b>Note: </b>PVCID is required if ACCTYPE(*PVC) is specified.
</p>
<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="#CRTLINETH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINETH.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>*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="#CRTLINETH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINETH.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>
<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="#CRTLINETH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINETH.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>*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="#CRTLINETH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINETH.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>10</b></dt>
<dd>The LE client waits 10 minutes.
</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="#CRTLINETH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINETH.TEXT"></a>
<h3>Text 'description' (TEXT)</h3>
<p>Specifies text that briefly describes the line description.
</p>
<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="#CRTLINETH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINETH.NETCTL"></a>
<h3>Network controller (NETCTL)</h3>
<p>Specifies the name of an existing network controller.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINETH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINETH.GRPADR"></a>
<h3>Group address (GRPADR)</h3>
<p>A group address is an address to which a subset of nodes on the Ethernet line will respond in addition to their local adapter addresses.
</p>
<dl>
<dt><b>*NONE</b></dt>
<dd>No group addresses are defined.
</dd>
<dt><b><i>group-address</i></b></dt>
<dd>Specify a group address of your choice to describe this system in the Ethernet network. Valid values are hexadecimal 010000000000 through FDFFFFFFFFFF. The second digit of the value specified must be 1, 3, 5, 7, 9, B, D, or F. Up to 12 addresses may be specified.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINETH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINETH.MAXCTL"></a>
<h3>Maximum controllers (MAXCTL)</h3>
<p>Specifies the maximum number of controllers that the line supports.
</p>
<dl>
<dt><b>40</b></dt>
<dd>The number of controllers is 40.
</dd>
<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 SNA 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="#CRTLINETH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINETH.THRESHOLD"></a>
<h3>Error threshold level (THRESHOLD)</h3>
<p>This parameter, and its values *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>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINETH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINETH.GENTSTFRM"></a>
<h3>Generate test frame (GENTSTFRM)</h3>
<p>Specifies whether the system will automatically generate test frames to determine network availability.
</p>
<dl>
<dt><b>*YES</b></dt>
<dd>The system will generate test frames.
</dd>
<dt><b>*NO</b></dt>
<dd>The system will not generate test frames.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINETH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINETH.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>10M</b></dt>
<dd>The link speed is 10 million bits per second.
</dd>
<dt><b>4M</b></dt>
<dd>The link speed is 4 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="#CRTLINETH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINETH.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>0</b></dt>
<dd>The cost per connect time is 0.
</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="#CRTLINETH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINETH.COSTBYTE"></a>
<h3>Cost/byte (COSTBYTE)</h3>
<p>Specifies the relative cost per byte for sending and receiving data on the line. Zero implies a low cost while 255 indicates a high cost. This parameter is valid only if APPN is used on the system.
</p>
<dl>
<dt><b>0</b></dt>
<dd>The cost per byte is 0.
</dd>
<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="#CRTLINETH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINETH.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>*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="#CRTLINETH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINETH.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>*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="#CRTLINETH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINETH.USRDFN1"></a>
<h3>User-defined 1 (USRDFN1)</h3>
<p>This field is used to describe unique characteristics of the line that you want to control. This parameter is valid only if advanced peer-to-peer networking (APPN) is used on the system.
</p>
<dl>
<dt><b>128</b></dt>
<dd>The default value is 128.
</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="#CRTLINETH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINETH.USRDFN2"></a>
<h3>User-defined 2 (USRDFN2)</h3>
<p>This field is used to describe unique characteristics of the line that you want to control. This parameter is valid only if advanced peer-to-peer networking (APPN) is used on the system.
</p>
<dl>
<dt><b>128</b></dt>
<dd>The default value is 128.
</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="#CRTLINETH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINETH.USRDFN3"></a>
<h3>User-defined 3 (USRDFN3)</h3>
<p>This field is used to describe unique characteristics of the line that you want to control. This parameter is valid only if advanced peer-to-peer networking (APPN) is used on the system.
</p>
<dl>
<dt><b>128</b></dt>
<dd>The default value is 128.
</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="#CRTLINETH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINETH.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>*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="#CRTLINETH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINETH.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>1440</b></dt>
<dd>The controller description can be idle for 1440 minutes (24 hours).
</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="#CRTLINETH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINETH.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>2</b></dt>
<dd>Two recovery attempts are made within the specified time interval.
</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>5</b></dt>
<dd>The specified number of recovery attempts are made within a 5-minute interval.
</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="#CRTLINETH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINETH.MSGQ"></a>
<h3>Message queue (MSGQ)</h3>
<p>Specifies the message queue to which operational messages are sent.
</p>
<dl>
<dt><b><u>*SYSVAL</u></b></dt>
<dd>The value in the system value QCFGMSGQ is used.
</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="#CRTLINETH.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINETH.AUT"></a>
<h3>Authority (AUT)</h3>
<p>Specifies the authority you are giving to users who do not have specific authority for the object, who are not on an authorization list, and whose group profile or supplemental group profiles do not have specific authority for the object.
</p>
<dl>
<dt><b><u>*CHANGE</u></b></dt>
<dd>The user can perform all operations on the object except those limited to the owner or controlled by object existence (*OBJEXIST) and object management (*OBJMGT) authorities. The user can change and perform basic functions on the object. *CHANGE authority provides object operational (*OBJOPR) authority and all data authority. If the object is an authorization list, the user cannot add, change, or remove users.
</dd>
</dl>
<dl>
<dt><b>*ALL</b></dt>
<dd>The user can perform all operations except those limited to the owner or controlled by authorization list management (*AUTLMGT) authority. The user can control the object's existence, specify the security for the object, change the object, and perform basic functions on the object. The user also can change ownership of the object.
</dd>
</dl>
<dl>
<dt><b>*USE</b></dt>
<dd>The user can perform basic operations on the object, such as running a program or reading a file. The user cannot change the object. Use (*USE) authority provides object operational (*OBJOPR), read (*READ), and execute (*EXECUTE) authorities.
</dd>
</dl>
<dl>
<dt><b>*EXCLUDE</b></dt>
<dd>The user cannot access the object.
</dd>
</dl>
<dl>
<dt><b>*LIBCRTAUT</b></dt>
<dd>The system determines the authority for the object by using the value specified for the <b>Create authority (CRTAUT)</b> parameter on the Create Library (CRTLIB) command for the library containing the object to be created. If the value specified for the CRTAUT parameter is changed, the new value will not affect any existing objects.
</dd>
</dl>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of an authorization list to be used for authority to the object. Users included in the authorization list are granted authority to the object as specified in the list. The authorization list must exist when the object is created.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINETH.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CRTLINETH.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Creating an Ethernet Line Description</b>
</p>
<p>
<pre>
CRTLINETH LIND(BOSTON) RSRCNAME(LIN041)
</pre>
</p>
<p>This command creates an Ethernet line description named BOSTON with a resource name of LIN041.
</p>
<p><b>Example 2: Creating an Ethernet Line Description Attached to a Network Server</b>
</p>
<p>
<pre>
CRTLINETH LIND(ETHLIN) RSRCNAME(*NWSD) NWS(REMODEL 1)
</pre>
</p>
<p>This command creates an Ethernet line description named ETHLIN that is attached to port 1 of the network server REMODEL.
</p>
<p><b>Example 3: Creating a Gigabit Ethernet Line Description</b>
</p>
<p>
<pre>
CRTLINETH LIND(GIGETH) RSRCNAME(LIN041) LINESPEED(1G)
DUPLEX(*FULL) MAXFRAME(8996)
</pre>
</p>
<p>This command creates an Ethernet line description using the maximum gigabit ethernet connectivity configuration.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINETH.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CRTLINETH.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF2718</b></dt>
<dd>Line description &amp;1 not created due to errors.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINETH.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>