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

870 lines
34 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 (Wireless) (CRTLINWLS)</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="CRTLINWLS.Top_Of_Page"></a>
<h2>Create Line Desc (Wireless) (CRTLINWLS)</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="#CRTLINWLS.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CRTLINWLS.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CRTLINWLS.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CRTLINWLS"></a>
<p>The Create Line Description (Wireless) (CRTLINWLS) command creates a line description for a wireless local area network (LAN) line.
</p>
<p>
<b>Note: </b>Extended wireless line configuration data is contained in the source file and member specified on the INZFILE and INZMBR parameters, respectively. When the line is varied on, this configuration data is downloaded to the wireless adapter. It is recommended that INZPGM(QZXCINZ) and INZFILE(QEWLSRC) be used, and that the source member configuration initialization data be specified on the INZMBR parameter. For more information about downloading extended wireless line configuration data, see the LAN, Frame-Relay and ATM Support book, SC41-5404.
</p>
<p>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="#CRTLINWLS.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CRTLINWLS.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="#CRTLINWLS.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="#CRTLINWLS.RSRCNAME"><b>RSRCNAME</b></a></td>
<td valign="top">Resource name</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Required, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINWLS.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="#CRTLINWLS.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="#CRTLINWLS.ADPTADR"><b>ADPTADR</b></a></td>
<td valign="top">Local adapter address</td>
<td valign="top">020000000000-FEFFFFFFFFFF, <b><u>*ADPT</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINWLS.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="#CRTLINWLS.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" rowspan="4"><a href="#CRTLINWLS.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-1496, <b><u>*MAXFRAME</u></b>, 265, 521, 1033, 1466, 1493, 1496</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" rowspan="3"><a href="#CRTLINWLS.INZFILE"><b>INZFILE</b></a></td>
<td valign="top">Initialization source file</td>
<td valign="top"><i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Initialization source file</td>
<td valign="top"><i>Name</i>, <b><u>*NONE</u></b></td>
</tr><tr>
<td valign="top">Qualifier 2: Library</td>
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
</tr><tr>
<td valign="top"><a href="#CRTLINWLS.INZMBR"><b>INZMBR</b></a></td>
<td valign="top">Initialization source member</td>
<td valign="top"><i>Name</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CRTLINWLS.INZPGM"><b>INZPGM</b></a></td>
<td valign="top">Initialization program</td>
<td valign="top"><i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Initialization program</td>
<td valign="top"><i>Name</i>, <b><u>*NONE</u></b></td>
</tr><tr>
<td valign="top">Qualifier 2: Library</td>
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
</tr><tr>
<td valign="top"><a href="#CRTLINWLS.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="#CRTLINWLS.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="#CRTLINWLS.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="#CRTLINWLS.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="#CRTLINWLS.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, <b><u>280000</u></b>, 320000, 336000, 384000, 448000, 499000, 576000, 614000, 691000, 768000, 845000, 922000, 998000, 1075000, 1152000, 1229000, 1382000, 1536000, 1690000, 1843000, 1997000, 4M, *MAX</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINWLS.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="#CRTLINWLS.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="#CRTLINWLS.SECURITY"><b>SECURITY</b></a></td>
<td valign="top">Security for line</td>
<td valign="top"><b><u>*NONSECURE</u></b>, *ENCRYPTED</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINWLS.PRPDLY"><b>PRPDLY</b></a></td>
<td valign="top">Propagation delay</td>
<td valign="top"><b><u>*LAN</u></b>, *MIN, *MAX</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINWLS.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="#CRTLINWLS.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="#CRTLINWLS.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="#CRTLINWLS.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="#CRTLINWLS.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="#CRTLINWLS.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"><a href="#CRTLINWLS.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="#CRTLINWLS.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CRTLINWLS.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="#CRTLINWLS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINWLS.RSRCNAME"></a>
<h3>Resource name (RSRCNAME)</h3>
<p>Specifies the resource name that describes the automatic call unit port. The resource name consists of the input/output adapter (IOA) resource name and the port number on the IOA. For example, if the resource name of the IOA is LIN01 and the port on the IOA is 1, then the resource name would be LIN011.
</p>
<p>
<b>Note: </b>You can use the Work with Hardware Resources (WRKHDWRSC) command with *CMN specified for the TYPE parameter to help determine the resource name.
</p>
<p>This is a required parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINWLS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINWLS.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="#CRTLINWLS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINWLS.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="#CRTLINWLS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINWLS.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 wireless adapter address is used as the local adapter address. The adapter address can be displayed by using the Display Line Description (DSPLIND) command after the line description has been successfully varied on.
</dd>
<dt><b><i>local-adapter-address</i></b></dt>
<dd>Specify the local wireless adapter address to override the preset local address. The local adapter address must be an individual address (it cannot be a group address). Valid values range from 020000000000 through FEFFFFFFFFFF in hexadecimal format. The second digit (from the left) of the address must be 2, 6, A, or E.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINWLS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINWLS.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="#CRTLINWLS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINWLS.ETHSTD"></a>
<h3>Ethernet standard (ETHSTD)</h3>
<p>Specifies the Ethernet standard frame type that is used on this line.
</p>
<dl>
<dt><b>*ALL</b></dt>
<dd>All Ethernet standards can be used. However, Systems Network Architecture (SNA) data will be placed in IEEE 802.3 frames.
</dd>
<dt><b>*ETHV2</b></dt>
<dd>Ethernet Version 2 frames are used for all data.
</dd>
<dt><b>*IEEE8023</b></dt>
<dd>IEEE 802.3 frames are used for all data.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINWLS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINWLS.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 Ethernet bus to the proper user. A maximum frame size can be specified for each SSAP.
</p>
<p>
<b>Note: </b>Ethernet Version 2 (specified as *ETHV2 on the ETHSTD parameter) does not allow the SSAP values of 06 and AA.
</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>For ETHSTD(*ALL or *IEEE8023), the operating system creates three SSAPs: SSAP 04 for SNA applications; AA and 06 for TCP/IP applications. For ETHSTD(*ETHV2), the system creates hex 04 for SNA.
</dd>
</dl>
<p>The possible SSAPs value is:
</p>
<dl>
<dt><b><i>source-service-access-point</i></b></dt>
<dd>Specify up to 24 SSAPs, including hex AA and 06 for TCP/IP, and any hexadecimal number 04 through 9C that is divisible by four for SNA applications.
</dd>
</dl>
<p>The possible Frame Size for SSAPs 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) is specified, *CALC produces a frame size of 1496 for TCP/IP and SNA SSAPs. If ETHSTD(*ETHV2) is specified, *CALC produces a frame size of 1493 for SNA SSAPs.
</dd>
<dt><b><i>SSAP-maximum-frame</i></b></dt>
<dd>Specify the maximum frame size for each SSAP. Valid values for the maximum frame size range from 265 through 1496.
</dd>
</dl>
<p>The possible SSAP Type values are:
</p>
<dl>
<dt><b>*CALC</b></dt>
<dd>The system determines the value to use.
</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 communications other than 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="#CRTLINWLS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINWLS.INZFILE"></a>
<h3>Initialization source file (INZFILE)</h3>
<p>Specifies the name of a source file containing configuration initialization data.
</p>
<p>
<b>Note: </b>The INZFILE and INZMBR parameters are required when downloading extended wireless line configuration data to the wireless adapter as discussed at the beginning of this command description.
</p>
<dl>
<dt><b>*NONE</b></dt>
<dd>No initialization file name is specified.
</dd>
</dl>
<p>The name of the initialization file can be qualified by one of the following library values:
</p>
<dl>
<dt><b>*LIBL</b></dt>
<dd>All libraries in the job's library list are searched until the first match is found.
</dd>
</dl>
<dl>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the library to be searched.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of a source file containing the initialization data. A value of *NONE is accepted for this parameter. If a source file name has not been added prior to varying on this line description, then the current IOP defaults are used for initialization.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINWLS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINWLS.INZMBR"></a>
<h3>Initialization source member (INZMBR)</h3>
<p>Specifies the name of a source file member containing configuration initialization data.
</p>
<p>
<b>Note: </b>The INZFILE and INZMBR parameters are required when downloading extended wireless line configuration data to the wireless adapter as discussed at the beginning of this command description.
</p>
<dl>
<dt><b>*NONE</b></dt>
<dd>No source file member name is specified.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of a source file member containing the initialization data. If a source member name has not been added prior to varying on this line description, the the current IOP defaults are used for initialization.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINWLS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINWLS.INZPGM"></a>
<h3>Initialization program (INZPGM)</h3>
<p>Specifies the name of a program to manage configuration initialization data.
</p>
<p>
<b>Note: </b>For 2663 wireless adapters, it is recommended that INZPGM(QZXCINZ) be specified. This results in the values of INZFILE and INZMBR being passed to the Change Extended Wireless Line Member (CHGEWLM) command when the line is varied on.
</p>
<dl>
<dt><b>*NONE</b></dt>
<dd>No initialization program name is specified.
</dd>
</dl>
<p>The name of the initialization program can be qualified by one of the following library values:
</p>
<dl>
<dt><b>*LIBL</b></dt>
<dd>All libraries in the job's library list are searched until the first match is found.
</dd>
</dl>
<dl>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the library to be searched.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of a program to manage configuration initialization data. If a program name is specified, it is called when this line description is created. The names of the source file and member containing configuration initialization data are passed to this program as parameters.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINWLS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINWLS.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="#CRTLINWLS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINWLS.NETCTL"></a>
<h3>Network controller (NETCTL)</h3>
<p>Specifies the name of an existing network controller. This parameter can be specified for lines attached to a Transmission Control Protocol/Internet Protocol (TCP/IP) network.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINWLS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINWLS.GRPADR"></a>
<h3>Group address (GRPADR)</h3>
<p>Specifies whether to include the adapter as part of a wireless group address. This address is used to identify all adapters on the wireless network that have the same group address.
</p>
<dl>
<dt><b>*NONE</b></dt>
<dd>A group address is not used.
</dd>
<dt><b><i>group-address</i></b></dt>
<dd>Specify the address of the group of adapters to which the local adapter is added. Valid values range from 010000000000 through FDFFFFFFFFFF in hexadecimal format. The second digit (from the left) must be odd. All group addresses must be unique.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINWLS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINWLS.MAXCTL"></a>
<h3>Maximum controllers (MAXCTL)</h3>
<p>Specifies the maximum number of SNA controllers that the line supports.
</p>
<dl>
<dt><b>40</b></dt>
<dd>Up to 40 controllers are supported by the line.
</dd>
<dt><b><i>maximum-controllers</i></b></dt>
<dd>Specify the maximum number of controllers supported by the line. This should be a number large enough to account for all of the controllers that are currently attached to this line, and for those controllers to 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="#CRTLINWLS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINWLS.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>280000</b></dt>
<dd>A link speed of 280000 bps is used.
</dd>
</dl>
<dl>
<dt><b>4M</b></dt>
<dd>A link speed of 4 million bps is used.
</dd>
<dt><b>*MIN</b></dt>
<dd>A link speed of less than 4M is used.
</dd>
<dt><b>*MAX</b></dt>
<dd>A link speed greater than 4M is used.
</dd>
<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, and 4M.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINWLS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINWLS.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="#CRTLINWLS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINWLS.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>
<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="#CRTLINWLS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINWLS.SECURITY"></a>
<h3>Security for line (SECURITY)</h3>
<p>Specifies the security level of the line.
</p>
<dl>
<dt><b>*NONSECURE</b></dt>
<dd>Normal priority is used.
</dd>
<dt><b>*ENCRYPTED</b></dt>
<dd>Data flowing on the line is encrypted.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINWLS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINWLS.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.
</p>
<dl>
<dt><b>*LAN</b></dt>
<dd>The local area network propagation delay is used.
</dd>
<dt><b>*MIN</b></dt>
<dd>The minimum 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="#CRTLINWLS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINWLS.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>128</b></dt>
<dd>The value 128 is used.
</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="#CRTLINWLS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINWLS.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>128</b></dt>
<dd>The value 128 is used.
</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="#CRTLINWLS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINWLS.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>128</b></dt>
<dd>The value 128 is used.
</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="#CRTLINWLS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINWLS.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="#CRTLINWLS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINWLS.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>
</dl>
<dl>
<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 10000 minutes.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINWLS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINWLS.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 Maximum Recovery Limit values are:
</p>
<dl>
<dt><b>2</b></dt>
<dd>Two recovery attempts are made within the interval specified.
</dd>
</dl>
<dl>
<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 Recovery Time Interval values are:
</p>
<dl>
<dt><b>5</b></dt>
<dd>The specified number of recovery attempts is made within a 5-minute interval.
</dd>
</dl>
<dl>
<dt><b><i>time-interval</i></b></dt>
<dd>Specify the time interval (in minutes) at which the specified number of second-level recoveries are attempted. Valid values range from 0 through 120. If the value specified for <i>count-limit</i> is not 0, the value 0 specifies infinite recovery.
</dd>
</dl>
<p>The possible Single Value values are:
</p>
<dl>
<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="#CRTLINWLS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINWLS.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="#CRTLINWLS.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CRTLINWLS.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
CRTLINWLS LIND(MYLINE) RSRCNAME(LIN041)
INZFILE(*NONE) INZMBR(*NONE)
</pre>
</p>
<p>This command creates a wireless line description named MYLINE with a resource name of LIN041. The source file name and member name for configuration initialization data are left unspecified, and can be changed later.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINWLS.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CRTLINWLS.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 created due to errors.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINWLS.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>