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

233 lines
6.4 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 (Tape) (CHGCTLTAP)</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="CHGCTLTAP.Top_Of_Page"></a>
<h2>Change Ctl Desc (Tape) (CHGCTLTAP)</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="#CHGCTLTAP.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGCTLTAP.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGCTLTAP.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGCTLTAP"></a>
<p>The Change Controller Description (Tape) (CHGCTLTAP) command changes a controller description for a tape controller.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCTLTAP.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGCTLTAP.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="#CHGCTLTAP.CTLD"><b>CTLD</b></a></td>
<td valign="top">Controller description</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Optional, Key, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#CHGCTLTAP.RSRCNAME"><b>RSRCNAME</b></a></td>
<td valign="top">Resource name</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="#CHGCTLTAP.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="#CHGCTLTAP.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"><a href="#CHGCTLTAP.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="#CHGCTLTAP.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGCTLTAP.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="#CHGCTLTAP.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCTLTAP.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>
<dl>
<dt><b>*NONE</b></dt>
<dd>
</dd>
</dl>
<p>No resource name is specified at this time. A resource name must be provided before the device can be varied on.
</p>
<dl>
<dt><b><i>resource-NAME</i></b></dt>
<dd>
</dd>
</dl>
<p>Specify the name to identify the physical devices on the system. Use the Work with Hardware Resources (WRKHDWRSC) command with *STG specified for the TYPE parameter to help determine the resource name.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCTLTAP.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCTLTAP.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="#CHGCTLTAP.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCTLTAP.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="#CHGCTLTAP.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCTLTAP.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="#CHGCTLTAP.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGCTLTAP.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
CHGCTLTAP CTLD(TAP01) ONLINE(*NO)
</pre>
</p>
<p>This command changes the ONLINE parameter value to *NO for a tape controller named TAP01.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCTLTAP.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGCTLTAP.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF2652</b></dt>
<dd>Controller description &amp;1 not changed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCTLTAP.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>