244 lines
7.1 KiB
HTML
244 lines
7.1 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 (Virtual WS) (CHGCTLVWS)</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="CHGCTLVWS.Top_Of_Page"></a>
|
|
<h2>Change Ctl Desc (Virtual WS) (CHGCTLVWS)</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="#CHGCTLVWS.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CHGCTLVWS.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CHGCTLVWS.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CHGCTLVWS"></a>
|
|
<p>The Change Controller Description (Virtual Work Station) (CHGCTLVWS) command changes a controller description for a virtual work station (pass-through) controller.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCTLVWS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CHGCTLVWS.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="#CHGCTLVWS.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="#CHGCTLVWS.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="#CHGCTLVWS.DEVWAITTMR"><b>DEVWAITTMR</b></a></td>
|
|
<td valign="top">Device wait timer</td>
|
|
<td valign="top">2-120, <b><u>*SAME</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CHGCTLVWS.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="#CHGCTLVWS.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="#CHGCTLVWS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CHGCTLVWS.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="#CHGCTLVWS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCTLVWS.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="#CHGCTLVWS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCTLVWS.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="#CHGCTLVWS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCTLVWS.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="#CHGCTLVWS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCTLVWS.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="#CHGCTLVWS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGCTLVWS.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
CHGCTLVWS CTLD(VRTCTL325) TEXT('S/325 virtual controller')
|
|
</pre>
|
|
</p>
|
|
<p>This command changes the controller description of controller VRTCTL325 to have a new text description.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCTLVWS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGCTLVWS.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="#CHGCTLVWS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|