236 lines
7.5 KiB
HTML
236 lines
7.5 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 Tape Cartridge (CHGTAPCTG)</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="CHGTAPCTG.Top_Of_Page"></a>
|
||
|
|
<h2>Change Tape Cartridge (CHGTAPCTG)</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="#CHGTAPCTG.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#CHGTAPCTG.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#CHGTAPCTG.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="CHGTAPCTG"></a>
|
||
|
|
<p>The Change Tape Cartridge (CHGTAPCTG) command changes the specified cartridge from any category to the specified category.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGTAPCTG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="CHGTAPCTG.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="#CHGTAPCTG.DEV"><b>DEV</b></a></td>
|
||
|
|
<td valign="top">Library device</td>
|
||
|
|
<td valign="top"><i>Name</i></td>
|
||
|
|
<td valign="top">Required, Positional 1</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGTAPCTG.CTG"><b>CTG</b></a></td>
|
||
|
|
<td valign="top">Cartridge ID</td>
|
||
|
|
<td valign="top">Values (up to 40 repetitions): <i>Character value</i>, *ALL</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#CHGTAPCTG.CGY"><b>CGY</b></a></td>
|
||
|
|
<td valign="top">Category</td>
|
||
|
|
<td valign="top">Single values: *SHARE400<br>Other values: <i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Category name</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i>, <b><u>*SAME</u></b>, *NOSHARE, *IPL, *NL, *CNV</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Category system</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i>, <b><u>*SAME</u></b>, *CURRENT</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGTAPCTG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="CHGTAPCTG.DEV"></a>
|
||
|
|
<h3>Library device (DEV)</h3>
|
||
|
|
<p>Specifies the device to be used. The device name must have previously been created on the system using the Create Device Media Library (CRTDEVMLB) command.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the device.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGTAPCTG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGTAPCTG.CTG"></a>
|
||
|
|
<h3>Cartridge ID (CTG)</h3>
|
||
|
|
<p>Specifies the cartridge identifiers that are to have their corresponding categories changed to the category specified.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>The cartridge identifier should represent the external identifier if the library device has a bar code scanner to read external identifiers.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>All tape cartridges in the device are changed.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>generic-identifier</i></b></dt>
|
||
|
|
<dd>Specify the generic name of the cartridge identifier. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. The asterisk substitutes for any valid characters. A generic name specifies all cartridge identifiers with names that begin with the generic prefix. If an asterisk is not included with the generic (prefix) name, the system assumes it to be the complete cartridge identifier.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>identifier</i></b></dt>
|
||
|
|
<dd>Specify 1 to 40 cartridge identifiers to change the category of.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGTAPCTG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGTAPCTG.CGY"></a>
|
||
|
|
<h3>Category (CGY)</h3>
|
||
|
|
<p>Specifies the category to change the tape cartridge to. The category cannot be changed with this command if it is a *NOSHARE category unless the command is executed from the system that owns the rights of the *NOSHARE.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*SHARE400</b></dt>
|
||
|
|
<dd>The cartridge identifiers specified are changed to the *SHARE400 category.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 1: Category name</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The category information is not changed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NOSHARE</b></dt>
|
||
|
|
<dd>The cartridge identifiers specified are changed to the *NOSHARE category.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*IPL</b></dt>
|
||
|
|
<dd>The cartridge identifiers specified are changed to the *IPL category.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NL</b></dt>
|
||
|
|
<dd>The cartridge identifiers specified are changed to the *NL category.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>character-value</i></b></dt>
|
||
|
|
<dd>Specify the name of a user-defined category. The cartridge identifiers specified are changed to the user-defined category that is specified.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: Category system</b>
|
||
|
|
</p>
|
||
|
|
<p>The system name is obtained from the pending system name field of a Display Network Attributes (DSPNETA) command. If there is no pending system name, the current system name attribute is used.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
***** Attention *****************************
|
||
|
|
If the system name is changed, all category
|
||
|
|
information associated with all tape
|
||
|
|
cartridges in library devices are not valid.
|
||
|
|
*********************************************
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The system does not change.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CURRENT</b></dt>
|
||
|
|
<dd>The category belongs to the system currently running the command.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>character-value</i></b></dt>
|
||
|
|
<dd>Specify the name of the system to which the category belongs.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGTAPCTG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CHGTAPCTG.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CHGTAPCTG DEV(LIB01) CTG(VOL1) CGY(*SHARE400)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command changes the category associated with the cartridge identifier VOL1 to the category *SHARE400.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGTAPCTG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CHGTAPCTG.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CPF6708</b></dt>
|
||
|
|
<dd>Command ended due to error.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF6711</b></dt>
|
||
|
|
<dd>Command not allowed
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF6718</b></dt>
|
||
|
|
<dd>Cannot allocate device &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF6745</b></dt>
|
||
|
|
<dd>Device &1 not a media library device.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF67A6</b></dt>
|
||
|
|
<dd>Category does not exist
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF67D2</b></dt>
|
||
|
|
<dd>Cartridge command was not successful.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF67D4</b></dt>
|
||
|
|
<dd>Category not available
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF67E4</b></dt>
|
||
|
|
<dd>Library device function not successful
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF67EA</b></dt>
|
||
|
|
<dd>Function not successful
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF67F5</b></dt>
|
||
|
|
<dd>Duplicate cartridge or virtual volume name found
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF67F9</b></dt>
|
||
|
|
<dd>&6 cartridges not changed
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9814</b></dt>
|
||
|
|
<dd>Device &1 not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9825</b></dt>
|
||
|
|
<dd>Not authorized to device &1.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGTAPCTG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|