280 lines
10 KiB
HTML
280 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>Add Tape Cartridge (ADDTAPCTG)</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="ADDTAPCTG.Top_Of_Page"></a>
|
|
<h2>Add Tape Cartridge (ADDTAPCTG)</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="#ADDTAPCTG.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#ADDTAPCTG.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#ADDTAPCTG.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="ADDTAPCTG"></a>
|
|
<p>The Add Tape Cartridge (ADDTAPCTG) command adds the specified cartridge identifiers to a usable category. Cartridges are placed in the insert category when they are placed in the library device and must be added to a usable category before they can be used by a tape device.
|
|
</p>
|
|
<p>The cartridge identifier must be unique within a library device. If a duplicate cartridge identifier does exist in a library device, both cartridges are unusable until one is physically removed from the library device.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDTAPCTG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="ADDTAPCTG.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="#ADDTAPCTG.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="#ADDTAPCTG.CTG"><b>CTG</b></a></td>
|
|
<td valign="top">Cartridge ID</td>
|
|
<td valign="top">Values (up to 40 repetitions): <i>Character value</i></td>
|
|
<td valign="top">Required, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#ADDTAPCTG.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>*NOSHARE</u></b>, *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="#ADDTAPCTG.CHKVOL"><b>CHKVOL</b></a></td>
|
|
<td valign="top">Check volume identifier</td>
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDTAPCTG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="ADDTAPCTG.DEV"></a>
|
|
<h3>Library device (DEV)</h3>
|
|
<p>Specifies the library device to be used. The device name must have been created previously 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="#ADDTAPCTG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDTAPCTG.CTG"></a>
|
|
<h3>Cartridge ID (CTG)</h3>
|
|
<p>Specifies a maximum of 40 cartridge identifiers that are currently in the insert category that are added to the category specified.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the cartridge identifier to be added. Each cartridge identifier can be a maximum of 6 characters.
|
|
<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>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDTAPCTG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDTAPCTG.CGY"></a>
|
|
<h3>Category (CGY)</h3>
|
|
<p>Specifies the category to which the tape cartridge is added. The cartridge is moved to a slot in the library device, unless the cartridge is added to the convenience (CNV) category.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*SHARE400</b></dt>
|
|
<dd>The cartridge identifier specified can be shared with other iSeries systems that are attached to the same device.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 1: Category name</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NOSHARE</u></b></dt>
|
|
<dd>The cartridge identifier specified cannot be shared with other systems that are attached to the same device.
|
|
</dd>
|
|
<dt><b>*IPL</b></dt>
|
|
<dd>The cartridge identifier specified can be used for an alternate initial program load (IPL) of a system. The management of the cartridges in the category must be done by the user.
|
|
<p>
|
|
<pre>
|
|
**** Attention **********************************
|
|
When using the *IPL category for an alternate
|
|
IPL of a system, you must ensure that the
|
|
cartridges are the proper ones to be used for the
|
|
alternate IPL. Conflicts may arise if high-end
|
|
and low-end systems are attached to the same
|
|
library device.
|
|
**************************************************
|
|
</pre>
|
|
</p>
|
|
</dd>
|
|
<dt><b>*NL</b></dt>
|
|
<dd>The cartridge is used as a non-labeled tape.
|
|
</dd>
|
|
<dt><b>*CNV</b></dt>
|
|
<dd>The cartridge identifier specified is added to the special convenience category. It is not moved to a slot in the library device. When the cartridge is unloaded from a device, it is removed (exported) to the convenience station.
|
|
</dd>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the name of a user-defined category. This category name must have been created previously with the Create Tape Category (CRTTAPCGY) command.
|
|
</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 name attribute is used.
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
***** Attention *********************************
|
|
If the system name is changed, the category
|
|
information associated with all tape cartridges
|
|
in library devices is 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="#ADDTAPCTG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDTAPCTG.CHKVOL"></a>
|
|
<h3>Check volume identifier (CHKVOL)</h3>
|
|
<p>Specifies whether the logical volume identifier is forced to be identical to the external identifier if the library device has a bar code scanner to read the bar code identifier.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*YES</u></b></dt>
|
|
<dd>The tape cartridge is verified for the correct logical volume identifier by reading the volume label existing on the tape cartridge.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>The tape cartridge is not verified for the correct logical volume identifier. If a cartridge is added in which the external identifier does not match the logical volume identifier, the cartridge is valid for read-only operations. Output operations to the tape cartridge are not allowed unless the logical volume identifier is initialized to match the external identifier. If the tape is a non-labeled tape, this match is not enforced because there is no logical volume identifier.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDTAPCTG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="ADDTAPCTG.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Adding a Single Cartridge to the *SHARE400 Category</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ADDTAPCTG DEV(LIB01) CTG(VOL4) CGY(*SHARE400) CHKVOL(*NO)
|
|
</pre>
|
|
</p>
|
|
<p>This command adds the cartridge identifier VOL4 to the usable category *SHARE400. The logical volume identifier in the volume labels of VOL4 are not verified.
|
|
</p>
|
|
<p><b>Example 2: Adding Multiple Cartridges to the *NOSHARE Category</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ADDTAPCTG DEV(LIB01) CTG(VOL1 VOL2 VOL3)
|
|
CGY(*NOSHARE) CHKVOL(*YES)
|
|
</pre>
|
|
</p>
|
|
<p>This command adds the cartridge identifiers VOL1, VOL2, and VOL3 to the usable category *NOSHARE. The logical volume identifiers on the tape cartridges are verified when the command is run.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDTAPCTG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="ADDTAPCTG.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF67AB</b></dt>
|
|
<dd>&6 cartridges not added
|
|
</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>CPF67E4</b></dt>
|
|
<dd>Library device function not successful
|
|
</dd>
|
|
<dt><b>CPF67EA</b></dt>
|
|
<dd>Function not successful
|
|
</dd>
|
|
<dt><b>CPD67EB</b></dt>
|
|
<dd>Cartridge &2 not in *INSERT category
|
|
</dd>
|
|
<dt><b>CPF67EC</b></dt>
|
|
<dd>Library device description &1 does not exist
|
|
</dd>
|
|
<dt><b>CPF67ED</b></dt>
|
|
<dd>Library device &1 not available
|
|
</dd>
|
|
<dt><b>CPF67F5</b></dt>
|
|
<dd>Duplicate cartridge or virtual volume name found
|
|
</dd>
|
|
<dt><b>CPF6708</b></dt>
|
|
<dd>Command ended due to error.
|
|
</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>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="#ADDTAPCTG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|