253 lines
10 KiB
HTML
253 lines
10 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>Remove Tape Cartridge (RMVTAPCTG)</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="RMVTAPCTG.Top_Of_Page"></a>
|
|
<h2>Remove Tape Cartridge (RMVTAPCTG)</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="#RMVTAPCTG.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#RMVTAPCTG.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#RMVTAPCTG.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="RMVTAPCTG"></a>
|
|
<p>The Remove Tape Cartridge (RMVTAPCTG) command removes the specified cartridge identifiers from their current category, or from the category specified, and places them in the eject (*EJECT) category. The *EJECT category is not a valid category for input/output (I/O) operations; cartridges in the *EJECT category cannot be used in the tape device.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVTAPCTG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="RMVTAPCTG.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="#RMVTAPCTG.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="#RMVTAPCTG.CTG"><b>CTG</b></a></td>
|
|
<td valign="top">Cartridge ID</td>
|
|
<td valign="top">Single values: *ALL<br>Other values (up to 40 repetitions): <i>Character value</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#RMVTAPCTG.CGY"><b>CGY</b></a></td>
|
|
<td valign="top">Category</td>
|
|
<td valign="top">Single values: *SHARE400, *INSERT<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>, *NOSHARE, *IPL, *NL, *CNV</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Category system</td>
|
|
<td valign="top">
|
|
<i>Character value</i>, <b><u>*CURRENT</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RMVTAPCTG.STATION"><b>STATION</b></a></td>
|
|
<td valign="top">Station</td>
|
|
<td valign="top"><b><u>*DEV</u></b>, *CNV, *HIGHCAP</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVTAPCTG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="RMVTAPCTG.DEV"></a>
|
|
<h3>Library device (DEV)</h3>
|
|
<p>Specifies the library device to be used. The device name must have been previously 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 library device.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVTAPCTG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RMVTAPCTG.CTG"></a>
|
|
<h3>Cartridge ID (CTG)</h3>
|
|
<p>Specifies the cartridge identifiers that are to be removed.
|
|
</p>
|
|
<p><b>Notes:</b>
|
|
</p>
|
|
<ul>
|
|
<li>The cartridge identifier should represent the external identifier if the library device has a bar code scanner to read external identifiers.
|
|
</li>
|
|
<li>If this parameter is specified, the CGY parameter cannot be specified.
|
|
</li>
|
|
</ul>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>All cartridges are removed.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Other values (up to 40 repetitions)</b>
|
|
</p>
|
|
<dl>
|
|
<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 the cartridge identifier to be removed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVTAPCTG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RMVTAPCTG.CGY"></a>
|
|
<h3>Category (CGY)</h3>
|
|
<p>Specifies the category from which the tape cartridges are to be removed.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>If the CGY parameter is specified, the CTG parameter cannot be specified.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*SHARE400</b></dt>
|
|
<dd>The cartridge identifiers assigned to the *SHARE400 category are removed. A cartridge in this category can be shared with other systems attached to the same device.
|
|
</dd>
|
|
<dt><b>*INSERT</b></dt>
|
|
<dd>All cartridge identifiers assigned to the *INSERT category are removed. A cartridge in this category has been placed in the library device, but its identifier has not been added to the system.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 1: Category name</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NOSHARE</u></b></dt>
|
|
<dd>All cartridges identifiers assigned to the *NOSHARE category are removed. A cartridge with this identifier cannot be shared with other systems.
|
|
</dd>
|
|
<dt><b>*IPL</b></dt>
|
|
<dd>The cartridges identifiers assigned to the *IPL category are removed. A cartridge with this identifier can be used for an alternate IPL.
|
|
</dd>
|
|
<dt><b>*NL</b></dt>
|
|
<dd>All cartridges identifiers assigned to the *NL category are removed. A cartridge with this identifier is used as a non-labeled tape.
|
|
</dd>
|
|
<dt><b>*CNV</b></dt>
|
|
<dd>All cartridge identifiers assigned to the *CNV category are removed. A cartridge in this category would be automatically removed by OS/400 if the cartridge was loaded and an unload was requested by a user.
|
|
</dd>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the name of a user-defined category. The cartridge identifiers assigned to the specified user-defined category are removed.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Category system</b>
|
|
</p>
|
|
<p>This element identifies the system to which the category belongs. 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 attribute is used.
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
****** Attention ****************************
|
|
If the system name is changed, the
|
|
categories associated with all tape
|
|
cartridges in library devices are not valid.
|
|
*********************************************
|
|
</pre>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*CURRENT</u></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="#RMVTAPCTG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RMVTAPCTG.STATION"></a>
|
|
<h3>Station (STATION)</h3>
|
|
<p>Specifies the station to receive the cartridges being ejected.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*DEV</u></b></dt>
|
|
<dd>If the tape library has a convenience I/O station, the cartridges are placed in it. If the tape library does not have a convenience I/O station, the cartridges are placed in the high capacity output station. If the tape library does not have a high capacity output station, the cartridges are placed in a storage slot within the library. The library door must be opened to physically remove the tape cartridges from the high capacity output station or a storage slot within the library.
|
|
</dd>
|
|
<dt><b>*CNV</b></dt>
|
|
<dd>The tape cartridge is ejected to the convenience I/O station. The convenience I/O station allows entry and removal of the tape cartridges from the library without opening the library door. If the tape library does not have a convenience I/O station, the cartridges are placed in the high capacity output station. If the tape library does not have a high capacity output station, the cartridges are placed in a storage slot within the library. The library door must be opened to physically remove the tape cartridges from the high capacity output station or a storage slot within the library.
|
|
</dd>
|
|
<dt><b>*HIGHCAP</b></dt>
|
|
<dd>The tape cartridges are ejected to the high capacity output station in the library device. If the tape library does not have a high capacity output station, the cartridges are placed in the convenience I/O station. If the tape library does not have a convenience I/O station, the cartridges are placed in a storage slot within the library. The library door must be opened to physically remove the tape cartridges from the high capacity output station or a storage slot within the library.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVTAPCTG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="RMVTAPCTG.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Removing a Single Cartridge to the *HIGHCAP station</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
RMVTAPCTG DEV(LIB01) CTG(VOL4) STATION(*HIGHCAP)
|
|
</pre>
|
|
</p>
|
|
<p>This command removes the cartridge identifier VOL4 from its current category and places it in the *EJECT category. The cartridge is placed in the high capacity output station. If no high capacity output station is defined the cartridge will be placed in a convenvience I/O station. If no convenience I/O is supported the cartridge will remain in a storage slot.
|
|
</p>
|
|
<p><b>Example 2: Removing All Cartridges from the *IPL Category</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
RMVTAPCTG DEV(LIB01) CGY(*IPL) STATION(*CNV)
|
|
</pre>
|
|
</p>
|
|
<p>This command removes all cartridge identifiers in the *IPL category and places them in the *EJECT category. The cartridges are placed in the convenience I/O station.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVTAPCTG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="RMVTAPCTG.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF67AF</b></dt>
|
|
<dd>&6 cartridges not removed
|
|
</dd>
|
|
<dt><b>CPF6745</b></dt>
|
|
<dd>Device &1 not a media library device.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVTAPCTG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|