ibm-information-center/dist/eclipse/plugins/i5OS.ic.apis_5.4.0.1/qtardcap.htm

1893 lines
60 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">
<meta name="Copyright" content="Copyright (c) 2006 by IBM Corporation">
<title>Retrieve Device Capabilities (QTARDCAP) API</title>
<!-- Begin Header Records =========================================== -->
<!-- All rights reserved. Licensed Materials Property of IBM -->
<!-- US Government Users Restricted Rights -->
<!-- Use, duplication or disclosure restricted by -->
<!-- GSA ADP Schedule Contract with IBM Corp. -->
<!-- Change History: -->
<!-- YYMMDD Userid : Description of the change -->
<!-- 040322 jkochan : DCR 99794 Add virtual tape information -->
<!-- 040630 dwenzel : DCR 99880 Add WORM information -->
<!-- BACKMST SCRIPT A converted by B2H R4.1 (346) (CMS) by v2kea304 at -->
<!-- RCHVMW2 on 26 April 1999 at 10:21:58 -->
<!-- File cleanup completed Jan 2002 by v2cdijab -->
<!-- End Header Records -->
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
</head>
<body>
<!-- Java sync-link -->
<script type="text/javascript" language="Javascript" src="../rzahg/synch.js">
</script>
<a name="Top_Of_Page"></a>
<h2>Retrieve Device Capabilities (QTARDCAP) API</h2>
<div class="box" style="width: 80%;">
&nbsp;&nbsp;Required Parameter Group:<br>
<!-- iddvc RMBR -->
<br>
<table width="100%">
<tr>
<td align="center" valign="top" width="10%">1</td>
<td align="left" valign="top" width="50%">Receiver variable</td>
<td align="left" valign="top" width="20%">Output</td>
<td align="left" valign="top" width="20%">Char(*)</td>
</tr>
<tr>
<td align="center" valign="top">2</td>
<td align="left" valign="top">Length of receiver variable</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Binary(4)</td>
</tr>
<tr>
<td align="center" valign="top">3</td>
<td align="left" valign="top">Format name</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Char(8)</td>
</tr>
<tr>
<td align="center" valign="top">4</td>
<td align="left" valign="top">Device description or resource name</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Char(10)</td>
</tr>
<tr>
<td align="center" valign="top">5</td>
<td align="left" valign="top">Device description or resource indicator</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Char(10)</td>
</tr>
<tr>
<td align="center" valign="top">6</td>
<td align="left" valign="top">Resources to list</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Char(1)</td>
</tr>
<tr>
<td align="center" valign="top">7</td>
<td align="left" valign="top">Error code</td>
<td align="left" valign="top">I/O</td>
<td align="left" valign="top">Char(*)</td>
</tr>
</table>
<br>
&nbsp;&nbsp;Default Public Authority: *USE<br>
<!-- iddvc RMBR -->
<br>
&nbsp;&nbsp;Threadsafe: No<br>
<!-- iddvc RMBR -->
<br>
</div>
<p>The Retrieve Device Capabilities (QTARDCAP) API retrieves information that
is associated with a specified tape device description or tape resource name.
The resource that is specified or associated with the specified device
description must currently exist on the system.</p>
<p>The QTARDCAP API currently supports the following device types:</p>
<ul>
<li>Tape (TAP) devices</li>
<li>Tape media library (TAPMLB) devices</li>
</ul>
<br>
<h3>Authorities and Locks</h3>
<dl>
<dt><em>Device Description Authority</em></dt>
<dd><img src="delta.gif" alt="Start of change">*USE
<img src="deltaend.gif" alt="End of change"></dd>
</dl>
<br>
<h3>Required Parameter Group</h3>
<dl>
<dt><strong>Receiver variable</strong></dt>
<dd>OUTPUT; CHAR(*)
<p>The receiver variable that receives the information requested. You can
specify the size of the area to be smaller than the format requested as long as
you specify the length parameter correctly. As a result, the API returns only
the data that the area can hold.</p>
</dd>
<dt><strong>Length of receiver variable</strong></dt>
<dd>INPUT; BINARY(4)
<p>The length of the receiver variable provided. The length of receiver
variable parameter may be specified up to the size of the receiver variable
specified in the user program. If the length of receiver variable parameter
specified is larger than the allocated size of the receiver variable specified
in the user program, the results are not predictable. The minimum length is 8
bytes.</p>
</dd>
<dt><strong>Format name</strong></dt>
<dd>INPUT; CHAR(8)
<p>The content and format of the information being returned. The TAPE0100
format must be used for the tape device capabilities information. See <a href=
"#HDRTAPE100">TAPE0100 Format</a> to view the information returned for this
format.</p>
</dd>
<dt><strong>Device description or resource name</strong></dt>
<dd>INPUT; CHAR(10)
<p>The name of the device description or resource for which the data is
returned.</p>
</dd>
<dt><strong>Device description or resource indicator</strong></dt>
<dd>INPUT; CHAR(10)
<p>Whether the name specified is a device description or a resource name. The
possible values follow:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*DEVD</em></td>
<td align="left" valign="top">The name specified is a device description.</td>
</tr><tr>
<td align="left" valign="top"><em>*RSRC</em></td>
<td align="left" valign="top">The name specified is a resource name.</td>
</tr></table>
<br>
</dd>
<dt><strong>Resources to list</strong></dt>
<dd>INPUT; CHAR(1)
<p>Which media library device resources are listed if the device description
indicator in the device description or resource indicator parameter is *DEVD.
This parameter is blank if the device requested is not a media library device
description. If a media library device description is specified, the possible
values are as follows:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">All resources are listed (*ALL).</td>
</tr><tr>
<td align="left" valign="top"><em>2</em></td>
<td align="left" valign="top">Allocated resources are listed (*ALLOCATED).</td>
</tr><tr>
<td align="left" valign="top"><em>3</em></td>
<td align="left" valign="top">Unprotected resources are listed (*UNPROTECTED).</td>
</tr><tr>
<td align="left" valign="top"><em>4</em></td>
<td align="left" valign="top">Deallocated resources are listed (*DEALLOCATED).</td>
</tr><tr>
<td align="left" valign="top"><em>5</em></td>
<td align="left" valign="top">Both allocated and unprotected resources are listed (*AVAILABLE).</td>
</tr><tr>
<td align="left" valign="top"><em>blank</em></td>
<td align="left" valign="top">The requested input device or resource is not a media library device, not a
device description, or the information is not requested.</td>
</tr></table>
<br>
</dd>
<dt><strong>Error code</strong></dt>
<dd>I/O; CHAR(*)
<p>The structure in which to return error information. For the format of the
structure, see <a href="../apiref/error.htm#hdrerrcod">Error Code Parameter</a>.</p>
</dd>
</dl>
<br>
<h3><a name="HDRTAPE100">TAPE0100 Format</a></h3>
<p>The following table shows the information that is returned for the TAPE0100
format. For more details about the fields in the following table, see <a href=
"#HDRFLDXX">Field Descriptions</a>.</p>
<table border width="80%">
<tr>
<th align="center" valign="bottom" colspan="2">Offset</th>
<th align="left" valign="bottom" rowspan="2">Type</th>
<th align="left" valign="bottom" rowspan="2">Field</th>
</tr>
<tr>
<th align="center" valign="bottom">Dec</th>
<th align="center" valign="bottom">Hex</th>
</tr>
<tr>
<td align="center" valign="top" width="10%">0</td>
<td align="center" valign="top" width="10%">0</td>
<td align="left" valign="top" width="20%">BINARY(4)</td>
<td align="left" valign="top" width="60%">Bytes returned</td>
</tr>
<tr>
<td align="center" valign="top">4</td>
<td align="center" valign="top">4</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Bytes available</td>
</tr>
<tr>
<td align="center" valign="top">8</td>
<td align="center" valign="top">8</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Device description or resource name</td>
</tr>
<tr>
<td align="center" valign="top">18</td>
<td align="center" valign="top">12</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Device description or resource indicator</td>
</tr>
<tr>
<td align="center" valign="top">28</td>
<td align="center" valign="top">1C</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Device resource name</td>
</tr>
<tr>
<td align="center" valign="top">38</td>
<td align="center" valign="top">26</td>
<td align="left" valign="top">CHAR(3)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">41</td>
<td align="center" valign="top">29</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Device relationship to media library device</td>
</tr>
<tr>
<td align="center" valign="top">42</td>
<td align="center" valign="top">2A</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Type of media library device</td>
</tr>
<tr>
<td align="center" valign="top">43</td>
<td align="center" valign="top">2B</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Self-configured tape device</td>
</tr>
<tr>
<td align="center" valign="top">44</td>
<td align="center" valign="top">2C</td>
<td align="left" valign="top">CHAR(4)</td>
<td align="left" valign="top">Device type</td>
</tr>
<tr>
<td align="center" valign="top">48</td>
<td align="center" valign="top">30</td>
<td align="left" valign="top">CHAR(4)</td>
<td align="left" valign="top">Device model</td>
</tr>
<tr>
<td align="center" valign="top">52</td>
<td align="center" valign="top">34</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Maximum block size</td>
</tr>
<tr>
<td align="center" valign="top">56</td>
<td align="center" valign="top">38</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Logical-block-ID capability</td>
</tr>
<tr>
<td align="center" valign="top">57</td>
<td align="center" valign="top">39</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Assign capability</td>
</tr>
<tr>
<td align="center" valign="top">58</td>
<td align="center" valign="top">3A</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Overwrite capability</td>
</tr>
<tr>
<td align="center" valign="top">59</td>
<td align="center" valign="top">3B</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Read-backward capability</td>
</tr>
<tr>
<td align="center" valign="top">60</td>
<td align="center" valign="top">3C</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Cartridge-checking capability</td>
</tr>
<tr>
<td align="center" valign="top">61</td>
<td align="center" valign="top">3D</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Device class</td>
</tr>
<tr>
<td align="center" valign="top">62</td>
<td align="center" valign="top">3E</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Hardware data compression capability</td>
</tr>
<tr>
<td align="center" valign="top">63</td>
<td align="center" valign="top">3F</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Label compaction supported</td>
</tr>
<tr>
<td align="center" valign="top">64</td>
<td align="center" valign="top">40</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Offset to supported write densities</td>
</tr>
<tr>
<td align="center" valign="top">68</td>
<td align="center" valign="top">44</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Number of supported write densities</td>
</tr>
<tr>
<td align="center" valign="top">72</td>
<td align="center" valign="top">48</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Offset to supported read densities</td>
</tr>
<tr>
<td align="center" valign="top">76</td>
<td align="center" valign="top">4C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Number of supported read densities</td>
</tr>
<tr>
<td align="center" valign="top">80</td>
<td align="center" valign="top">50</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Offset to supported
improved-data-recording-capability (IDRC) densities</td>
</tr>
<tr>
<td align="center" valign="top">84</td>
<td align="center" valign="top">54</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Number of supported
improved-data-recording-capability (IDRC) densities</td>
</tr>
<tr>
<td align="center" valign="top">88</td>
<td align="center" valign="top">58</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Optimum block size</td>
</tr>
<tr>
<td align="center" valign="top">92</td>
<td align="center" valign="top">5C</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Space to end of data</td>
</tr>
<tr>
<td align="center" valign="top">93</td>
<td align="center" valign="top">5D</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Space backward allowed</td>
</tr>
<tr>
<td align="center" valign="top">94</td>
<td align="center" valign="top">5E</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Media library device with bar-code scanner</td>
</tr>
<tr>
<td align="center" valign="top">95</td>
<td align="center" valign="top">5F</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Improved-data-recording-capability (IDRC)
supported<br>
</td>
</tr>
<tr>
<td align="center" valign="top">96</td>
<td align="center" valign="top">60</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Automatic cartridge mechanism supported</td>
</tr>
<tr>
<td align="center" valign="top">97</td>
<td align="center" valign="top">61</td>
<td align="left" valign="top">CHAR(2)</td>
<td align="left" valign="top">Bit mapping of all supported
improved-data-recording-capability (IDRC) densities</td>
</tr>
<tr>
<td align="center" valign="top">99</td>
<td align="center" valign="top">63</td>
<td align="left" valign="top">CHAR(2)</td>
<td align="left" valign="top">Bit mapping of all supported write densities</td>
</tr>
<tr>
<td align="center" valign="top">101</td>
<td align="center" valign="top">65</td>
<td align="left" valign="top">CHAR(2)</td>
<td align="left" valign="top">Bit mapping of all supported read densities</td>
</tr>
<tr>
<td align="center" valign="top">103</td>
<td align="center" valign="top">67</td>
<td align="left" valign="top">CHAR(2)</td>
<td align="left" valign="top">Bit mapping of the highest supported density</td>
</tr>
<tr>
<td align="center" valign="top">105</td>
<td align="center" valign="top">69</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">106</td>
<td align="center" valign="top">6A</td>
<td align="left" valign="top">CHAR(2)</td>
<td align="left" valign="top">Bit mapping of all supported character
densities</td>
</tr>
<tr>
<td align="center" valign="top">108</td>
<td align="center" valign="top">6C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Offset to supported character densities</td>
</tr>
<tr>
<td align="center" valign="top">112</td>
<td align="center" valign="top">70</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Number of supported character densities</td>
</tr>
<tr>
<td align="center" valign="top">116</td>
<td align="center" valign="top">74</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Offset to resource list</td>
</tr>
<tr>
<td align="center" valign="top">120</td>
<td align="center" valign="top">78</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Number of resources in resource list</td>
</tr>
<tr>
<td align="center" valign="top">124</td>
<td align="center" valign="top">7C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Offset to resource status list</td>
</tr>
<tr>
<td align="center" valign="top">128</td>
<td align="center" valign="top">80</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Number of resource status list entries</td>
</tr>
<tr>
<td align="center" valign="top">132</td>
<td align="center" valign="top">84</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">133</td>
<td align="center" valign="top">85</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">QTACTLDV API supported</td>
</tr>
<tr>
<td align="center" valign="top">134</td>
<td align="center" valign="top">86</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Media library device with door</td>
</tr>
<tr>
<td align="center" valign="top"><img src="delta.gif" alt="Start of change">135</td>
<td align="center" valign="top">87</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Write-once-read-many (WORM) support</td>
</tr>
<tr>
<td align="center" valign="top">136</td>
<td align="center" valign="top">88</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Virtual device</td>
</tr>
<tr>
<td align="center" valign="top">137</td>
<td align="center" valign="top">89</td>
<td align="left" valign="top">CHAR(3)</td>
<td align="left" valign="top">Reserved<img src="deltaend.gif" alt="End of change"></td>
</tr>
<tr>
<td align="center" valign="top">140</td>
<td align="center" valign="top">8C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Offset to density capability entries</td>
</tr>
<tr>
<td align="center" valign="top">144</td>
<td align="center" valign="top">90</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Number of density capability entries</td>
</tr>
<tr>
<td align="center" valign="top">148</td>
<td align="center" valign="top">94</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Length of density capability entries</td>
</tr>
<tr>
<td align="center" valign="top">152</td>
<td align="center" valign="top">98</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Offset to system feature codes</td>
</tr>
<tr>
<td align="center" valign="top">156</td>
<td align="center" valign="top">9C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Length of system feature codes</td>
</tr>
<tr>
<td align="center" valign="top">160</td>
<td align="center" valign="top">A0</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Acceptable read error thresholds</td>
</tr>
<tr>
<td align="center" valign="top">164</td>
<td align="center" valign="top">A4</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Acceptable write error thresholds</td>
</tr>
<tr>
<td align="center" valign="top">168</td>
<td align="center" valign="top">A8</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Instantaneous performance</td>
</tr>
<tr>
<td align="center" valign="top">172</td>
<td align="center" valign="top">AC</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Offset to slot and station information</td>
</tr>
<tr>
<td align="center" valign="top">176</td>
<td align="center" valign="top">B0</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Offset to device text</td>
</tr>
<tr>
<td align="center" valign="top">180</td>
<td align="center" valign="top">B4</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Length of device text</td>
</tr>
<tr>
<td align="center" valign="top"><img src="delta.gif" alt="Start of change">184</td>
<td align="center" valign="top">B8</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Offset to supported write-once-read-many (WORM) densities</td>
</tr>
<tr>
<td align="center" valign="top">188</td>
<td align="center" valign="top">BC</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Number of supported write-once-read-many (WORM) densities<img src="deltaend.gif" alt="End of change"></td>
</tr>
<tr>
<td align="center" valign="top">&nbsp;</td>
<td align="center" valign="top">&nbsp;</td>
<td align="left" valign="top">ARRAY(*) of CHAR(10)</td>
<td align="left" valign="top">Supported improved-data-recording-capability
(IDRC) densities</td>
</tr>
<tr>
<td align="center" valign="top">&nbsp;</td>
<td align="center" valign="top">&nbsp;</td>
<td align="left" valign="top">ARRAY(*) of CHAR(10)</td>
<td align="left" valign="top">Supported write densities</td>
</tr>
<tr>
<td align="center" valign="top">&nbsp;</td>
<td align="center" valign="top">&nbsp;</td>
<td align="left" valign="top">ARRAY(*) of CHAR(10)</td>
<td align="left" valign="top">Supported read densities</td>
</tr>
<tr>
<td align="center" valign="top">&nbsp;</td>
<td align="center" valign="top">&nbsp;</td>
<td align="left" valign="top">ARRAY(*) of CHAR(10)</td>
<td align="left" valign="top">Supported character densities</td>
</tr>
<tr>
<td align="center" valign="top">&nbsp;</td>
<td align="center" valign="top">&nbsp;</td>
<td align="left" valign="top">ARRAY(*) of CHAR(10)</td>
<td align="left" valign="top">Resource list</td>
</tr>
<tr>
<td align="center" valign="top">&nbsp;</td>
<td align="center" valign="top">&nbsp;</td>
<td align="left" valign="top">ARRAY(*) of CHAR(15)</td>
<td align="left" valign="top">Resource status list</td>
</tr>
<tr>
<td align="center" valign="top">&nbsp;</td>
<td align="center" valign="top">&nbsp;</td>
<td align="left" valign="top">ARRAY(*) of CHAR(*)</td>
<td align="left" valign="top">Density capability entries</td>
</tr>
<tr>
<td align="center" valign="top">&nbsp;</td>
<td align="center" valign="top">&nbsp;</td>
<td align="left" valign="top">CHAR(*)</td>
<td align="left" valign="top">System feature codes</td>
</tr>
<tr>
<td align="center" valign="top">&nbsp;</td>
<td align="center" valign="top">&nbsp;</td>
<td align="left" valign="top">CHAR(*)</td>
<td align="left" valign="top">Device text</td>
</tr>
<tr>
<td align="center" valign="top">&nbsp;</td>
<td align="center" valign="top">&nbsp;</td>
<td align="left" valign="top">CHAR(*)</td>
<td align="left" valign="top">Slot and station information</td>
</tr>
<tr>
<td align="center" valign="top"><img src="delta.gif" alt="Start of change">&nbsp;</td>
<td align="center" valign="top">&nbsp;</td>
<td align="left" valign="top">ARRAY(*) of CHAR(10)</td>
<td align="left" valign="top">Supported write-once-read-many (WORM) densities<img src="deltaend.gif" alt="End of change"></td>
</tr>
</table>
<br>
<br>
<h3><a name="HDRFLDXX">Field Descriptions</a></h3>
<p><strong>Acceptable read error thresholds.</strong> The average minimum
number of kilobytes (1KB = 1000 bytes) read between recovered read errors for
the media to be considered acceptable. This information is to determine the
reliability of a volume based on the number of errors that the device is
reporting against that tape volume. This field is zero for devices that do not
report this information.</p>
<p><strong>Acceptable write error thresholds.</strong> The average minimum
number of kilobytes (1KB = 1000 bytes) written between recovered write errors
for the media to be considered acceptable. This information is to determine the
reliability of a volume based on the number of errors that the device is
reporting against that tape volume. This field is zero for devices that do not
report this information.</p>
<p><strong>Automatic cartridge mechanism supported.</strong> Whether the device
has an automatic cartridge mechanism (loader or facility) known as an ACL (that
is, 3490 type stand alone devices typically have an ACL) or an ACF (that is,
3590 B11 devices have an ACF). Possible values follow:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">The device does not have an automatic cartridge
mechanism.</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">The device does have an automatic cartridge
mechanism.</td>
</tr>
<tr>
<td align="left" valign="top"><em>blank</em></td>
<td align="left" valign="top">This field is not valid for a media library
device.</td>
</tr>
</table>
<p><strong>Assign capability.</strong> Whether the specified device or resource
has the capability to assign (reserve) a device to the system. This concept
ensures that no other system can use the device because the system could not be
successfully assigned (reserved) from the device. This feature fully enables
devices that can be shared. Possible values follow:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">The system cannot assign the device.</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">The system can assign the device.</td>
</tr>
<tr>
<td align="left" valign="top"><em>blank</em></td>
<td align="left" valign="top">This is not an available value for a media
library device.</td>
</tr>
</table>
<p><strong>Bit mapping of all supported character densities.</strong> A
bit-mapped encoding of densities that correspond to the supported character
densities. This field is not available for a media library device. Bit mappings
are defined on the device level and may not match the following examples.</p>
<p>The following are the supported i5/OS densities and their corresponding
bit-map representations for each device class. Note that self-configured tape
devices do not follow these i5/OS bit-map representations but are defined in
the device specifications. Values for the device class of 1/4-inch cartridge
technology follow:</p>
<table cellpadding="5" width="50%">
<!-- cols="15 85" -->
<tr>
<th align="left" valign="bottom">Hexadecimal<br>
Bit Map</th>
<th align="left" valign="bottom">Density or Format</th>
</tr>
<tr>
<td align="left" valign="top"><em>'4000'x</em></td>
<td align="left" valign="top">*QIC24 (8000 bpi)</td>
</tr>
<tr>
<td align="left" valign="top"><em>'2000'x</em></td>
<td align="left" valign="top">*QIC120 (10000 bpi)</td>
</tr>
<tr>
<td align="left" valign="top"><em>'0800'x</em></td>
<td align="left" valign="top">*QIC525 (16000 bpi)</td>
</tr>
<tr>
<td align="left" valign="top"><em>'0400'x</em></td>
<td align="left" valign="top">*QIC1000</td>
</tr>
<tr>
<td align="left" valign="top"><em>'0200'x</em></td>
<td align="left" valign="top">*QIC2GB</td>
</tr>
<tr>
<td align="left" valign="top"><em>'0100'x</em></td>
<td align="left" valign="top">*QIC3040</td>
</tr>
<tr>
<td align="left" valign="top"><em>'0080'x</em></td>
<td align="left" valign="top">*QIC5010</td>
</tr>
</table>
<p>Values for the device class of 1/2-inch cartridge technology follow:</p>
<table cellpadding="5" width="50%">
<!-- cols="15 85" -->
<tr>
<th align="left" valign="bottom">Hexadecimal<br>
Bit Map</th>
<th align="left" valign="bottom">Density or Format</th>
</tr>
<tr>
<td align="left" valign="top"><em>'8000'x</em></td>
<td align="left" valign="top">*FMT3480 (38000 bpi)</td>
</tr>
<tr>
<td align="left" valign="top"><em>'4000'x</em></td>
<td align="left" valign="top">*FMT3490E</td>
</tr>
<tr>
<td align="left" valign="top"><em>'2000'x</em></td>
<td align="left" valign="top">*FMT3590</td>
</tr>
<tr>
<td align="left" valign="top"><em>'0800'x</em></td>
<td align="left" valign="top">*FMT3570</td>
</tr>
<tr>
<td align="left" valign="top"><em>'0400'x</em></td>
<td align="left" valign="top">*FMT3570E</td>
</tr>
</table>
<p>Values for the device class of 1/2-inch reel technology follow:</p>
<table cellpadding="5" width="50%">
<!-- cols="15 85" -->
<tr>
<th align="left" valign="bottom">Hexadecimal<br>
Bit Map</th>
<th align="left" valign="bottom">Density or Format</th>
</tr>
<tr>
<td align="left" valign="top"><em>'8000'x</em></td>
<td align="left" valign="top">1600 bpi</td>
</tr>
<tr>
<td align="left" valign="top"><em>'4000'x</em></td>
<td align="left" valign="top">3200 bpi</td>
</tr>
<tr>
<td align="left" valign="top"><em>'2000'x</em></td>
<td align="left" valign="top">6250 bpi</td>
</tr>
</table>
<p>Values for the device class of 8-mm cartridge technology follow:</p>
<table cellpadding="5" width="50%">
<!-- cols="15 85" -->
<tr>
<th align="left" valign="bottom">Hexadecimal<br>
Bit Map</th>
<th align="left" valign="bottom">Density or Format</th>
</tr>
<tr>
<td align="left" valign="top"><em>'8000'x</em></td>
<td align="left" valign="top">*FMT2GB</td>
</tr>
<tr>
<td align="left" valign="top"><em>'4000'x</em></td>
<td align="left" valign="top">*FMT5GB</td>
</tr>
<tr>
<td align="left" valign="top"><em>'2000'x</em></td>
<td align="left" valign="top">*FMT7GB</td>
</tr>
</table>
<p><strong>Bit mapping of highest supported output density.</strong> A
bit-mapped encoding of the highest supported output density on the device. This
field is not available for a media library device. The definition of example
bit maps can be found in the bit mapping of all supported character densities
field.</p>
<p><strong>Bit mapping of all supported improved-data-recording-capability
(IDRC) densities.</strong> A bit-mapped encoding of densities that correspond
to the supported IDRC densities. This field is not available for a media
library device. The definition of example bit maps can be found in the bit
mapping of all supported character densities field.</p>
<p><strong>Bit mapping of all supported read densities.</strong> A bit-mapped
encoding of densities that correspond to the supported read densities. This
field is not available for a media library device. The definition of example
bit maps can be found in the bit mapping of all supported character densities
field.</p>
<p><strong>Bit mapping of all supported write densities.</strong> A bit-mapped
encoding of densities that correspond to the supported write densities. This
field is not available for a media library device. The definition of example
bit maps can be found in the bit mapping of all supported character densities
field.</p>
<p><strong>Bytes available.</strong> The number of bytes of data available to
be returned. All available data is returned if enough space is provided.</p>
<p><strong>Bytes returned.</strong> The number of bytes of data returned.</p>
<p><strong>Cartridge-checking capability.</strong> Whether the device
communicates valid cartridge densities or formats. This capability allows
i5/OS to verify cartridge density or formats. Devices that do not support this
capability cannot send intelligent messages about the cartridge. When the
device is unable to write to the cartridge, a generic error message usually
results. It could be as simple as a cartridge not supported by the device.
Possible values follow:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">No device or resource that is requested has
special cartridge-density checking capabilities.</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">The device requested has special
cartridge-density checking capabilities.</td>
</tr>
<tr>
<td align="left" valign="top"><em>blank</em></td>
<td align="left" valign="top">This is not an available value for a media
library device.</td>
</tr>
</table>
<p><strong>Device class.</strong> The class of the device. Possible values
follow:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">1/2-inch reel technology</td>
</tr>
<tr>
<td align="left" valign="top"><em>2</em></td>
<td align="left" valign="top">1/2-inch cartridge technology</td>
</tr>
<tr>
<td align="left" valign="top"><em>3</em></td>
<td align="left" valign="top">1/4-inch cartridge technology</td>
</tr>
<tr>
<td align="left" valign="top"><em>4</em></td>
<td align="left" valign="top">8-mm technology</td>
</tr>
<tr>
<td align="left" valign="top"><em>blank</em></td>
<td align="left" valign="top">None of the above technologies or media library
device</td>
</tr>
</table>
<p><strong>Density capability entries.</strong> The list of density
capabilities based on density, format, or both. Each entry consists of the
following format and has a length that is specified in the length of density
capability entry field.</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>CHAR(10)</em></td>
<td align="left" valign="top">Density or format</td>
</tr>
<tr>
<td align="left" valign="top"><em>CHAR(2)</em></td>
<td align="left" valign="top">Bit map representation of density</td>
</tr>
<tr>
<td align="left" valign="top" nowrap><em>BINARY(4)</em></td>
<td align="left" valign="top">Instantaneous performance in megabytes per second
for this density or format. One MB per second is returned for each field if the
performance number is not reported by the device.</td>
</tr>
<tr>
<td align="left" valign="top"><em>BINARY(4)</em></td>
<td align="left" valign="top">Maximum block size for this density or
format.</td>
</tr>
<tr>
<td align="left" valign="top"><em>BINARY(4)</em></td>
<td align="left" valign="top">Optimum block size for this density or
format.</td>
</tr>
</table>
<p>This format is repeated once for each density or format that is supported by
the device. The number of entries in the array is specified in the number of
density capability entries field. This field is not available for a media
library device.</p>
<p><strong>Device description or resource indicator.</strong> Whether the
information is retrieved for a device description or a device resource name.
This field is left-justified. Possible values follow:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*DEVD</em></td>
<td align="left" valign="top">The name specified is a device description.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*RSRC</em></td>
<td align="left" valign="top">The name specified is a device resource
name.</td>
</tr>
</table>
<p><strong>Device description or resource name.</strong> The device description
or resource name of the device.</p>
<p><strong>Device relationship to media library device.</strong> The
relationship of the device or resource to the media library device. Possible
values follow:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">The device is not a media library resource.</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">The device is a tape resource in a media library
resource.</td>
</tr>
<tr>
<td align="left" valign="top"><em>2</em></td>
<td align="left" valign="top">The device is a media library resource.</td>
</tr>
</table>
<p><strong>Device model.</strong> The device model number.</p>
<p><strong>Device resource name.</strong> The resource name if the device
information is for a device description.</p>
<p><strong>Device text.</strong> The specific text that is reported by the
device.</p>
<p><strong>Device type.</strong> The device type number.</p>
<p><strong>Hardware data compression capability.</strong> Whether hardware data
compression (HDC) is supported. This field corresponds to the data compression
(DTACPR) parameter on save commands. Possible values follow:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">No device or resource that is requested has
hardware data compression capabilities.</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">The device that is requested has hardware data
compression capabilities.</td>
</tr>
<tr>
<td align="left" valign="top"><em>blank</em></td>
<td align="left" valign="top">This is not an available value for a media
library device.</td>
</tr>
</table>
<p><strong>Improved-data-recording-capability (IDRC) supported.</strong>
Whether the device supports IDRC (or compaction) at any density. If IDRC is
supported, see the supported IDRC densities field. Possible values follow:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">No device or resource that is requested has IDRC
capabilities.</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">The device that is requested has IDRC
capabilities.</td>
</tr>
<tr>
<td align="left" valign="top"><em>blank</em></td>
<td align="left" valign="top">This is not an available value for a media
library device.</td>
</tr>
</table>
<p><strong>Instantaneous performance.</strong> The highest instantaneous
performance that is reported by the device. This value can be obtained from the
density capability entries list on a density, format, or both. This value is
the highest performance number that is specified in the density capability
entries list. The value is in megabytes per second. If the device does not
report this value, a value of 1 MB per second will be used. This is not an
available value for a media library device and is set to zero for media library
devices.</p>
<p><strong>Label compaction supported.</strong> Whether the device volumes are
written with compacted labels. Possible values follow:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">The device does not generate labels with
compaction.</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">The device generates labels with compaction if
compaction is requested.</td>
</tr>
</table>
<p><strong>Length of density capability entry.</strong> The length, in bytes,
of each entry in the density capability entries list. This field should be used
in stepping through the array of density capability entries. Additional fields
for each density or format in the density capability entries list may be added
at any time.</p>
<p><strong>Length of device text.</strong> The length, in bytes, of text that
is reported by the device. If the device does not report specific text about
the device, zero is returned.</p>
<p><strong>Length of system feature codes.</strong> The length, in bytes, of
the system feature codes entry. This field should be used in determining the
system feature codes (type and model) of the device. If the device does not
report this information, zero is returned.</p>
<p><strong>Logical-block-ID capability.</strong> Whether the device allows fast
access capabilities. This allows logical-block-identifier support through a
tape management system that is registered with the registration facility and
used in combination with the Media and Storage Extensions feature of i5/OS.
Possible values follow:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">No device or resource that is requested has fast
access by logical-block-identifier capabilities.</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">The device that is requested has fast access by
logical-block-identifier capabilities.</td>
</tr>
<tr>
<td align="left" valign="top"><em>blank</em></td>
<td align="left" valign="top">This is not an available value for a media
library device.</td>
</tr>
</table>
<p><strong>Maximum block size.</strong> The highest maximum block size that is
supported by the device. If you use the maximum block size, tapes may be
created that are not compatible with other device types. A tape that is created
with a maximum block size can only be duplicated with the Duplicate Tape
(DUPTAP) command to devices that support the same block size. This field is not
available for a media library device and is set to zero for media library
devices.</p>
<p>The maximum block size that a device supports may vary with density. Use the
Density capability entries to determine the maximum block size for a specific
density.</p>
<p><strong>Media library device with bar-code scanner.</strong> Whether the
device has a bar-code scanner, which is for a media library device. Possible
values follow:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">The device has no bar-code scanner.</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">The device has a bar-code scanner.</td>
</tr>
<tr>
<td align="left" valign="top"><em>blank</em></td>
<td align="left" valign="top">This field is only valid for a media library
device.</td>
</tr>
</table>
<p><strong>Media library device with door.</strong> Whether the media library
device has a door that can be opened. Possible values follow:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">The device does not have a door.</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">The device has a door.</td>
</tr>
<tr>
<td align="left" valign="top"><em>blank</em></td>
<td align="left" valign="top">This field is only valid for a media library
device.</td>
</tr>
</table>
<p><strong>Number of density capability entries.</strong> The number of density
capability entries in the density capability entries list. This field is not
available for a media library device and is set to zero when the input device
is a media library device.</p>
<p><strong>Number of resources in resource list.</strong> The number of
resources that are listed in the resource list. This number is set to zero when
the input device is not a media library device description (*DEVD).</p>
<p><strong>Number of resource status list entries.</strong> The number of
resource status entries for the resource status list. This number is set to
zero when the input device is not a media library device description
(*DEVD).</p>
<p><strong>Number of supported improved-data-recording-capability (IDRC)
densities.</strong> The number of supported IDRC (or compaction) densities that
are specified in the supported IDRC densities field. This field is not
available for a media library device and is set to zero when the input device
is a media library device.</p>
<p><strong>Number of supported character densities.</strong> The number of
supported character densities that are specified in the supported character
densities field. This field is not available for a media library device and is
set to zero when the input device is a media library device.</p>
<p><strong>Number of supported read densities.</strong> The number of supported
read densities that are specified in the supported read densities field. This
field is not available for a media library device and is set to zero when the
input device is a media library device.</p>
<p><strong>Number of supported write densities.</strong> The number of
supported write densities that are specified in the supported write densities
field. This field is not available for a media library device and is set to
zero when the input device is a media library device.</p>
<p><img src="delta.gif" alt="Start of change"><strong>Number of supported
write-once-read-many (WORM) densities.</strong> The number of
supported WORM densities that are returned in the supported WORM densities
array. This field is not available for a media library device and is set to
zero when the input device is a media library device. This field will be set
to sero if the device does not report WORM density information.
<img src="deltaend.gif" alt="End of change"></p>
<p><strong>Offset to density capability entries.</strong> The offset, in bytes,
to the density capability entries list.</p>
<p><strong>Offset to device text.</strong> The offset, in bytes, to the text
that is reported by the device.</p>
<p><strong>Offset to resource list.</strong> The offset, in bytes, to the
resource list.</p>
<p><strong>Offset to resource status list.</strong> The offset, in bytes, to
the resource status list field.</p>
<p><strong>Offset to slot and station information.</strong> The offset, in
bytes, to the slot and station information field.</p>
<p><strong>Offset to supported character densities.</strong> The offset, in
bytes, to the supported character densities field.</p>
<p><strong>Offset to supported improved-data-recording-capabilities (IDRC)
densities.</strong> The offset, in bytes, to the supported
improved-data-recording-capabilities (IDRC) densities field.</p>
<p><strong>Offset to supported read densities.</strong> The offset, in bytes,
to the supported read densities field.</p>
<p><strong>Offset to supported write densities.</strong> The offset, in bytes,
to the supported write densities field.</p>
<p><img src="delta.gif" alt="Start of change"><strong>Offset to supported
write-once-read-many (WORM) densities.</strong> The offset, in bytes,
to the supported WORM densities array.
<img src="deltaend.gif" alt="End of change"></p>
<p><strong>Offset to system feature codes.</strong> The offset, in bytes, to
the system feature codes (types and models) of the device.</p>
<p><strong>Optimum block size.</strong> The highest optimum block size
supported by the device.</p>
<p>When USEOPTBLK(*YES) is specified as a parameter for a save operation,
performance may be improved. The USEOPTBLK(*YES) parameter may cause tapes to
be created that are not compatible with other device types. That is, a tape
that is created with an optimum block size can only be duplicated with the
Duplicate Tape (DUPTAP) command to devices that support the same block size.
This field is not available for a media library device and is set to zero for
media library devices.</p>
<p>The optimum block size that a device supports may vary with density. Use the
Density capability entries to determine the optimum block size for a specific
density.</p>
<p><strong>Overwrite capability.</strong> Whether the device or resource that
is specified has overwriting capabilities. This capability refers to being able
to write a data file over an existing data file sequence on a tape volume. Some
technologies only allow appending data to the end of tape or writing files to
the beginning of tape. Possible values follow:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">No device or resource that is requested has
overwrite capabilities.</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">The device that is requested has overwrite
capabilities.</td>
</tr>
<tr>
<td align="left" valign="top"><em>blank</em></td>
<td align="left" valign="top">This is not an available value for a media
library device.</td>
</tr>
</table>
<p><strong>QTACTLDV API supported.</strong> Whether the QTACTLDV API is
supported for the device or resource that is specified. Possible values
follow:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">QTACTLDV API is not supported.</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">QTACTLDV API is supported.</td>
</tr>
</table>
<p><strong>Read-backward capability.</strong> Whether the device or resource
that is specified has read-backward capabilities. Possible values follow:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">No device or resource that is requested has
read-backward capabilities.</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">The device that is requested has read-backward
capabilities.</td>
</tr>
<tr>
<td align="left" valign="top"><em>blank</em></td>
<td align="left" valign="top">This is not an available value for a media
library device.</td>
</tr>
</table>
<p><strong>Reserved.</strong> An ignored field.</p>
<p><strong>Resource list.</strong> The list of tape resources in the media
library device.</p>
<p><strong>Note:</strong> The data is an array of 10-byte entries. Each entry
consists of a 10-byte density that is left-justified and padded with blanks.
The number of entries in the array is specified in the number of resources in
resource list field. The resource list is not valid when the input device is
not a media library device description (*DEVD).</p>
<p><strong>Resource status list.</strong> The list of statuses that correspond
to resources in the resource list.</p>
<p><strong>Note:</strong> The data is an array of 15-byte entries. Each entry
consists of a 15-byte status that is left-justified and padded with blanks. The
number of entries in the array is specified in the number of resource status
list entries field. The resource status list is not valid when the input device
is not a media library device description (*DEVD). Possible values follow:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*ALLOCATED</em></td>
<td align="left" valign="top">The tape resource is allocated to the media
library device. The system has assigned the device.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*UNPROTECTED</em></td>
<td align="left" valign="top">The tape resource is considered unprotected to
the media library device. It is available to the media library device, but the
system has not assigned the device. The system attempts to assign the resource
when the resource is used.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*DEALLOCATED</em></td>
<td align="left" valign="top">The tape resource is deallocated to the media
library device. The resource is not available to the media library device, and
the system has not assigned the device.</td>
</tr>
</table>
<p><strong>Self-configured tape device.</strong> Whether this resource or
device is a self-configured tape device. Possible values follow:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">The device is not a self-configured tape
device.</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">The device is a self-configured tape device.</td>
</tr>
</table>
<p><strong>Slot and station information.</strong> This information is available
only for a media library device. The information is returned in the following
format:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>BINARY(4)</em></td>
<td align="left" valign="top">Total number of storage slots</td>
</tr>
<tr>
<td align="left" valign="top"><em>BINARY(4)</em></td>
<td align="left" valign="top">Total number of import/export stations</td>
</tr>
</table>
<p>The above numbers are set to zero when the input device is not a media
library device description (*DEVD) or when the information is not
available.</p>
<p>For a media library device that requires a communication interface, the slot
and station information is available only after the media library device
description has been varied on.</p>
<p><strong>Space backward allowed.</strong> Whether the device supports spacing
backward or requires rewinding the device and respacing to the correct file.
Possible values follow:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">No device or resource that is requested has
space-backward capabilities.</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">The device that is requested has space-backward
capabilities.</td>
</tr>
<tr>
<td align="left" valign="top"><em>blank</em></td>
<td align="left" valign="top">This is not an available value for a media
library device.</td>
</tr>
</table>
<p><strong>Space to end of data.</strong> The function that allows quick access
to the end of the logical tape when a command specifies SEQNBR(*END), such as
the Save Library (SAVLIB) command. This function allows a significant
improvement on performance when the tape is positioned at the beginning of the
tape and needs to be positioned a long way into the tape. If the device does
not support this function, i5/OS spaces by the file marks until the end of
data is reached. Possible values follow:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">No device or resource that is requested has space
to end of data capabilities.</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">The device that is requested has space to end of
data capabilities.</td>
</tr>
<tr>
<td align="left" valign="top"><em>blank</em></td>
<td align="left" valign="top">This is not an available value for a media
library device.</td>
</tr>
</table>
<p><strong>Supported improved-data-recording-capability (IDRC)
densities.</strong> The list of densities that support IDRC (or compaction) on
this device.</p>
<p><strong>Note:</strong> The data is an array of 10-byte entries. Each entry
consists of a 10-byte density that is left-justified and padded with blanks.
The number of entries in the array is specified in the number of supported
improved-data-recording-capability (IDRC) densities field. This field is not
available for a media library device.</p>
<p><strong>System feature codes.</strong> The system feature codes (type and
model) that the device reports. The first 4 bytes of the system feature codes
field displays which feature codes are available or reported by the device. The
32 bits of the 4 bytes are defined as follows:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>Bit 0</em></td>
<td align="left" valign="top">iSeries default feature code provided</td>
</tr>
<tr>
<td align="left" valign="top"><em>Bit 1-31</em></td>
<td align="left" valign="top">Not used</td>
</tr>
</table>
<p>Each bit that is identified in the 32 bits as defined above is represented
with 4 bytes of device type and model in hexadecimal representation. These 4
bytes are repeated for each bit that is turned on in the first 4 bytes of the
system feature codes field. The length of this field determines how much
information is returned from the device and is contained in the length of
system feature codes. The length of this field includes the first 4 bytes of
bit definitions. That is, if only bit 0 is on, then the length of the field is
8 bytes, which includes the 4 bytes of bit definition and the 4 bytes of the
one system feature code.</p>
<p><strong>Supported character densities.</strong> The list of densities that
are supported on this device.</p>
<p><strong>Note:</strong> The data is an array of 10-byte entries. Each entry
consists of a 10-byte density that is left-justified and padded with blanks.
The number of entries in the array is specified in the number of supported
character densities field. This field is not available for a media library
device.</p>
<p><strong>Supported read densities.</strong> The list of valid read densities
that are supported by this device.</p>
<p><strong>Note:</strong> The data is an array of 10-byte entries. Each entry
consists of a 10-byte density that is left-justified and padded with blanks.
The number of entries in the array is specified in the number of supported read
densities field. This field is not available for a media library device.</p>
<p><strong>Supported write densities.</strong> The list of valid write
densities that are supported by this device.</p>
<p><strong>Note:</strong> The data is an array of 10-byte entries. Each entry
consists of a 10-byte density that is left-justified and padded with blanks.
The number of entries in the array is specified in the number of supported
write densities field. This field is not available for a media library
device.</p>
<p><img src="delta.gif" alt="Start of change"><strong>Supported write-once-read-many
(WORM) densities.</strong> The list of valid WORM
densities that are supported by this device.</p>
<p><strong>Note:</strong> The data is an array of 10-byte entries. Each entry
consists of a 10-byte density that is left-justified and padded with blanks.
The number of entries in the array is specified in the number of supported
WORM densities field. This data is not available for a media library
device.<img src="deltaend.gif" alt="End of change"></p>
<p><strong>Type of media library device.</strong> The media library technology.
Possible values follow:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">The device is not a media library device.</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">Library commands are communicated to the library
robotic device.</td>
</tr>
<tr>
<td align="left" valign="top"><em>2</em></td>
<td align="left" valign="top">Library commands are communicated to a
communications line.</td>
</tr>
<tr>
<td align="left" valign="top"><em>3</em></td>
<td align="left" valign="top">Library commands are communicated to the library
robotic device and the device.</td>
</tr>
</table>
<p><img src="delta.gif" alt="Start of change"><strong>Virtual device.</strong>
Whether or not the device is a virtual device. Possible values follow:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">The device is not a virtual device.</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">The device is a virtual device.<img src="deltaend.gif" alt="End of change"></td>
</tr>
</table>
<p><img src="delta.gif" alt="Start of change"><strong>Write-once-read-many
(WORM) support.</strong>
Whether the device supports WORM at any density. If WORM is
supported, see the supported WORM densities array.
Possible values follow:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">No device or resource that is requested has WORM
capabilities.</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">The device that is requested has WORM
capabilities.</td>
</tr>
<tr>
<td align="left" valign="top"><em>blank</em></td>
<td align="left" valign="top">Indicates this field is not applicable for a media
library device.<img src="deltaend.gif" alt="End of change"></td>
</tr>
</table>
<br>
<br>
<h3>Error Messages</h3>
<table width="100%" cellpadding="5">
<!-- cols="15 85" -->
<tr>
<th align="left" valign="top">Message ID</th>
<th align="left" valign="top">Error Message Text</th>
</tr>
<tr>
<td align="left" valign="top" width="15%">CPF3C90 E</td>
<td align="left" valign="top" width="85%">Literal value cannot be changed.</td>
</tr>
<tr>
<td align="left" valign="top">CPF6707 E</td>
<td align="left" valign="top">Format name &amp;1 not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF6708 E</td>
<td align="left" valign="top">Command ended due to error.</td>
</tr>
<tr>
<td align="left" valign="top">CPF6709 E</td>
<td align="left" valign="top">Parameter &amp;3 not correct.</td>
</tr>
<tr>
<td align="left" valign="top">CPF6710 E</td>
<td align="left" valign="top">Specified length not correct.</td>
</tr>
<tr>
<td align="left" valign="top">CPF6721 E</td>
<td align="left" valign="top">Device &amp;1 not a tape device.</td>
</tr>
<tr>
<td align="left" valign="top">CPF672F E</td>
<td align="left" valign="top">Resource &amp;1 not found.</td>
</tr>
<tr>
<td align="left" valign="top">CPF673F E</td>
<td align="left" valign="top">Device &amp;1 does not support &amp;2.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9814 E</td>
<td align="left" valign="top">Device &amp;1 not found.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9825 E</td>
<td align="left" valign="top">Not authorized to device &amp;1.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9872 E</td>
<td align="left" valign="top">Program or service program &amp;1 in library
&amp;2 ended. Reason code &amp;3.</td>
</tr>
</table>
<br>
<hr>
API introduced: V3R7
<hr>
<center>
<table cellpadding="2" cellspacing="2">
<tr align="center">
<td valign="middle" align="center">
<a href="#Top_Of_Page">Top</a> |
<a href="back1.htm">Backup and Recovery APIs</a> |
<a href="aplist.htm">APIs by category</a></td>
</tr>
</table>
</center>
</body>
</html>