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

955 lines
34 KiB
HTML

<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Create Line Desc (DDI) (CRTLINDDI)</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="CRTLINDDI.Top_Of_Page"></a>
<h2>Create Line Desc (DDI) (CRTLINDDI)</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="#CRTLINDDI.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CRTLINDDI.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CRTLINDDI.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CRTLINDDI"></a>
<p>The Create Line Description (Distributed Data Interface) (CRTLINDDI) command creates a line description for a data-description interface line such as an FDDI (Fiber Distributed Data Interface) local area network. More information about using this command is in the Communications Configuration book, SC41-5401.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINDDI.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CRTLINDDI.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="#CRTLINDDI.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="#CRTLINDDI.RSRCNAME"><b>RSRCNAME</b></a></td>
<td valign="top">Resource name</td>
<td valign="top"><i>Name</i>, *NWID</td>
<td valign="top">Required, Key, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINDDI.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="#CRTLINDDI.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="#CRTLINDDI.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="#CRTLINDDI.MAXFRAME"><b>MAXFRAME</b></a></td>
<td valign="top">Maximum frame size</td>
<td valign="top">265-4444</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINDDI.LOGLVL"><b>LOGLVL</b></a></td>
<td valign="top">Logging level</td>
<td valign="top"><b><u>*OFF</u></b>, *ERRORS, *ALL</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINDDI.LCLMGRMODE"><b>LCLMGRMODE</b></a></td>
<td valign="top">Local manager mode</td>
<td valign="top"><b><u>*OBSERVING</u></b>, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINDDI.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="#CRTLINDDI.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"><a href="#CRTLINDDI.ADPTADR"><b>ADPTADR</b></a></td>
<td valign="top">Local adapter address</td>
<td valign="top">400000000000-7FFFFFFFFFFF, <b><u>*ADPT</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINDDI.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" rowspan="4"><a href="#CRTLINDDI.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-4444, <b><u>*MAXFRAME</u></b></td>
</tr>
<tr>
<td valign="top">Element 3: SSAP type</td>
<td valign="top">
<b><u>*CALC</u></b>, *NONSNA, *SNA</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINDDI.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="#CRTLINDDI.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="#CRTLINDDI.GRPADR"><b>GRPADR</b></a></td>
<td valign="top">Group address</td>
<td valign="top">Values (up to 12 repetitions): 800000000000-FFFFFFFFFFFE, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINDDI.TKNRTTTIME"><b>TKNRTTTIME</b></a></td>
<td valign="top">Token rotation time</td>
<td valign="top">4-167, <b><u>*CALC</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINDDI.LINKSPEED"><b>LINKSPEED</b></a></td>
<td valign="top">Link speed</td>
<td valign="top">*MIN, 1200, 2400, 4800, 7200, 9600, 14400, 19200, 48000, 56000, 64000, 112000, 128000, 168000, 192000, 224000, 256000, 280000, 320000, 336000, 384000, 448000, 499000, 576000, 614000, 691000, 768000, 845000, 922000, 998000, 1075000, 1152000, 1229000, 1382000, 1536000, 1690000, 1843000, 1997000, 4M, 10M, 16M, <b><u>*MAX</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINDDI.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="#CRTLINDDI.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="#CRTLINDDI.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="#CRTLINDDI.PRPDLY"><b>PRPDLY</b></a></td>
<td valign="top">Propagation delay</td>
<td valign="top">*PKTSWTNET, <b><u>*LAN</u></b>, *MIN, *TELEPHONE, *SATELLITE, *MAX</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINDDI.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="#CRTLINDDI.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="#CRTLINDDI.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="#CRTLINDDI.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="#CRTLINDDI.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="#CRTLINDDI.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="#CRTLINDDI.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="#CRTLINDDI.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="#CRTLINDDI.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CRTLINDDI.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="#CRTLINDDI.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINDDI.RSRCNAME"></a>
<h3>Resource name (RSRCNAME)</h3>
<p>Specifies the resource name that identifies the hardware that the description represents.
</p>
<p>
<b>Note: </b>Use the Work with Hardware Resources (WRKHDWRSC) command with *CMN specified for the TYPE parameter to help determine the resource name. 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 *NWID to another value or from another value to *NWID.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b>*NWID</b></dt>
<dd>The resource name specified on the attached frame relay network interface description is used.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify a resource name.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINDDI.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINDDI.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="#CRTLINDDI.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINDDI.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="#CRTLINDDI.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINDDI.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 line supports 40 controllers.
</dd>
<dt><b><i>maximum-controllers</i></b></dt>
<dd>Specify a number large enough to account for all controllers currently active to this network, and the controllers that will be attached in the near future. Valid values range from 1 through 256.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINDDI.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINDDI.MAXFRAME"></a>
<h3>Maximum frame size (MAXFRAME)</h3>
<p>Specifies the maximum frame (path information unit (PIU)) size that the controller can send or receive. This value is used to calculate request unit (RU) sizes. Since the maximum PIU size that the controller can send or receive is negotiated when system identifiers are exchanged, the maximum PIU size used at run time may be different. This value matches the corresponding value on the host system.
</p>
<p>
<b>Note: </b>The MAXFRAME value is provided by your telephone carrier from which you should subtract 44 bytes for the size of the header.
</p>
<dl>
<dt><b>4105</b></dt>
<dd>The maximum frame size is 4105 bytes.
<p>
<b>Note: </b>This value changes to 1556 when RSRCNAME(*NWID) is specified.
</p>
</dd>
<dt><b><i>maximum-frame-size</i></b></dt>
<dd>Specify the maximum frame size. Valid values range from 265 through 4444 bytes.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINDDI.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINDDI.LOGLVL"></a>
<h3>Logging level (LOGLVL)</h3>
<p>Specifies the error logging level used by the DDI local area network (LAN) manager. This parameter is used to determine whether unsolicited LAN errors are logged. These messages are logged in either the QHST message queue or the QSYSOPR message queue.
</p>
<p>
<b>Note: </b>The LOGLVL parameter is not used when RSRCNAME(*NWID) is specified.
</p>
<dl>
<dt><b>*OFF</b></dt>
<dd>Errors are not monitored.
</dd>
<dt><b>*ERRORS</b></dt>
<dd>Logs LAN manager error messages only.
</dd>
<dt><b>*ALL</b></dt>
<dd>Logs LAN manager error messages and informational messages.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINDDI.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINDDI.LCLMGRMODE"></a>
<h3>Local manager mode (LCLMGRMODE)</h3>
<p>Specifies whether this station is an observing network manager. An observing network manager logs network error messages and informational messages for this and other stations on the ring. These messages are logged in either the QHST message queue or the QSYSOPR message queue.
</p>
<p>Examples of information available in observing mode only include errors on remote stations that do not affect general ring operation, or information about stations that are joining or leaving the ring.
</p>
<p>
<b>Note: </b>The LCLMGRMODE parameter is not used when RSRCNAME(*NWID) or LOGLVL(*OFF) is specified.
</p>
<dl>
<dt><b>*OBSERVING</b></dt>
<dd>The LAN manager function of this station retrieves information generated by all adapters.
</dd>
<dt><b>*NONE</b></dt>
<dd>The LAN manager function of this station only retrieves information generated by the local adapter.
<p>
<b>Note: </b>A local area network manager logs only those messages that pertain to this station and its ability to access the ring when *NONE is specified.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINDDI.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINDDI.NWI"></a>
<h3>Attached NWI (NWI)</h3>
<p>Specifies an attached nonswitched frame relay NWI.
</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 an attached nonswitched frame relay NWI.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINDDI.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINDDI.NWIDLCI"></a>
<h3>DLC identifier (NWIDLCI)</h3>
<p>Specifies the data link connection identifier (DLCI) for the network interface.
</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="#CRTLINDDI.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINDDI.ADPTADR"></a>
<h3>Local adapter address (ADPTADR)</h3>
<p>Specifies the 12-character hexadecimal adapter address.
</p>
<p>
<b>Note: </b>ADPTADR(*ADPT) cannot be specified when RSRCNAME(*NWID) is specified.
</p>
<dl>
<dt><b>*ADPT</b></dt>
<dd>This value gives the user the preset DDI default address for this DDI adapter card. The user may display this by doing a DSPLIND on this line description after it has successfully varied on.
</dd>
<dt><b><i>local-adapter-address</i></b></dt>
<dd>Specify an address for this system in the DDI network. Valid values range from hexadecimal 400000000000 through 7FFFFFFFFFFF.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINDDI.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINDDI.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>The operating system generates the exchange identifier.
</dd>
<dt><b><i>exchange-identifier</i></b></dt>
<dd>Specify an exchange identifier composed of eight hexadecimal digits starting with 056.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINDDI.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINDDI.SSAP"></a>
<h3>SSAP list (SSAP)</h3>
<p>Specifies source service access points (SSAPs). This is the hexadecimal logical address used to route incoming data from the bus to the proper user. A maximum frame size can be specified for each SSAP. Valid SSAP values are AA (for TCP/IP), and 04 through 9C divisible by 4 (for SNA).
</p>
<p>The destination service access point (DSAP), specified by the remote controller, must match one of the SSAPs specified in order for communication to occur. All SSAP values must be unique.
</p>
<dl>
<dt><b>*SYSGEN</b></dt>
<dd>The system automatically creates three SSAPs, hex 04 for SNA, and hex 06 for TCP/IP applications.
</dd>
</dl>
<p>The possible <b>SSAP</b> values are:
</p>
<dl>
<dt><b><i>source-service-access-point</i></b></dt>
<dd>Specify a maximum of 24 SSAPs using valid SSAP values.
</dd>
</dl>
<p>You can enter multiple values for this parameter.
</p>
<p>The possible <b>Frame Size for SSAP</b> values are:
</p>
<dl>
<dt><b>*MAXFRAME</b></dt>
<dd>The frame size specified on the MAXFRAME parameter is used.
</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 may be transmitted or received). Valid values for this parameter range from 265 through 4444 bytes, but must not exceed the value of the MAXFRAME parameter.
</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 following values:
<ul>
<li>04 through 9C, divisible by 4 (for SNA)
</li>
<li>02 through FE, divisible by 2 (for non-SNA)
</li>
</ul>
</dd>
<dt><b>*SNA</b></dt>
<dd>The SSAP is used for SNA communications. Valid values range from 04 through 9C and must be divisible by 4.
</dd>
<dt><b>*NONSNA</b></dt>
<dd>The SSAP is used for non-SNA communications. Valid values range from 02 through FE and must be divisible by 2.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINDDI.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINDDI.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="#CRTLINDDI.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINDDI.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="#CRTLINDDI.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINDDI.GRPADR"></a>
<h3>Group address (GRPADR)</h3>
<p>Specifies the distributed data interface group addresses used. Group addresses must each be specified as a 12-digit hexadecimal number. Valid values range from 800000000000 through FFFFFFFFFFFE.
</p>
<p>You can enter multiple values for this parameter.
</p>
<dl>
<dt><b>*NONE</b></dt>
<dd>No group addresses are specified.
</dd>
<dt><b><i>group-address</i></b></dt>
<dd>Specify the group addresses to be used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINDDI.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINDDI.TKNRTTTIME"></a>
<h3>Token rotation time (TKNRTTTIME)</h3>
<p>Specifies the token rotation time requested. This value is used when th station bids on the network. The lowest value of all attached stations on a ring determines the value the ring uses.
</p>
<p>
<b>Note: </b>TKNRTTTIME(*CALC) must be specified when RSRCNAME(*NWID) is specified.
</p>
<dl>
<dt><b>*CALC</b></dt>
<dd>The system calculates the value based on the type of line that is linked to the controller.
</dd>
<dt><b><i>token-rotation-time</i></b></dt>
<dd>Specify a value ranging from 4 through 167 milliseconds.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINDDI.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINDDI.LINKSPEED"></a>
<h3>Link speed (LINKSPEED)</h3>
<p>Specifies the link speed in bits per second (bps). This parameter is valid only if APPN is used on the system.
</p>
<dl>
<dt><b>*MAX</b></dt>
<dd>A link speed greater than 16M bps is used.
</dd>
</dl>
<dl>
<dt><b>4M</b></dt>
<dd>The link speed is 4M bps.
</dd>
</dl>
<dl>
<dt><b>*MIN</b></dt>
<dd>A link speed of less than 1200 bps is used.
</dd>
</dl>
<dl>
<dt><b><i>link-speed</i></b></dt>
<dd>Specify the link speed. Valid values are: 1200, 2400, 4800, 7200, 9600, 14400, 19200, 48000, 56000, 64000, 112000, 128000, 168000, 192000, 224000, 256000, 280000, 320000, 336000, 384000, 448000, 499000, 576000, 614000, 691000, 768000, 845000, 922000, 998000, 1075000, 1152000, 1229000, 1382000, 1536000, 1690000, 1843000, 1997000, 4M, 10M, and 16M.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINDDI.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINDDI.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="#CRTLINDDI.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINDDI.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>0</b></dt>
<dd>The cost per byte is 0.
</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="#CRTLINDDI.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINDDI.SECURITY"></a>
<h3>Security for line (SECURITY)</h3>
<p>Specifies the security level of the physical line.
</p>
<dl>
<dt><b>*NONSECURE</b></dt>
<dd>Normal priority is used.
</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>*UNDGRDCBL</b></dt>
<dd>An underground cable is used.
</dd>
<dt><b>*SECURECND</b></dt>
<dd>A secure, unguarded conduit (for example, a pressurized pipe) is used.
</dd>
<dt><b>*GUARDCND</b></dt>
<dd>A guarded conduit, which is protected against physical tapping, is used.
</dd>
<dt><b>*ENCRYPTED</b></dt>
<dd>Data flowing on the line is encrypted.
</dd>
<dt><b>*MAX</b></dt>
<dd>A guarded conduit, protected against physical and radiation tapping, is used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINDDI.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINDDI.PRPDLY"></a>
<h3>Propagation delay (PRPDLY)</h3>
<p>Specifies the level of propagation delay on the line. This parameter is valid only if 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>The local area network propagation delay is used.
</dd>
<dt><b>*PKTSWTNET</b></dt>
<dd>The packet switched network propagation delay is used.
</dd>
<dt><b>*MIN</b></dt>
<dd>The minimum propagation delay is used.
</dd>
<dt><b>*TELEPHONE</b></dt>
<dd>The telephone propagation delay is used.
</dd>
<dt><b>*SATELLITE</b></dt>
<dd>The satellite propagation delay is used.
</dd>
<dt><b>*MAX</b></dt>
<dd>The maximum propagation delay is used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINDDI.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINDDI.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>
<dl>
<dt><b>128</b></dt>
<dd>A value 128 is used.
</dd>
<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="#CRTLINDDI.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINDDI.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>
<dl>
<dt><b>128</b></dt>
<dd>A value 128 is used.
</dd>
<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="#CRTLINDDI.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINDDI.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>
<dl>
<dt><b>128</b></dt>
<dd>A value 128 is used.
</dd>
<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="#CRTLINDDI.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINDDI.AUTOCRTCTL"></a>
<h3>Autocreate controller (AUTOCRTCTL)</h3>
<p>Specifies whether the system automatically creates controller descriptions when calls are received from adjacent systems on the local area network (LAN).
</p>
<dl>
<dt><b>*NO</b></dt>
<dd>The system does not automatically create a controller description when incoming calls are received.
</dd>
<dt><b>*YES</b></dt>
<dd>The system automatically creates a controller description when incoming calls are received.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINDDI.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINDDI.AUTODLTCTL"></a>
<h3>Autodelete controller (AUTODLTCTL)</h3>
<p>Specifies the number of minutes an automatically created controller can remain in an idle state (switched from varied on to varied on pending) before the controller description and attached device descriptions are varied off and deleted.
</p>
<dl>
<dt><b>1440</b></dt>
<dd>The controller description can be idle for 1440 minutes (24 hours).
</dd>
<dt><b>*NONE</b></dt>
<dd>The system does not automatically delete or vary off the automatically configured, idle controller descriptions.
</dd>
<dt><b><i>wait-time</i></b></dt>
<dd>Specify the number of minutes to wait before deleting the automatically configured, idle controller descriptions for this line. Valid values range from 1 to 10,000 minutes.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINDDI.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINDDI.CMNRCYLMT"></a>
<h3>Recovery limits (CMNRCYLMT)</h3>
<p>Specifies the number of recovery attempts made by the system before an inquiry message is sent to the system operator. Also specifies the time (in minutes) that must elapse before the system sends an inquiry message to the system operator indicating that the recovery attempt count limit is reached.
</p>
<p>The possible <b>Maximum Recovery Limit</b> values are:
</p>
<dl>
<dt><b>2</b></dt>
<dd>Two recovery attempts are made within the interval specified.
</dd>
<dt><b><i>count-limit</i></b></dt>
<dd>Specify the number of recovery attempts to be made. Valid values range from 0 through 99.
</dd>
</dl>
<p>The possible <b>Recovery Time Interval</b> values are:
</p>
<dl>
<dt><b>5</b></dt>
<dd>A 15-second timeout period is used.
</dd>
<dt><b><i>time-interval</i></b></dt>
<dd>Specify the time interval (in minutes) at which the specified number of second-level recoveries are attempted. Valid values range from 0 through 120. If the value specified for <i>count-limit</i> is not 0, the value 0 specifies infinite recovery.
</dd>
<dt><b>*SYSVAL</b></dt>
<dd>The recovery limits specified in the QCMNRCYLMT system value are used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINDDI.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINDDI.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="#CRTLINDDI.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINDDI.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="#CRTLINDDI.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CRTLINDDI.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
CRTLINDDI LIND(DDILAN1) RSRCNAME(LIN011)
TEXT('Fiber Distributed Data Interface (FDDI) Line')
</pre>
</p>
<p>This command creates a DDI line description named DDILAN1 for an FDDI line installed on adapter LIN011 on the system.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINDDI.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CRTLINDDI.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="#CRTLINDDI.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>