373 lines
14 KiB
HTML
373 lines
14 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>Set Tape Category (SETTAPCGY)</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="SETTAPCGY.Top_Of_Page"></a>
|
||
|
|
<h2>Set Tape Category (SETTAPCGY)</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="#SETTAPCGY.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#SETTAPCGY.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#SETTAPCGY.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="SETTAPCGY"></a>
|
||
|
|
<p>The Set Tape Category (SETTAPCGY) command sets the category for a tape device in a specified media library device. The system automatically loads cartridges from the specified category in the order specified on the cartridge order (CTGORDER) parameter.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SETTAPCGY.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="SETTAPCGY.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="#SETTAPCGY.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="#SETTAPCGY.OPTION"><b>OPTION</b></a></td>
|
||
|
|
<td valign="top">Option</td>
|
||
|
|
<td valign="top">*MOUNTED, *DEMOUNTED, *ASSIGN, *RELEASE</td>
|
||
|
|
<td valign="top">Required, Positional 2</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#SETTAPCGY.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="#SETTAPCGY.CTGORDER"><b>CTGORDER</b></a></td>
|
||
|
|
<td valign="top">Cartridge order</td>
|
||
|
|
<td valign="top"><b><u>*SEQ</u></b>, *NEXTAVAIL</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#SETTAPCGY.TGTCGY"><b>TGTCGY</b></a></td>
|
||
|
|
<td valign="top">Target 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>*CGY</u></b>, *NOSHARE, *IPL, *NL</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="#SETTAPCGY.MNTID"><b>MNTID</b></a></td>
|
||
|
|
<td valign="top">Mount identifier</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*NONE</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SETTAPCGY.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="SETTAPCGY.DEV"></a>
|
||
|
|
<h3>Library device (DEV)</h3>
|
||
|
|
<p>Specifies the media library device for which the category is set.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the media library device.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SETTAPCGY.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SETTAPCGY.OPTION"></a>
|
||
|
|
<h3>Option (OPTION)</h3>
|
||
|
|
<p>Specifies which option is set for the specified media library device.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*MOUNTED</b></dt>
|
||
|
|
<dd>The category specified on the CGY parameter is considered mounted and any tape operation with VOL(*MOUNTED) specified uses the tape cartridges from the category that is mounted.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*DEMOUNTED</b></dt>
|
||
|
|
<dd>The category specified on the CGY parameter is no longer mounted. The use of VOL(*MOUNTED) is not valid for the media library device.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ASSIGN</b></dt>
|
||
|
|
<dd>The mounted category session specified on the MNTID parameter is assigned to the job issuing the SETTAPCGY command. The mounted category session being assigned must have been previously mounted and released.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*RELEASE</b></dt>
|
||
|
|
<dd>The mounted category session assigned to the job issuing the SETTAPCGY command is released and is available for another job to assign.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SETTAPCGY.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SETTAPCGY.CGY"></a>
|
||
|
|
<h3>Category (CGY)</h3>
|
||
|
|
<p>Specifies the category to be mounted.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*SHARE400</b></dt>
|
||
|
|
<dd>The cartridge identifier can be shared by all iSeries systems that are attached to the library device. The cartridge identifiers are mounted in the order specified in the CTGORDER parameter.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 1: Category name</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NOSHARE</u></b></dt>
|
||
|
|
<dd>The cartridge identifiers cannot be shared with other systems that are attached to the same device. The cartridge identifiers are mounted in the order specified in the CTGORDER parameter.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*IPL</b></dt>
|
||
|
|
<dd>The cartridge identifiers can be used for an alternate initial program load (IPL) of the system. The cartridge identifiers are mounted in the order specified in the CTGORDER parameter.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NL</b></dt>
|
||
|
|
<dd>The cartridge is used as a non-labeled tape. The cartridge identifiers are mounted in the order specified in the CTGORDER parameter.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CNV</b></dt>
|
||
|
|
<dd>The cartridge identifier is used from the special convenience category. The cartridge identifiers are mounted in the order specified in the CTGORDER parameter.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>character-value</i></b></dt>
|
||
|
|
<dd>Specify the name of a user-defined category. The cartridge identifiers in the category specified are mounted in the order specified in the CTGORDER parameter.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: Category system</b>
|
||
|
|
</p>
|
||
|
|
<p>The second part of the parameter specifies the name of 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>
|
||
|
|
<b>* * * Attention * * *</b>
|
||
|
|
If a system name is changed, the tape cartridges in
|
||
|
|
library devices that have the attribute of the system
|
||
|
|
name before it was changed are no longer 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="#SETTAPCGY.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SETTAPCGY.CTGORDER"></a>
|
||
|
|
<h3>Cartridge order (CTGORDER)</h3>
|
||
|
|
<p>Specifies the order in which the cartridges are mounted.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SEQ</u></b></dt>
|
||
|
|
<dd>The cartridges are mounted in the order they were added or changed to the category specified. The operation ends if the next cartridge in the sequential order is not available.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NEXTAVAIL</b></dt>
|
||
|
|
<dd>The cartridges are mounted in a sequential order, but if a cartridge in the order is not available, the next available cartridge is used.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SETTAPCGY.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SETTAPCGY.TGTCGY"></a>
|
||
|
|
<h3>Target category (TGTCGY)</h3>
|
||
|
|
<p>Specifies the category to which a tape cartridge is changed after it is used. This parameter can be useful when a scratch category is set for use during a save operation. Each cartridge is automatically changed to the specified target category after it is used.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*SHARE400</b></dt>
|
||
|
|
<dd>The cartridge identifiers are changed to the *SHARE400 category.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 1: Category name</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*CGY</u></b></dt>
|
||
|
|
<dd>The cartridges remain in the category specified on the CGY parameter.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NOSHARE</b></dt>
|
||
|
|
<dd>The cartridge identifiers are changed to the *NOSHARE category.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*IPL</b></dt>
|
||
|
|
<dd>The cartridge identifiers are changed to the *IPL category.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NL</b></dt>
|
||
|
|
<dd>The cartridge identifiers 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 are changed to the specified user-defined category.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: Category system</b>
|
||
|
|
</p>
|
||
|
|
<p>The second part of this parameter specifies the name of the system to which the target category belongs. The system name is obtained from the pending system name field of the Display Network Attributes (DSPNETA) command. If there is no pending system name, the current system name attribute is used.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
<b>* * * Attention * * *</b>
|
||
|
|
If a system name is changed, the tape cartridges in
|
||
|
|
library devices that have the attribute of the system
|
||
|
|
name before it was changed are no longer valid.
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*CURRENT</u></b></dt>
|
||
|
|
<dd>The system currently running the command is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>character-value</i></b></dt>
|
||
|
|
<dd>Specify the name of the system that the category belongs to.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SETTAPCGY.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SETTAPCGY.MNTID"></a>
|
||
|
|
<h3>Mount identifier (MNTID)</h3>
|
||
|
|
<p>Specifies the identifier by which the mounted category session will be known. This parameter is valid only when OPTION(*MOUNTED) or OPTION(*ASSIGN) is specified.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>This mounted category session is not assigned to any job and will be used by the first job that issues a command to the media library with a volume identifier of *MOUNTED. The mount identifier *NONE cannot be specified with OPTION(*ASSIGN).
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify a unique name to identify the mounted category session. A mounted category session known by this mount identifier is created and assigned when the category is mounted. This identifier is then used when assigning the session to another job. The session known by this identifier is deleted when the category is demounted. The mount identifier can then be reused when mounting another category to the media library.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SETTAPCGY.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="SETTAPCGY.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Using Mounted Category Without a Mount Identifier</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
SETTAPCGY MLB(LIB01) OPTION(*MOUNTED) CGY(*NOSHARE *CURRENT)
|
||
|
|
CTGORDER(*SEQ) TGTCGY(*IPL)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command sets the tape category to *NOSHARE for a resource in media library device LIB01 on the system currently running this command. Each cartridge that is used is changed to the *IPL category. The order in which the cartridges are used is the exact order in which they were added to or changed in the category. As each cartridge is used and unloaded from the resource, the system automatically chooses and loads the next sequential cartridge from the *NOSHARE category.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: Using Mounted Category with a Mount Identifer</b>
|
||
|
|
</p>
|
||
|
|
<p>This command sets the tape category to *NOSHARE for a resource in media library device LIB01 on the system currently running this command. The mounted category session is identified by the mount identifier DAILY. Each cartridge that is used is changed to the DAILY1 category. The order in which the cartridges are used is the exact order in which they were added to or changed in the category. As each cartridge is used and unloaded from the resource, the system automatically chooses and loads the next sequential cartridge from the *NOSHARE category.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 3: Releasing a Category Session</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
SETTAPCGY MLB(LIB01) OPTION(*RELEASE)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command releases the category session assigned to the job issuing the command. The category is still set to a resource in media library device LIB01 and is available for another job to assign.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 4: Assigning a Category Session</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
SETTAPCGY MLB(LIB01) OPTION(*ASSIGN) MNTID(DAILY)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command assigns the mounted category session identified by the mount identifier DAILY to the job issuing the command.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 5: Demounting a Mounted Category</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
SETTAPCGY MLB(LIB01) OPTION(*DEMOUNTED)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command demounts the mounted category from a resource in media library device LIB01. The mount identifier DAILY is now available to use to name another mounted category session.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SETTAPCGY.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="SETTAPCGY.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CPF6711</b></dt>
|
||
|
|
<dd>Command not allowed
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF6712</b></dt>
|
||
|
|
<dd>Category &4 not mounted.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF6713</b></dt>
|
||
|
|
<dd>Category not demounted.
|
||
|
|
</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>CPF67AD</b></dt>
|
||
|
|
<dd>Category not assigned.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF67AE</b></dt>
|
||
|
|
<dd>Category not released.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF67E4</b></dt>
|
||
|
|
<dd>Library device function not successful
|
||
|
|
</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="#SETTAPCGY.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|