471 lines
15 KiB
HTML
471 lines
15 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 Ctl Desc (Local WS) (CHGCTLLWS)</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="CHGCTLLWS.Top_Of_Page"></a>
|
|
<h2>Change Ctl Desc (Local WS) (CHGCTLLWS)</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="#CHGCTLLWS.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CHGCTLLWS.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CHGCTLLWS.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CHGCTLLWS"></a>
|
|
<p>The Change Controller Description (Local Work Station) (CHGCTLLWS) command changes a controller description for a local work station controller.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>Extended wireless controller configuration data is contained in the source file and member specified by the INZFILE and INZMBR parameters, respectively. When the controller is varied on, this configuration data is downloaded to the wireless adapter. It is recommended that INZPGM(QZXCINZ) and INZFILE(QEWCSRC) be used, and that a valid value be specified for the INZMBR parameter. For more information about downloading extended wireless controller configuration data, see the LAN, Frame-Relay and ATM Support book, SC41-5404 book.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCTLLWS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CHGCTLLWS.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="#CHGCTLLWS.CTLD"><b>CTLD</b></a></td>
|
|
<td valign="top">Controller description</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
<td valign="top">Required, Key, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGCTLLWS.RSRCNAME"><b>RSRCNAME</b></a></td>
|
|
<td valign="top">Resource name</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*SAME</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGCTLLWS.ONLINE"><b>ONLINE</b></a></td>
|
|
<td valign="top">Online at IPL</td>
|
|
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGCTLLWS.DEVWAITTMR"><b>DEVWAITTMR</b></a></td>
|
|
<td valign="top">Device wait timer</td>
|
|
<td valign="top">2-600, <b><u>*SAME</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGCTLLWS.AUTOCFG"><b>AUTOCFG</b></a></td>
|
|
<td valign="top">Auto-configuration controller</td>
|
|
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CHGCTLLWS.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>*SAME</u></b>, *NONE</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="#CHGCTLLWS.INZMBR"><b>INZMBR</b></a></td>
|
|
<td valign="top">Initialization 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" rowspan="3"><a href="#CHGCTLLWS.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>*SAME</u></b>, *NONE</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" rowspan="3"><a href="#CHGCTLLWS.MSGQ"><b>MSGQ</b></a></td>
|
|
<td valign="top">Message queue</td>
|
|
<td valign="top">Single values: <b><u>*SAME</u></b>, *SYSVAL, *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="#CHGCTLLWS.TEXT"><b>TEXT</b></a></td>
|
|
<td valign="top">Text 'description'</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *BLANK</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCTLLWS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CHGCTLLWS.CTLD"></a>
|
|
<h3>Controller description (CTLD)</h3>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<p>Specifies the name of the controller description.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCTLLWS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCTLLWS.RSRCNAME"></a>
|
|
<h3>Resource name (RSRCNAME)</h3>
|
|
<p>Specifies the resource name that identifies the hardware this description represents. Use the WRKHDWRSC command to determine the resource name.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>
|
|
</dd>
|
|
</dl>
|
|
<p>This value does not change.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCTLLWS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCTLLWS.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><u>*SAME</u></b></dt>
|
|
<dd>
|
|
</dd>
|
|
</dl>
|
|
<p>This value does not change.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>
|
|
</dd>
|
|
</dl>
|
|
<p>The controller is automatically varied on at IPL.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>
|
|
</dd>
|
|
</dl>
|
|
<p>The controller is not automatically varied on at IPL.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCTLLWS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCTLLWS.DEVWAITTMR"></a>
|
|
<h3>Device wait timer (DEVWAITTMR)</h3>
|
|
<p>Specifies the device wait timeout value. This is used to limit the amount of time that a subsystem takes for the work station input/output to complete. The timeout value that is used for each device is obtained from the controller that it is attached to at vary on time. A change in this parameter value takes effect for attached devices when they are next varied on.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>
|
|
</dd>
|
|
</dl>
|
|
<p>This value does not change.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>device-wait-timer</i></b></dt>
|
|
<dd>
|
|
</dd>
|
|
</dl>
|
|
<p>Specify a value ranging from 2 through 600 that specifies the maximum number of seconds that the subsystem waits for work station input/output to complete for all work stations attached to this controller.
|
|
</p>
|
|
<p>When selecting a value for this parameter, the types of devices attached to the controller should be taken into account. Locally attached work stations should have a low value for this parameter (10 seconds or less).
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCTLLWS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCTLLWS.AUTOCFG"></a>
|
|
<h3>Auto-configuration controller (AUTOCFG)</h3>
|
|
<p>Specifies whether this controller description is the one which should have devices attached when they are automatically configured. Although there can be more than one controller description for each controller, only one description can be an automatic configuration controller. When new devices are automatically configured on that controller, they are attached to the automatic configuration controller description.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>
|
|
</dd>
|
|
</dl>
|
|
<p>This value does not change.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>
|
|
</dd>
|
|
</dl>
|
|
<p>This is not an automatic configuration controller.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>
|
|
</dd>
|
|
</dl>
|
|
<p>This is an automatic configuration controller.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCTLLWS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCTLLWS.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 controller configuration data to the wireless adapter as discussed at the beginning of this command description.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>
|
|
</dd>
|
|
</dl>
|
|
<p>This value does not change.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>
|
|
</dd>
|
|
</dl>
|
|
<p>No initialization file name is specified.
|
|
</p>
|
|
<p>The NAME of the initialization file NAME can be qualified by one of the following library values:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>
|
|
</dd>
|
|
</dl>
|
|
<p>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.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>library-name</i></b></dt>
|
|
<dd>
|
|
</dd>
|
|
</dl>
|
|
<p>Specify the name of the library to be searched.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>initialization-file-NAME</i></b></dt>
|
|
<dd>
|
|
</dd>
|
|
</dl>
|
|
<p>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 controller description then the current IOP defaults are used for initializaion.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCTLLWS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCTLLWS.INZMBR"></a>
|
|
<h3>Initialization source member (INZMBR)</h3>
|
|
<p>Specifies the NAME of a source file member containing configuration initialization data (for a type 266A controller only).
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>The INZFILE and INZMBR parameters are required when downloading extended wireless controller configuration data to the wireless adapter as discussed at the beginning of this command description.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>
|
|
</dd>
|
|
</dl>
|
|
<p>This value does not change.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>
|
|
</dd>
|
|
</dl>
|
|
<p>No source file member is specified.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>initialization-member-name</i></b></dt>
|
|
<dd>
|
|
</dd>
|
|
</dl>
|
|
<p>Specify the name of a source file member containing the initialization data. A value of *NONE is accepted for this parameter. If a source member name has not been added prior to varying on this controller description, then the current IOP defaults are used.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCTLLWS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCTLLWS.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><u>*SAME</u></b></dt>
|
|
<dd>
|
|
</dd>
|
|
</dl>
|
|
<p>This value does not change.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>
|
|
</dd>
|
|
</dl>
|
|
<p>No initialization program name is specified.
|
|
</p>
|
|
<p>The NAME of the initialization program NAME can be qualified by one of the following library values:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>
|
|
</dd>
|
|
</dl>
|
|
<p>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.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>library-name</i></b></dt>
|
|
<dd>
|
|
</dd>
|
|
</dl>
|
|
<p>Specify the name of the library to be searched.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>initialization-program-name</i></b></dt>
|
|
<dd>
|
|
</dd>
|
|
</dl>
|
|
<p>Specify the name of a program to manage configuration initialization data. If a program name is specified, it is called when this controller description is created. The name of the source file and member containing configuration initialization data are passed to this program as parameters.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCTLLWS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCTLLWS.MSGQ"></a>
|
|
<h3>Message queue (MSGQ)</h3>
|
|
<p>Specifies the message queue to which operational messages are sent.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>
|
|
</dd>
|
|
</dl>
|
|
<p>This value does not change.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*SYSVAL</b></dt>
|
|
<dd>Messages are sent to the message queue defined in the QCFGMSGQ system value.
|
|
</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="#CHGCTLLWS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCTLLWS.TEXT"></a>
|
|
<h3>Text 'description' (TEXT)</h3>
|
|
<p>Specifies the text that briefly describes the object.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>
|
|
</dd>
|
|
</dl>
|
|
<p>This value does not change.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*BLANK</b></dt>
|
|
<dd>
|
|
</dd>
|
|
</dl>
|
|
<p>No text is specified.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>
|
|
</dd>
|
|
</dl>
|
|
<p>Specify no more than 50 characters of text, enclosed in apostrophes.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCTLLWS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGCTLLWS.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
CHGCTLLWS CTLD(MYCTLR) INZMBR(MBR3)
|
|
</pre>
|
|
</p>
|
|
<p>This command changes the controller description MYCTLR so that configuration initialization data is now contained in member MBR3 of the same source file as originally specified for this controller.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCTLLWS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGCTLLWS.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF2652</b></dt>
|
|
<dd>Controller description &1 not changed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCTLLWS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|