385 lines
13 KiB
HTML
385 lines
13 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>Display Tape Cartridge (DSPTAPCTG)</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="DSPTAPCTG.Top_Of_Page"></a>
|
|
<h2>Display Tape Cartridge (DSPTAPCTG)</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="#DSPTAPCTG.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#DSPTAPCTG.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#DSPTAPCTG.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="DSPTAPCTG"></a>
|
|
<p>The Display Tape Cartridge (DSPTAPCTG) command displays the attributes of tape cartridges.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPTAPCTG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="DSPTAPCTG.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="#DSPTAPCTG.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="#DSPTAPCTG.CTG"><b>CTG</b></a></td>
|
|
<td valign="top">Cartridge ID</td>
|
|
<td valign="top">Single values: <b><u>*ALL</u></b><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="#DSPTAPCTG.CGY"><b>CGY</b></a></td>
|
|
<td valign="top">Category</td>
|
|
<td valign="top">Single values: *SHARE400, *INSERT, *EJECT<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>*ALL</u></b>, *NOSHARE, *IPL, *NL, *SYSGEN, *CNV</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Category system</td>
|
|
<td valign="top">
|
|
<i>Character value</i>, <b><u>*CURRENT</u></b>, *ALL</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPTAPCTG.OUTPUT"><b>OUTPUT</b></a></td>
|
|
<td valign="top">Output</td>
|
|
<td valign="top"><b><u>*</u></b>, *PRINT, *OUTFILE</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#DSPTAPCTG.OUTFILE"><b>OUTFILE</b></a></td>
|
|
<td valign="top">File to receive output</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: File to receive output</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top" rowspan="3"><a href="#DSPTAPCTG.OUTMBR"><b>OUTMBR</b></a></td>
|
|
<td valign="top">Output member options</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Member to receive output</td>
|
|
<td valign="top">
|
|
<i>Name</i>, <b><u>*FIRST</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Replace or add records</td>
|
|
<td valign="top">
|
|
<b><u>*REPLACE</u></b>, *ADD</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPTAPCTG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="DSPTAPCTG.DEV"></a>
|
|
<h3>Library device (DEV)</h3>
|
|
<p>Specifies the library device to be used. The device description 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="#DSPTAPCTG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPTAPCTG.CTG"></a>
|
|
<h3>Cartridge ID (CTG)</h3>
|
|
<p>Specifies 1 to 40 cartridge identifiers to be displayed.
|
|
</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>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>All tape cartridges in the device or in the category specified are displayed.
|
|
</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.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPTAPCTG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPTAPCTG.CGY"></a>
|
|
<h3>Category (CGY)</h3>
|
|
<p>Specifies the category of tape cartridges to be shown.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*SHARE400</b></dt>
|
|
<dd>The cartridge identifiers in the *SHARE400 category are displayed. A cartridge in this category can be shared with other systems attached to the same device.
|
|
</dd>
|
|
<dt><b>*INSERT</b></dt>
|
|
<dd>The cartridge identifiers in the *INSERT category are displayed. A cartridge in this category has been placed in the library device, but its identifier has not been added to the system.
|
|
</dd>
|
|
<dt><b>*EJECT</b></dt>
|
|
<dd>The cartridge identifiers in the *EJECT category are displayed. A cartridge in this category has had its identifier removed from the system and is no longer usable.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 1: Category name</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>All categories are searched for the cartridge identifiers specified in the CTG parameter and all are displayed.
|
|
</dd>
|
|
<dt><b>*NOSHARE</b></dt>
|
|
<dd>The cartridge identifiers in the *NOSHARE category are displayed. A cartridge with this identifier cannot be shared with other systems.
|
|
</dd>
|
|
<dt><b>*IPL</b></dt>
|
|
<dd>The cartridge identifiers in the *IPL category are displayed. A cartridge with this identifier can be used for an alternate IPL.
|
|
</dd>
|
|
<dt><b>*NL</b></dt>
|
|
<dd>The cartridge identifiers in the *NL category are displayed. A cartridge with this identifier is used as a non-labeled tape.
|
|
</dd>
|
|
<dt><b>*SYSGEN</b></dt>
|
|
<dd>The cartridge identifiers in the *SYSGEN category are displayed. If the library device is in *SYSGEN mode, cartridges cannot be moved from the *SYSGEN category.
|
|
</dd>
|
|
<dt><b>*CNV</b></dt>
|
|
<dd>The cartridge identifiers in the *CNV category are displayed. A cartridge in this category is for use with 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, all category
|
|
information associated with all tape
|
|
cartridges in library devices are not valid.
|
|
*********************************************
|
|
</pre>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*CURRENT</u></b></dt>
|
|
<dd>The system currently executing the command.
|
|
</dd>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>All system names that own categories available to the system running this command are 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="#DSPTAPCTG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPTAPCTG.OUTPUT"></a>
|
|
<h3>Output (OUTPUT)</h3>
|
|
<p>Specifies whether the output from the command is displayed at the requesting workstation, printed to an output file, or printed with the job's spooled output.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*</u></b></dt>
|
|
<dd>The output is displayed (if requested by an interactive job) or printed with the job's spooled output (if requested by a batch job).
|
|
</dd>
|
|
<dt><b>*PRINT</b></dt>
|
|
<dd>The output is printed with the job's spooled output.
|
|
</dd>
|
|
<dt><b>*OUTFILE</b></dt>
|
|
<dd>The output is directed to a database file specified on the OUTFILE parameter. The file must have the same format as database file QSYS/QATAVOF.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPTAPCTG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPTAPCTG.OUTFILE"></a>
|
|
<h3>File to receive output (OUTFILE)</h3>
|
|
<p>Specifies the qualified name of the database file to which the information about the tape volumes is directed. If the file does not exist, this command creates a database file in the specified library. If a new file is created, the system uses QATAVOF in QSYS as a model with the format name of QTAVOLOF.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter is valid only when OUTPUT(*OUTFILE) is specified.
|
|
</p>
|
|
<p><b>Qualifier 1: File to receive output</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the database file to be used.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the library to be searched.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPTAPCTG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPTAPCTG.OUTMBR"></a>
|
|
<h3>Output member options (OUTMBR)</h3>
|
|
<p>Specifies the name of the database file member to which the output is directed when OUTPUT(*OUTFILE) is specified.
|
|
</p>
|
|
<p><b>Element 1: Member to receive output</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*FIRST</u></b></dt>
|
|
<dd>The first member in the file receives the output. If this value is specified and the member does not exist, the system creates a member with the name of the file specified on the OUTFILE parameter.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the file member that is to receive the output. If a member name is specified and the member does not exist, the system creates it.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Replace or add records</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*REPLACE</u></b></dt>
|
|
<dd>The existing records in the specified database file member are replaced by the new records.
|
|
</dd>
|
|
<dt><b>*ADD</b></dt>
|
|
<dd>The system adds the new records at the end of the existing member.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPTAPCTG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="DSPTAPCTG.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Displaying the Tape Cartridges in the *SHARE400 Category</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
DSPTAPCTG DEV(LIB01) CGY(*SHARE400) OUTPUT(*)
|
|
</pre>
|
|
</p>
|
|
<p>This command displays the attributes of all tape cartridges in the *SHARE400 category on the work station display.
|
|
</p>
|
|
<p><b>Example 2: Displaying the Tape Cartridge for VOL3</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
DSPTAPCTG DEV(LIB01) CTG(VOL3) OUTPUT(*) CGY(*ALL)
|
|
</pre>
|
|
</p>
|
|
<p>This command displays the attributes of the cartridge identifier VOL3.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPTAPCTG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="DSPTAPCTG.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>CPF67E6</b></dt>
|
|
<dd>Volume &2 is not correct
|
|
</dd>
|
|
<dt><b>CPF67EA</b></dt>
|
|
<dd>Function not successful
|
|
</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>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="#DSPTAPCTG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|