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

343 lines
12 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>Add Wireless Ctl Member (ADDEWCM)</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="ADDEWCM.Top_Of_Page"></a>
<h2>Add Wireless Ctl Member (ADDEWCM)</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="#ADDEWCM.PARAMETERS.TABLE">Parameters</a><br>
<a href="#ADDEWCM.COMMAND.EXAMPLES">Examples</a><br>
<a href="#ADDEWCM.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="ADDEWCM"></a>
<p>The Add Extended Wireless Controller Member (ADDEWCM) command adds a source file member with extended wireless controller parameters to the specified source file. This data is downloaded to the wireless controller when the controller is varied on. Specific Portable Transaction Computer (PTC) and bar code configurations are added to this member using the Add Extended Wireless Controller PTC Entry (ADDEWCPTCE) and Add Extended Wireless Controller Bar Code Entry (ADDEWCBCDE) commands.
</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 controller description, extended wireless controller 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 Controller Description (Local Work Station) (CHGCTLLWS) command to view or change values specified for the INZFILE and INZMBR parameters in the wireless controller description.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDEWCM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="ADDEWCM.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="#ADDEWCM.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="#ADDEWCM.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>QEWCSRC</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="#ADDEWCM.TXPADR"><b>TXPADR</b></a></td>
<td valign="top">Destination ID</td>
<td valign="top">4001-4FFE, <b><u>4001</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDEWCM.TXPPORT"><b>TXPPORT</b></a></td>
<td valign="top">Transport port</td>
<td valign="top">0-15, <b><u>0</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDEWCM.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="#ADDEWCM.KBDMAPMBR"><b>KBDMAPMBR</b></a></td>
<td valign="top">Keyboard remap 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"><a href="#ADDEWCM.SCNFMTMBR"><b>SCNFMTMBR</b></a></td>
<td valign="top">Screen reformat rules 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="#ADDEWCM.KBDMAPFILE"><b>KBDMAPFILE</b></a></td>
<td valign="top">Keyboard remapping 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: Keyboard remapping source file</td>
<td valign="top"><i>Name</i>, <b><u>QEWCKBDMAP</u></b></td>
</tr><tr>
<td valign="top">Qualifier 2: Library</td>
<td valign="top"><i>Name</i>, <b><u>QGPL</u></b></td>
</tr><tr>
<td valign="top" rowspan="3"><a href="#ADDEWCM.SCNFMTFILE"><b>SCNFMTFILE</b></a></td>
<td valign="top">Screen reformatting rules 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: Screen reformatting rules file</td>
<td valign="top"><i>Name</i>, <b><u>QEWCSCNFMT</u></b></td>
</tr><tr>
<td valign="top">Qualifier 2: Library</td>
<td valign="top"><i>Name</i>, <b><u>QGPL</u></b></td>
</tr></table>
<table width="100%">
<tr><td align="right"><a href="#ADDEWCM.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="ADDEWCM.INZMBR"></a>
<h3>Initialization source member (INZMBR)</h3>
<p>Specifies the name of the source file member containing the extended wireless controller configuration data that is added to the source file.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDEWCM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDEWCM.INZFILE"></a>
<h3>Initialization source file (INZFILE)</h3>
<p>Specifies the name of a 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>QEWCSRC</u></b></dt>
<dd>The source file name QEWCSRC is used.
</dd>
<dt><b><i>source-file-name</i></b></dt>
<dd>Specify the name of an existing source physical file to which the member is added.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDEWCM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDEWCM.TXPADR"></a>
<h3>Destination ID (TXPADR)</h3>
<p>Specifies the local destination ID (transport address) that the PTC attempts to connect to at emulation startup time. This is a 4-byte hexadecimal number with valid values ranging from 4001 through 4FFE. The destination ID must match the destination ID used in the PTC(s).
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><i>destination ID (transport-address)</i></b></dt>
<dd>Specify the local destination ID (transport address).
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDEWCM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDEWCM.TXPPORT"></a>
<h3>Transport port (TXPPORT)</h3>
<p>Specifies the local transport port connection number of the controller. The valid range is from 0 through 15. The value used by the PTC(s) is 0.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>0</u></b></dt>
<dd>The value 0 is used.
</dd>
<dt><b><i>transport-port</i></b></dt>
<dd>Specify the local transport port connection number.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDEWCM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDEWCM.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="#ADDEWCM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDEWCM.KBDMAPMBR"></a>
<h3>Keyboard remap source member (KBDMAPMBR)</h3>
<p>Specifies the source physical file member that contains the Keyboard Map information.
</p>
<p>NOTE: The Keyboard Mapping function is not supported on the 2668 Feature Number.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>Keyboard Mapping file member is not used.
</dd>
<dt><b><i>source-file-member</i></b></dt>
<dd>The name of the file member that specifies the Keyboard Map information.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDEWCM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDEWCM.SCNFMTMBR"></a>
<h3>Screen reformat rules member (SCNFMTMBR)</h3>
<p>Specifies the source physical file member that contains the Screen Reformatter information
</p>
<p>NOTE: The Screen Reformatter function is not supported on the 2668 Feature Number.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>Screen Reformatter file member is not used.
</dd>
<dt><b><i>source-file-member</i></b></dt>
<dd>The name of the file member that specifies the Screen Reformatter information
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDEWCM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDEWCM.KBDMAPFILE"></a>
<h3>Keyboard remapping source file (KBDMAPFILE)</h3>
<p>Specifies the name of a source physical file to contain Keyboard Map 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>QEWCKBDMAP</u></b></dt>
<dd>The source file name QEWCKBDMAP is used.
</dd>
<dt><b><i>source-file-name</i></b></dt>
<dd>Specify the name of an existing source physical file to which the member is added.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDEWCM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDEWCM.SCNFMTFILE"></a>
<h3>Screen reformatting rules file (SCNFMTFILE)</h3>
<p>Specifies the name of a source physical file to contain Screen Reformatter 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>QEWCSCNFMT</u></b></dt>
<dd>The source file name QEWCSCNFMT is used.
</dd>
<dt><b><i>source-file-name</i></b></dt>
<dd>Specify the name of an existing source physical file to which the member is added.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDEWCM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="ADDEWCM.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
ADDEWCM INZMBR(EWC01) INZFILE(*LIBL/QEWCSRC)
</pre>
</p>
<p>This command adds a member named EWC01 in the default source physical file QEWCSRC in the library list with the default TXPADR of 4001 and default TXPPORT of 0.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDEWCM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="ADDEWCM.ERROR.MESSAGES">Error messages</a> </h3>
<p>None
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDEWCM.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>