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

355 lines
13 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>Change Wireless Ctl Member (CHGEWCM)</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="CHGEWCM.Top_Of_Page"></a>
<h2>Change Wireless Ctl Member (CHGEWCM)</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="#CHGEWCM.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGEWCM.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGEWCM.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGEWCM"></a>
<p>The Change Extended Wireless Controller Member (CHGEWCM) command changes the extended wireless controller parameters in the specified source file member. Specific Portable Transaction Computer (PTC) and bar code configurations in this member are changed using the Change Extended Wireless Controller PTC Entry (CHGEWCPTCE) and Change Extended Wireless Controller Bar Code Entry (CHGEWCBCDE) 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="#CHGEWCM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGEWCM.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="#CHGEWCM.INZMBR"><b>INZMBR</b></a></td>
<td valign="top">Initialization source member</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Required, Key, Positional 1</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CHGEWCM.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, Key, 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="#CHGEWCM.TXPADR"><b>TXPADR</b></a></td>
<td valign="top">Destination ID</td>
<td valign="top">4001-4FFE, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGEWCM.TXPPORT"><b>TXPPORT</b></a></td>
<td valign="top">Transport port</td>
<td valign="top">0-15, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGEWCM.TEXT"><b>TEXT</b></a></td>
<td valign="top">Text 'description'</td>
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGEWCM.KBDMAPMBR"><b>KBDMAPMBR</b></a></td>
<td valign="top">Keyboard remap source member</td>
<td valign="top"><i>Name</i>, <b><u>*SAME</u></b>, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGEWCM.SCNFMTMBR"><b>SCNFMTMBR</b></a></td>
<td valign="top">Screen reformat rules member</td>
<td valign="top"><i>Name</i>, <b><u>*SAME</u></b>, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CHGEWCM.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>*SAME</u></b>, QEWCKBDMAP</td>
</tr><tr>
<td valign="top">Qualifier 2: Library</td>
<td valign="top"><i>Name</i>, <b><u>*SAME</u></b>, QGPL</td>
</tr><tr>
<td valign="top" rowspan="3"><a href="#CHGEWCM.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>*SAME</u></b>, QEWCSCNFMT</td>
</tr><tr>
<td valign="top">Qualifier 2: Library</td>
<td valign="top"><i>Name</i>, <b><u>*SAME</u></b>, QGPL</td>
</tr></table>
<table width="100%">
<tr><td align="right"><a href="#CHGEWCM.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGEWCM.INZMBR"></a>
<h3>Initialization source member (INZMBR)</h3>
<p>Specifies the name of the source file member to be changed. This member contains wireless controller configuration data.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGEWCM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGEWCM.INZFILE"></a>
<h3>Initialization source file (INZFILE)</h3>
<p>Specifies the name of the source physical file of the source file member to be changed. 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 the source physical file of the source member to change.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGEWCM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGEWCM.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><u>*SAME</u></b></dt>
<dd>The value stays the same.
</dd>
<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="#CHGEWCM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGEWCM.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>*SAME</u></b></dt>
<dd>The value stays the same.
</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="#CHGEWCM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGEWCM.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>*SAME</u></b></dt>
<dd>The text stays the same.
</dd>
<dt><b>*BLANK</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="#CHGEWCM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGEWCM.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>*SAME</u></b></dt>
<dd>The file member stays the same.
</dd>
<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="#CHGEWCM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGEWCM.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>*SAME</u></b></dt>
<dd>The file member stays the same.
</dd>
<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="#CHGEWCM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGEWCM.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="#CHGEWCM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGEWCM.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="#CHGEWCM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGEWCM.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
CHGEWCM INZMBR(EWC01) INZFILE(MYLIB/QEWCSRC) TXPPORT(2)
</pre>
</p>
<p>This command changes the extended wireless controller member EWC01 in the source physical file QEWCSRC in library MYLIB. The transport port connection number is changed to 2.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGEWCM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGEWCM.ERROR.MESSAGES">Error messages</a> </h3>
<p>None
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGEWCM.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>