157 lines
6.4 KiB
HTML
157 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>Create Tape Category (CRTTAPCGY)</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="CRTTAPCGY.Top_Of_Page"></a>
|
|
<h2>Create Tape Category (CRTTAPCGY)</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="#CRTTAPCGY.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CRTTAPCGY.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CRTTAPCGY.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CRTTAPCGY"></a>
|
|
<p>The Create Tape Category (CRTTAPCGY) command creates a user defined category name and assigns it to a system name. A category may be used to "group" volume identifiers together. The following special value categories have been provided by the operating system and are defined for all library devices.
|
|
</p>
|
|
<ul>
|
|
<li>*NOSHARE
|
|
<p>For D/T3494 tape media libraries the volume identifier may only be used by the system that owns the rights of the *NOSHARE. Other tape media libraries can have cartridge identifiers in the *NOSHARE category, but the security of the *NOSHARE is not handled by the operating system.
|
|
</p>
|
|
</li>
|
|
<li>*SHARE400
|
|
<p>The cartridge identifier may be shared by all systems that are attached to the library device.
|
|
</p>
|
|
</li>
|
|
<li>*IPL
|
|
<p>This category should be used for cartridge identifiers that would be used in an alternate IPL. The management of the cartridges in the category must be done by the user.
|
|
</p>
|
|
</li>
|
|
<li>*NL
|
|
<p>The cartridge identifier in this category must have no logical volume identifier in order for it to be used. If it has a logical volume identifier, an Initialize Tape (INZTAP) command must be done to initialize the tape volume to a non-labeled tape before it can be used.
|
|
</p>
|
|
</li>
|
|
<li>*INSERT
|
|
<p>The cartridge identifier has been placed in the library device, but has not yet been added to the system. An Add Tape Cartridge (ADDTAPCTG) command must be done before any I/O may be done to the tape volume.
|
|
</p>
|
|
</li>
|
|
<li>*EJECT
|
|
<p>The volume identifier has been removed from the system by a Remove Tape Cartridge (RMVTAPCTG) command and is no longer usable by the library device.
|
|
</p>
|
|
</li>
|
|
<li>*CNV
|
|
<p>When a tape in this category is unloaded by specifying ENDOPT(*UNLOAD), OS/400 will automatically export the tape to the convenience station.
|
|
</p>
|
|
</li>
|
|
<li>*SYSGEN
|
|
<p>The cartridge ID exists in the *SYSGEN category. *SYSGEN category is used for all cartridges when the library device description is in *SYSGEN mode. A library device description is in *SYSGEN mode when the GENCTGID parameter is *SYSGEN in the device description. *SYSGEN mode is used to generate identifiers for non-bar code libraries instead of loading and reading all the logical volume identifiers directly from the tape. If the library device is in *SYSGEN mode, cartridges cannot be moved from the *SYSGEN category.
|
|
</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTTAPCGY.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CRTTAPCGY.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" rowspan="3"><a href="#CRTTAPCGY.CGY"><b>CGY</b></a></td>
|
|
<td valign="top">Category</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Category name</td>
|
|
<td valign="top">
|
|
<i>Character value</i></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>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTTAPCGY.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CRTTAPCGY.CGY"></a>
|
|
<h3>Category (CGY)</h3>
|
|
<p>Specifies the category being created.
|
|
</p>
|
|
<p><b>Element 1: Category name</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the name of the category to create.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Category system</b>
|
|
</p>
|
|
<p>Identifies the system the category belongs to. The system name is obtained from the current system name field of a Display Network Attributes (DSPNETA) command.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*CURRENT</u></b></dt>
|
|
<dd>The system currently running the command.
|
|
</dd>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the name of the system that the category belongs to. Do not attempt to create a category and specify an owning system other than *CURRENT, unless the category has previously been defined on the system specified. For example, If system A and system B are attached to library device LIB01, then CRTTAPCGY CGY(CAT1 A) creating category CAT1 and assigning as its owner system A is required on system A before a CRTTAPCGY CGY(CAT1 A) creating category CAT1 and assigning as its owner system A can be done on system B. If both of these create commands are successful, CAT1 owned by system A is logically considered the same category and can be used for cartridges in library LIB01.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTTAPCGY.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CRTTAPCGY.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
CRTTAPCGY CGY(CAT1 RCHAS215)
|
|
</pre>
|
|
</p>
|
|
<p>This command creates a user defined category named CAT1 and assigns as its primary owner system RCHAS215.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTTAPCGY.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CRTTAPCGY.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF67DD</b></dt>
|
|
<dd>Category not created.
|
|
</dd>
|
|
<dt><b>CPF67E2</b></dt>
|
|
<dd>Category already exists
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTTAPCGY.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|