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

375 lines
13 KiB
HTML
Raw Permalink 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>Add Wireless Line Member (ADDEWLM)</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="ADDEWLM.Top_Of_Page"></a>
<h2>Add Wireless Line Member (ADDEWLM)</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="#ADDEWLM.PARAMETERS.TABLE">Parameters</a><br>
<a href="#ADDEWLM.COMMAND.EXAMPLES">Examples</a><br>
<a href="#ADDEWLM.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="ADDEWLM"></a>
<p>The Add Extended Wireless Line Member (ADDEWLM) command adds a source file member that contains extended wireless line parameters to the specified source file. This data is downloaded to the wireless local area network (LAN) adapter when the line is varied on.
</p>
<p><b>Restriction:</b> If the values specified for the INZFILE and INZMBR parameters of this command do not match the values specified for the corresponding parameters of the wireless line description, extended wireless line configuration data will not be downloaded to the wireless adapter.
</p>
<p><b>Restriction:</b> To execute this command, the user profile requires *IOSYSCFG special authority.
</p>
<p>
<b>Note: </b>You can use the Change Line Description (Wireless) (CHGLINWLS) command to view or change values specified for the INZFILE and INZMBR parameters in the wireless line description.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDEWLM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="ADDEWLM.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="#ADDEWLM.INZMBR"><b>INZMBR</b></a></td>
<td valign="top">Initialization source member</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#ADDEWLM.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, Positional 2</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Initialization source file</td>
<td valign="top"><i>Name</i>, <b><u>QEWLSRC</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="#ADDEWLM.ADPTCFG"><b>ADPTCFG</b></a></td>
<td valign="top">Adapter configuration</td>
<td valign="top"><b><u>*ALL</u></b>, *RADIO, *WIRED</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDEWLM.HOPID"><b>HOPID</b></a></td>
<td valign="top">Hop identifier</td>
<td valign="top">020000000000-FEFFFFFFFFFF, <b><u>*ADPT</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDEWLM.ROOT"><b>ROOT</b></a></td>
<td valign="top">Root cell</td>
<td valign="top"><b><u>*YES</u></b>, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDEWLM.FREQUENCY"><b>FREQUENCY</b></a></td>
<td valign="top">Frequency</td>
<td valign="top"><b><u>1</u></b>, 2, 3, 4, 5</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDEWLM.DATARATE"><b>DATARATE</b></a></td>
<td valign="top">Data rate</td>
<td valign="top"><b><u>2M</u></b>, 1M</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDEWLM.SYSID"><b>SYSID</b></a></td>
<td valign="top">Radio system identifier</td>
<td valign="top">000002-FFFFFE, <b><u>000002</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDEWLM.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>
</table>
<table width="100%">
<tr><td align="right"><a href="#ADDEWLM.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="ADDEWLM.INZMBR"></a>
<h3>Initialization source member (INZMBR)</h3>
<p>Specifies the name of the new source file member that contains the extended wireless controller configuration data.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDEWLM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDEWLM.INZFILE"></a>
<h3>Initialization source file (INZFILE)</h3>
<p>Specifies the name of the existing source physical file to contain extended configuration source file member. If the source physical file does not exist, this command will fail.
</p>
<p>The name of the source file can be qualified by one of the following library values:
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>All libraries in the job's library list are searched until the first match is found.
</dd>
<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>library-name</i></b></dt>
<dd>Specify the name of the library to be searched.
</dd>
</dl>
<p>The possible values are:
</p>
<dl>
<dt><b><u>QEWLSRC</u></b></dt>
<dd>The source file name QEWLSRC is used.
</dd>
<dt><b><i>source-file-name</i></b></dt>
<dd>Specify the name of an existing source physical file to add to the member.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDEWLM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDEWLM.ADPTCFG"></a>
<h3>Adapter configuration (ADPTCFG)</h3>
<p>Specifies the wireless LAN adapter configuration. The wireless LAN adapter has two communication methods: radio and wire backbone. The radio is a direct-sequence spread spectrum radio that can be used for wireless communications. The wire backbone is used to connect access points to a wireless LAN adapter. These access points also have a direct-sequence spread spectrum radio and are used to extend the radio coverage of the wireless network.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>The wireless LAN adapter uses both radio and wire backbone communications.
</dd>
<dt><b>*RADIO</b></dt>
<dd>The wireless LAN adapter uses only radio communications.
</dd>
<dt><b>*WIRED</b></dt>
<dd>The wireless LAN adapter uses only wire backbone communications.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDEWLM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDEWLM.HOPID"></a>
<h3>Hop identifier (HOPID)</h3>
<p>Specifies the 12-character hexadecimal radio identifier on the wireless LAN adapter. This is an internal identifier that is used to determine the destination of a data packet, during its next hop on the network.
</p>
<p>
<b>Note: </b>The value specified for the HOPID parameter is one of two different 12-character hexadecimal identifiers used by a wireless LAN adapter. The other is an endpoint identifier that is equivalent to the identifier used in Ethernet or token-ring networks.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*ADPT</u></b></dt>
<dd>The preset wireless input/output adapter (IOA) address is used.
</dd>
<dt><b><i>hop-ID</i></b></dt>
<dd>Specify the wireless LAN adapter hop address that overrides the preset address. The hop address must be an individual address (it cannot be a group address). Valid values range from 020000000000 to FEFFFFFFFFFF in hexadecimal format. The second digit from the left of the address must be a 2, 6, A, or E.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDEWLM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDEWLM.ROOT"></a>
<h3>Root cell (ROOT)</h3>
<p>Specifies whether the radio of the wireless LAN adapter is a root cell.
</p>
<p>A wireless network consists of a group of wireless access points that are interconnected in the form of a logical spanning tree. One of these wireless access points must be designated as the root cell for the network.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*YES</u></b></dt>
<dd>The radio on the wireless LAN adapter is a root cell.
</dd>
<dt><b>*NO</b></dt>
<dd>The radio on the wireless LAN adapter is not a root cell.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDEWLM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDEWLM.FREQUENCY"></a>
<h3>Frequency (FREQUENCY)</h3>
<p>Specifies which center frequency to use on the radio based on the radio channel set. The radio channel set is determined by the radio country code.
</p>
<p>The possible Frequency values are:
</p>
<p>For channel set 9, there are five center frequencies.
</p>
<dl>
<dt><b><u>1</u></b></dt>
<dd>A center frequency of 2.412 gigahertz is used.
</dd>
<dt><b>2</b></dt>
<dd>A center frequency of 2.427 gigahertz is used.
</dd>
<dt><b>3</b></dt>
<dd>A center frequency of 2.442 gigahertz is used.
</dd>
<dt><b>4</b></dt>
<dd>A center frequency of 2.457 gigahertz is used.
</dd>
<dt><b>5</b></dt>
<dd>A center frequency of 2.465 gigahertz is used.
</dd>
</dl>
<p>For channel set 10, there are five center frequencies. Channel set 10 is used in ETSI (European Telecommunication and Standards Institute) countries.
</p>
<dl>
<dt><b><u>1</u></b></dt>
<dd>A center frequency of 2.412 gigahertz is used.
</dd>
<dt><b>2</b></dt>
<dd>A center frequency of 2.427 gigahertz is used.
</dd>
<dt><b>3</b></dt>
<dd>A center frequency of 2.442 gigahertz is used.
</dd>
<dt><b>4</b></dt>
<dd>A center frequency of 2.457 gigahertz is used.
</dd>
<dt><b>5</b></dt>
<dd>A center frequency of 2.472 gigahertz is used.
</dd>
</dl>
<p>For channel set 11, there is one center frequency.
</p>
<dl>
<dt><b><u>1</u></b></dt>
<dd>A center frequency of 2.484 gigahertz is used.
</dd>
</dl>
<p>For channel set 12, there are three center frequencies.
</p>
<dl>
<dt><b><u>1</u></b></dt>
<dd>A center frequency of 2.457 gigahertz is used.
</dd>
<dt><b><u>2</u></b></dt>
<dd>A center frequency of 2.465 gigahertz is used.
</dd>
<dt><b><u>3</u></b></dt>
<dd>A center frequency of 2.472 gigahertz is used.
</dd>
</dl>
<p>For channel set 13, there are three center frequencies.
</p>
<dl>
<dt><b><u>1</u></b></dt>
<dd>A center frequency of 2.411 gigahertz is used.
</dd>
<dt><b><u>2</u></b></dt>
<dd>A center frequency of 2.425 gigahertz is used.
</dd>
<dt><b><u>3</u></b></dt>
<dd>A center frequency of 2.439 gigahertz is used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDEWLM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDEWLM.DATARATE"></a>
<h3>Data rate (DATARATE)</h3>
<p>Specifies the wireless LAN data rate.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>2M</u></b></dt>
<dd>A wireless LAN data rate of 2 megabits per second is used.
</dd>
<dt><b>1M</b></dt>
<dd>A wireless LAN data rate of 1 megabit per second is used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDEWLM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDEWLM.SYSID"></a>
<h3>Radio system identifier (SYSID)</h3>
<p>Specifies the 6-character hexadecimal radio system identifier to be used.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>000002</u></b></dt>
<dd>The value 000002 is used.
</dd>
<dt><b><i>sys-ID</i></b></dt>
<dd>Specify a radio system identifier. Valid values range from 000002 to FFFFFE in hexadecimal format, but the last digit must be even (i.e. 0,2,4,6,8,A,C,E).
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDEWLM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDEWLM.TEXT"></a>
<h3>Text 'description' (TEXT)</h3>
<p>Specifies text that briefly describes the program and its function. More information on this parameter is in the CL Reference book, Appendix A.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*BLANK</u></b></dt>
<dd>Text is not specified.
</dd>
<dt><b><i>'description'</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="#ADDEWLM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="ADDEWLM.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
ADDEWLM INZMBR(EWL01)
</pre>
</p>
<p>This command adds a member named EWL01 in the default source physical file QEWLSRC in the library list.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDEWLM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="ADDEWLM.ERROR.MESSAGES">Error messages</a> </h3>
<p>None
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDEWLM.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>