friedkiwi/ibm-information-center
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
14ed2849c6
ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/crtctlvws.htm

312 lines
11 KiB
HTML
Raw Blame History

<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Create Ctl Desc (Virtual WS) (CRTCTLVWS)</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="CRTCTLVWS.Top_Of_Page"></a>
<h2>Create Ctl Desc (Virtual WS) (CRTCTLVWS)</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="#CRTCTLVWS.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CRTCTLVWS.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CRTCTLVWS.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CRTCTLVWS"></a>
<p>The Create Controller Description (Virtual Work Station) (CRTCTLVWS) command creates a controller description for a virtual work station (pass-through) controller. For more information about using this command, see the Communications Configuration book, SC41-5401.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTCTLVWS.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CRTCTLVWS.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="#CRTCTLVWS.CTLD"><b>CTLD</b></a></td>
<td valign="top">Controller description</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#CRTCTLVWS.ONLINE"><b>ONLINE</b></a></td>
<td valign="top">Online at IPL</td>
<td valign="top"><b><u>*YES</u></b>, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTCTLVWS.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="#CRTCTLVWS.DEV"><b>DEV</b></a></td>
<td valign="top">Attached devices</td>
<td valign="top">Values (up to 255 repetitions): <i>Name</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTCTLVWS.DEVWAITTMR"><b>DEVWAITTMR</b></a></td>
<td valign="top">Device wait timer</td>
<td valign="top">2-120, <b><u>20</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CRTCTLVWS.MSGQ"><b>MSGQ</b></a></td>
<td valign="top">Message queue</td>
<td valign="top">Single values: <b><u>*SYSVAL</u></b>, *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="#CRTCTLVWS.AUT"><b>AUT</b></a></td>
<td valign="top">Authority</td>
<td valign="top"><i>Name</i>, <b><u>*CHANGE</u></b>, *ALL, *USE, *EXCLUDE, *LIBCRTAUT</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CRTCTLVWS.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CRTCTLVWS.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="#CRTCTLVWS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTCTLVWS.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>*YES</u></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="#CRTCTLVWS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTCTLVWS.TEXT"></a>
<h3>Text 'description' (TEXT)</h3>
<p>Specifies the text that briefly describes the object.
</p>
<dl>
<dt><b><u>*BLANK</u></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="#CRTCTLVWS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTCTLVWS.DEV"></a>
<h3>Attached devices (DEV)</h3>
<p>Specifies the names of the devices that are attached to this controller. The device descriptions must already exist.
</p>
<p>A maximum of 255 devices can be specified.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTCTLVWS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTCTLVWS.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>10</u></b></dt>
<dd>
</dd>
</dl>
<p>For local controllers, the subsystem waits a maximum of 10 seconds for the completion of the input/output of each work station attached to this controller.
</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="#CRTCTLVWS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTCTLVWS.MSGQ"></a>
<h3>Message queue (MSGQ)</h3>
<p>Specifies the message queue to which operational messages are sent.
</p>
<dl>
<dt><b><u>*SYSVAL</u></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>
<p>For more information about using this command, see the Communcations Management book, SC41-5406.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTCTLVWS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTCTLVWS.AUT"></a>
<h3>Authority (AUT)</h3>
<p>Specifies the authority you are giving to users who do not have specific authority for the object, who are not on an authorization list, and whose group profile or supplemental group profiles do not have specific authority for the object.
</p>
<dl>
<dt><b><u>*CHANGE</u></b></dt>
<dd>The user can perform all operations on the object except those limited to the owner or controlled by object existence (*OBJEXIST) and object management (*OBJMGT) authorities. The user can change and perform basic functions on the object. *CHANGE authority provides object operational (*OBJOPR) authority and all data authority. If the object is an authorization list, the user cannot add, change, or remove users.
</dd>
</dl>
<dl>
<dt><b>*ALL</b></dt>
<dd>The user can perform all operations except those limited to the owner or controlled by authorization list management (*AUTLMGT) authority. The user can control the object's existence, specify the security for the object, change the object, and perform basic functions on the object. The user also can change ownership of the object.
</dd>
</dl>
<dl>
<dt><b>*USE</b></dt>
<dd>The user can perform basic operations on the object, such as running a program or reading a file. The user cannot change the object. Use (*USE) authority provides object operational (*OBJOPR), read (*READ), and execute (*EXECUTE) authorities.
</dd>
</dl>
<dl>
<dt><b>*EXCLUDE</b></dt>
<dd>The user cannot access the object.
</dd>
</dl>
<dl>
<dt><b>*LIBCRTAUT</b></dt>
<dd>The system determines the authority for the object by using the value specified for the <b>Create authority (CRTAUT)</b> parameter on the Create Library (CRTLIB) command for the library containing the object to be created. If the value specified for the CRTAUT parameter is changed, the new value will not affect any existing objects.
</dd>
</dl>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of an authorization list to be used for authority to the object. Users included in the authorization list are granted authority to the object as specified in the list. The authorization list must exist when the object is created.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTCTLVWS.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CRTCTLVWS.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
CRTCTLVWS CTLD(VRTCTL325) TEXT('S/325 virtual controller')
</pre>
</p>
<p>This command creates a controller description named VRTCTL325.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTCTLVWS.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CRTCTLVWS.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF26BB</b></dt>
<dd>Extended wireless controller member not changed.
</dd>
<dt><b>CPF26BC</b></dt>
<dd>Extended wireless controller member not displayed.
</dd>
<dt><b>CPF26BD</b></dt>
<dd>Entry for barcode group not removed from extended wireless controller member.
</dd>
<dt><b>CPF26BE</b></dt>
<dd>Entry for PTC group not removed from extended wireless controller member.
</dd>
<dt><b>CPF26BF</b></dt>
<dd>Program QZXCINZ terminated abnormally. See previous messages.
</dd>
<dt><b>CPF26B3</b></dt>
<dd>Extended wireless line member not added.
</dd>
<dt><b>CPF26B4</b></dt>
<dd>Extended wireless line member not changed.
</dd>
<dt><b>CPF26B5</b></dt>
<dd>Extended wireless line member not displayed.
</dd>
<dt><b>CPF26B8</b></dt>
<dd>Extended wireless controller member not added.
</dd>
<dt><b>CPF2716</b></dt>
<dd>Controller description &amp;1 not created.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTCTLVWS.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink