friedkiwi/ibm-information-center
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
master
ibm-information-center/dist/eclipse/plugins/i5OS.ic.apis_5.4.0.1/qrzrrca.htm

2291 lines
60 KiB
HTML
Raw Permalink Blame History

<!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 Resource Class Attributes (QRZRRCA) 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. -->
<!-- GSA ADP Schedule Contract with IBM Corp. -->
<!-- Change History: -->
<!-- YYMMDD USERID Change description -->
<!-- This file has undergone html cleanup on 1/14/02 by JET -->
<!-- End Header Records -->
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
</head>
<body>
<a name="Top_Of_Page"></a>
<!-- Java sync-link-->
<script type="text/javascript" language="Javascript" src="../rzahg/synch.js">
</script>
<h2>Retrieve Resource Class Attributes (QRZRRCA) API</h2>
<div class="box" style="width: 80%;">
<br>
&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">Request criteria</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Char(*)</td>
</tr>
<tr>
<td align="center" valign="top">5</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: *EXCLUDE<br>
<!-- iddvc RMBR -->
<br>
&nbsp;&nbsp;Threadsafe: No<br>
<!-- iddvc RMBR -->
<br>
</div>
<p>The Retrieve Resource Class Attributes (QRZRRCA) API retrieves
class-specific information or object-type values for a logical resource. The
caller of the API provides the class and subclass, or type and model, or
resource name. The caller of the API also indicates what data is requested.</p>
<p>You can use this API to do the following:</p>
<ul>
<li>Obtain a valid type number based on the class and subclass specified.</li>
<li>Determine the supported protocols based either on the resource name or on
the type and model.</li>
<li>Determine if a controller description is required based either on the
resource name or on the type and model.</li>
<li>Determine if a device supports the assign command based either on the
resource name or on the type and model.</li>
<li>Obtain a media format based either on the resource name or on the type and
model.</li>
<li>Obtain a media class based either on the resource name or on the type and
model.</li>
<li>Determine if a device is read-only based either on the resource name or on
the type and model.</li>
<li>Determine the kind of device based either on the resource name or on the
type and model.</li>
<li>Determine the LAN speed based either on the resource name or on the type
and model.</li>
<li>Determine if a device configuration object is applicable based either on
the resource name or on the type and model.</li>
<li>Determine if a device configuration network ID object is applicable based
either on the resource name or on the type and model.</li>
<li>Determine if the device has a bar code reader based either on the resource
name or on the type and model.</li>
<li>Determine if the device supports import and export based either on the
resource name or on the type and model.</li>
<li>Determine the library mode based either on the resource name or on the type
and model.</li>
<li>Determine if the library reports virtual product data (VPD) information
based either on the resource name or on the type and model.</li>
<li>Determine if the library reports an element address based either on the
resource name or on the type and model.</li>
</ul>
<br>
<h3>Authorities and Locks</h3>
<dl>
<dt><em>API Public Authority</em></dt>
<dd>*EXCLUDE</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 returned. The possible format
names are as follows. <strong>Note:</strong> If 2 (the next attempt to obtain
an element from a possible list of elements) is specified for the search
request criteria field, message CPF0B46 (Materialize failed) is issued if you
try to read beyond the end of the list elements.</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>RRCA0100</em></td>
<td align="left" valign="top">Returns the type number of the object based on
the request criteria. See <a href="#HDRRTVA100">RRCA0100 Format</a> for details
about this format.</td>
</tr>
<tr>
<td align="left" valign="top"><em>RRCA0200</em></td>
<td align="left" valign="top">Returns the protocol support based on the request
criteria. See <a href="#HDRRTVA200">RRCA0200 Format</a> for details about this
format.</td>
</tr>
<tr>
<td align="left" valign="top"><em>RRCA0300</em></td>
<td align="left" valign="top">Returns a value that indicates whether a
controller description is required for the device based on the request
criteria. See <a href="#HDRRTVA300">RRCA0300 Format</a> for details about this
format.</td>
</tr>
<tr>
<td align="left" valign="top"><em>RRCA0400</em></td>
<td align="left" valign="top">Returns a value that indicates whether the device
supports the assign command based on the request criteria. See <a href=
"#HDRRTVA400">RRCA0400 Format</a> for details about this format.</td>
</tr>
<tr>
<td align="left" valign="top"><em>RRCA0500</em></td>
<td align="left" valign="top">Returns a value that indicates the media format
based on the request criteria. See <a href="#HDRRTVA500">RRCA0500 Format</a>
for details about this format.</td>
</tr>
<tr>
<td align="left" valign="top"><em>RRCA0600</em></td>
<td align="left" valign="top">Returns a value that indicates the media class
based on the request criteria. See <a href="#HDRRTVA600">RRCA0600 Format</a>
for details about this format.</td>
</tr>
<tr>
<td align="left" valign="top"><em>RRCA0700</em></td>
<td align="left" valign="top">Returns a value that indicates whether the device
is read-only based on the request criteria. See <a href="#HDRRTVA700">RRCA0700
Format</a> for details about this format.</td>
</tr>
<tr>
<td align="left" valign="top"><em>RRCA0800</em></td>
<td align="left" valign="top">Returns a value that indicates the kind of
resource. The three fields can be used separately or together. See <a href=
"#HDRRTVA800">RRCA0800 Format</a> for details about this format.</td>
</tr>
<tr>
<td align="left" valign="top"><em>RRCA0900</em></td>
<td align="left" valign="top">Returns a value that indicates the LAN speed. See
<a href="#HDRRTVA900">RRCA0900 Format</a> for details about this format.</td>
</tr>
<tr>
<td align="left" valign="top"><em>RRCA1000</em></td>
<td align="left" valign="top">Returns a value that indicates the value of the
configurable flag. See <a href="#HDRRTVA110">RRCA1000 Format</a> for details
about this format.</td>
</tr>
<tr>
<td align="left" valign="top"><em>RRCA1100</em></td>
<td align="left" valign="top">Returns a value that indicates the network ID.
See <a href="#HDRRTVA11B">RRCA1100 Format</a> for details about this
format.</td>
</tr>
<tr>
<td align="left" valign="top"><em>RRCA1200</em></td>
<td align="left" valign="top">Returns a value that indicates that the device
has a bar code reader. See <a href="#HDRRTVA120">RRCA1200 Format</a> for
details about this format.</td>
</tr>
<tr>
<td align="left" valign="top"><em>RRCA1300</em></td>
<td align="left" valign="top">Returns a value that indicates whether the device
supports import and export operations. See <a href="#HDRRTVA130">RRCA1300
Format</a> for details about this format.</td>
</tr>
<tr>
<td align="left" valign="top"><em>RRCA1400</em></td>
<td align="left" valign="top">Returns a value that indicates the library mode.
See <a href="#HDRRTVA140">RRCA1400 Format</a> for details about this
format.</td>
</tr>
<tr>
<td align="left" valign="top"><em>RRCA1500</em></td>
<td align="left" valign="top">Returns a value that indicates whether the
library reports vital product data (VPD). See <a href="#HDRRTVA150">RRCA1500
Format</a> for details about this format.</td>
</tr>
<tr>
<td align="left" valign="top"><em>RRCA1600</em></td>
<td align="left" valign="top">Returns a value that indicates whether the
library reports the address of the elements. See <a href="#HDRRTVA160">RRCA1600
Format</a> for details about this format.</td>
</tr>
</table>
<br>
</dd>
<dt><strong>Request criteria</strong></dt>
<dd>INPUT; CHAR(*)
<p> The criteria for which the retrieval will be processed.</p>
</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="HDRRTVACRT">Format of the Request Criteria</a></h3>
<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%">CHAR(16)</td>
<td align="left" valign="top" width="60%">Handle</td>
</tr>
<tr>
<td align="center" valign="top">16</td>
<td align="center" valign="top">10</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Search request</td>
</tr>
<tr>
<td align="center" valign="top">20</td>
<td align="center" valign="top">14</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Key</td>
</tr>
<tr>
<td align="center" valign="top">24</td>
<td align="center" valign="top">18</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Request indicator</td>
</tr>
<tr>
<td align="center" valign="top">28</td>
<td align="center" valign="top">1C</td>
<td align="left" valign="top">CHAR(32)</td>
<td align="left" valign="top">Request data</td>
</tr>
</table>
<br>
<br>
<h3><a name="HDRRTVAFD1">Field Descriptions</a></h3>
<p><strong>Handle.</strong> The value of the handle. The handle allows repeated
calls to obtain more than one resource name that meets the request criteria.
The handle is created through the Create Handle (QRZCRTH) API. The handle is
required in conjunction with the first or next search request. The handle must
be set to binary zeros in conjunction with the first search request when no
next search request is needed. The user is responsible for deleting the handle
when it is no longer needed. Use the Delete Handle (QRZDLTH) API to delete the
handle.</p>
<p><strong>Key.</strong> The key value indicating the type of data to be
returned in the receiver variable. The format of these keys is described in the
format descriptions <a href="#HDRRTVA100">RRCA0100 Format</a> through <a href=
"#HDRRTVA160">RRCA1600 Format</a>. See <a href="#HDRRTVAFD">Field
Descriptions</a> for a description of these keys. Valid keys are:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">Type</td>
</tr>
<tr>
<td align="left" valign="top"><em>2</em></td>
<td align="left" valign="top">Protocol supported</td>
</tr>
<tr>
<td align="left" valign="top"><em>3</em></td>
<td align="left" valign="top">Controller description required</td>
</tr>
<tr>
<td align="left" valign="top"><em>4</em></td>
<td align="left" valign="top">Assign command supported flag</td>
</tr>
<tr>
<td align="left" valign="top"><em>5</em></td>
<td align="left" valign="top">Media format</td>
</tr>
<tr>
<td align="left" valign="top"><em>6</em></td>
<td align="left" valign="top">Media class</td>
</tr>
<tr>
<td align="left" valign="top"><em>7</em></td>
<td align="left" valign="top">Read-only flag</td>
</tr>
<tr>
<td align="left" valign="top"><em>8</em></td>
<td align="left" valign="top">Resource classification</td>
</tr>
<tr>
<td align="left" valign="top"><em>9</em></td>
<td align="left" valign="top">LAN speed</td>
</tr>
<tr>
<td align="left" valign="top"><em>10</em></td>
<td align="left" valign="top">Configurable flag</td>
</tr>
<tr>
<td align="left" valign="top"><em>11</em></td>
<td align="left" valign="top">Network ID applicable flag</td>
</tr>
<tr>
<td align="left" valign="top"><em>12</em></td>
<td align="left" valign="top">Bar code reader flag</td>
</tr>
<tr>
<td align="left" valign="top"><em>13</em></td>
<td align="left" valign="top">Import and export supported flag</td>
</tr>
<tr>
<td align="left" valign="top"><em>14</em></td>
<td align="left" valign="top">Library mode</td>
</tr>
<tr>
<td align="left" valign="top"><em>15</em></td>
<td align="left" valign="top">Library reports VPD flag</td>
</tr>
<tr>
<td align="left" valign="top"><em>16</em></td>
<td align="left" valign="top">Library reports elements flag</td>
</tr>
</table>
<p><strong>Request data.</strong> The field indicating which class and
subclass, or type and model, or resource name to use in the search.</p>
<p>Following is the field structure to be used in the request data for class
and subclass.</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%">Class</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">Subclass</td>
</tr>
<tr>
<td align="center" valign="top">8</td>
<td align="center" valign="top">8</td>
<td align="left" valign="top">CHAR(24)</td>
<td align="left" valign="top">Reserved</td>
</tr>
</table>
<p>Following are the valid values to be used for the class field:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">Tape drive class</td>
</tr>
<tr>
<td align="left" valign="top"><em>2</em></td>
<td align="left" valign="top">Optical class</td>
</tr>
<tr>
<td align="left" valign="top"><em>3</em></td>
<td align="left" valign="top">Workstation</td>
</tr>
<tr>
<td align="left" valign="top"><em>4</em></td>
<td align="left" valign="top">Communications</td>
</tr>
<tr>
<td align="left" valign="top"><em>5</em></td>
<td align="left" valign="top">Diskette</td>
</tr>
</table>
<p>Following are the valid values to be used for the subclass field:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">Subclass is for a device.</td>
</tr>
<tr>
<td align="left" valign="top"><em>2</em></td>
<td align="left" valign="top">Subclass is for a controller.</td>
</tr>
<tr>
<td align="left" valign="top"><em>3</em></td>
<td align="left" valign="top">Subclass is for a library.</td>
</tr>
<tr>
<td align="left" valign="top"><em>4</em></td>
<td align="left" valign="top">Subclass is for a port.</td>
</tr>
</table>
<p>The reserved field must be set to hexadecimal zeros.</p>
<p>Following is the field structure to be used in the request data for type and
model.</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%">CHAR(10)</td>
<td align="left" valign="top" width="60%">Type number</td>
</tr>
<tr>
<td align="center" valign="top">10</td>
<td align="center" valign="top">A</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Model number</td>
</tr>
<tr>
<td align="center" valign="top">20</td>
<td align="center" valign="top">14</td>
<td align="left" valign="top">CHAR(12)</td>
<td align="left" valign="top">Reserved</td>
</tr>
</table>
<p><em>Type number.</em> An object type number that is left-justified and
filled with trailing blanks.</p>
<p><em>Model number.</em> An object model number that is left-justified and
filled with trailing blanks.</p>
<p><em>Reserved.</em> This must be set to hexadecimal zeros.</p>
<p>Following is the field structure to be used in the request data for resource
name.</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%">CHAR(32)</td>
<td align="left" valign="top" width="60%">Resource name</td>
</tr>
</table>
<p><em>Resource name.</em> A 32-character name that is left-justified and
filled with trailing blanks.</p>
<p><strong>Request indicator.</strong> Whether the retrieval of the resource
information is by class and subclass, or type and model, or resource name.</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">Class and subclass</td>
</tr>
<tr>
<td align="left" valign="top"><em>2</em></td>
<td align="left" valign="top">Type and model</td>
</tr>
<tr>
<td align="left" valign="top"><em>3</em></td>
<td align="left" valign="top">Resource name</td>
</tr>
</table>
<p><strong>Search request.</strong> Whether the search request is a first
attempt or a next attempt to obtain the elements from a list of elements.</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">The first attempt to obtain an element from a
possible list of elements.</td>
</tr>
<tr>
<td align="left" valign="top"><em>2</em></td>
<td align="left" valign="top">The next attempt to obtain an element from a
possible list of elements.</td>
</tr>
</table>
<br>
<br>
<h3><a name="HDRRTVA100">RRCA0100 Format</a></h3>
<p>This format name is valid only when the request indicator is for class and
subclass. An error results if this format name is used with type and model or
with resource name.</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">Type</td>
</tr>
</table>
<br>
<br>
<h3><a name="HDRRTVA200">RRCA0200 Format</a></h3>
<p>This format name is valid only when the request indicator is for type and
model or for resource name. An error results if this format name is used with
class and subclass.</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(8)</td>
<td align="left" valign="top">Protocol supported</td>
</tr>
</table>
<br>
<br>
<h3><a name="HDRRTVA300">RRCA0300 Format</a></h3>
<p>This format name is valid only when the request indicator is for type and
model or for resource name. An error results if this format name is used with
class and subclass.</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">BINARY(4)</td>
<td align="left" valign="top">Controller description required</td>
</tr>
</table>
<br>
<br>
<h3><a name="HDRRTVA400">RRCA0400 Format</a></h3>
<p>This format name is valid only when the request indicator is for type and
model or for resource name. An error results if this format name is used with
class and subclass.</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">BINARY(4)</td>
<td align="left" valign="top">Assign command supported flag</td>
</tr>
</table>
<br>
<br>
<h3><a name="HDRRTVA500">RRCA0500 Format</a></h3>
<p>This format name is valid only when the request indicator is for type and
model or for resource name. An error results if this format name is used with
class and subclass.</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(8)</td>
<td align="left" valign="top">Media format</td>
</tr>
</table>
<br>
<br>
<h3><a name="HDRRTVA600">RRCA0600 Format</a></h3>
<p>This format name is valid only when the request indicator is for type and
model or for resource name. An error results if this format name is used with
class and subclass.</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(8)</td>
<td align="left" valign="top">Media class</td>
</tr>
</table>
<br>
<br>
<h3><a name="HDRRTVA700">RRCA0700 Format</a></h3>
<p>This format name is valid only when the request indicator is for type and
model or for resource name. An error results if this format name is used with
class and subclass.</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">BINARY(4)</td>
<td align="left" valign="top">Read-only flag</td>
</tr>
</table>
<br>
<br>
<h3><a name="HDRRTVA800">RRCA0800 Format</a></h3>
<p>This format name is valid only when the request indicator is for type and
model or for resource name. An error results if this format name is used with
class and subclass.</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(8)</td>
<td align="left" valign="top">Resource classification 1</td>
</tr>
<tr>
<td align="center" valign="top">16</td>
<td align="center" valign="top">10</td>
<td align="left" valign="top">CHAR(8)</td>
<td align="left" valign="top">Resource classification 2</td>
</tr>
<tr>
<td align="center" valign="top">24</td>
<td align="center" valign="top">18</td>
<td align="left" valign="top">CHAR(8)</td>
<td align="left" valign="top">Resource classification 3</td>
</tr>
</table>
<br>
<br>
<h3><a name="HDRRTVA900">RRCA0900 Format</a></h3>
<p>This format name is only valid when the request indicator is for type and
model or for resource name. An error results if this format name is used with
class and subclass.</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(8)</td>
<td align="left" valign="top">LAN speed</td>
</tr>
</table>
<br>
<br>
<h3><a name="HDRRTVA110">RRCA1000 Format</a></h3>
<p>This format name is valid only when the request indicator is for type and
model or for resource name. An error results if this format name is used with
class and subclass.</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">BINARY(4)</td>
<td align="left" valign="top">Configurable flag</td>
</tr>
</table>
<br>
<br>
<h3><a name="HDRRTVA11B">RRCA1100 Format</a></h3>
<p>This format name is valid only when the request indicator is for type and
model or for resource name. An error results if this format name is used with
class and subclass.</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">BINARY(4)</td>
<td align="left" valign="top">Network ID applicable flag</td>
</tr>
</table>
<br>
<br>
<h3><a name="HDRRTVA120">RRCA1200 Format</a></h3>
<p>This format name is valid only when the request indicator is for type and
model or for resource name. An error results if this format name is used with
class and subclass.</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">BINARY(4)</td>
<td align="left" valign="top">Bar code reader flag</td>
</tr>
</table>
<br>
<br>
<h3><a name="HDRRTVA130">RRCA1300 Format</a></h3>
<p>This format name is valid only when the request indicator is for type and
model or for resource name. An error results if this format name is used with
class and subclass.</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">BINARY(4)</td>
<td align="left" valign="top">Import and export supported flag</td>
</tr>
</table>
<br>
<br>
<h3><a name="HDRRTVA140">RRCA1400 Format</a></h3>
<p>This format name is valid only when the request indicator is for type and
model or for resource name. An error results if this format name is used with
class and subclass.</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(1)</td>
<td align="left" valign="top">Library mode</td>
</tr>
</table>
<br>
<br>
<h3><a name="HDRRTVA150">RRCA1500 Format</a></h3>
<p>This format name is valid only when the request indicator is for type and
model or for resource name. An error results if this format name is used with
class and subclass.</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">BINARY(4)</td>
<td align="left" valign="top">Library reports VPD flag</td>
</tr>
</table>
<br>
<br>
<h3><a name="HDRRTVA160">RRCA1600 Format</a></h3>
<p>This format name is valid only when the request indicator is for type and
model or for resource name. An error results if this format name is used with
class and subclass.</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">BINARY(4)</td>
<td align="left" valign="top">Library reports elements flag</td>
</tr>
</table>
<br>
<br>
<h3><a name="HDRRTVAFD">Field Descriptions</a></h3>
<p><strong>Assign command supported flag.</strong> Whether the assign command
is supported. Valid values for this field are 0 (No) and 1 (Yes).</p>
<p><strong>Bar code reader flag.</strong> Whether the device has a bar code
reader. Valid values for this field are 0 (No) and 1 (Yes).</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>Configurable flag.</strong> Whether the resource can be configured.
Valid values for this field are 0 (No) and 1 (Yes).</p>
<p><strong>Controller description required.</strong> Whether a controller
description is required. Valid values for this field are 0 (No) and 1
(Yes).</p>
<p><strong>Import and export supported flag.</strong> Whether import and export
operations are supported. Valid values for this field are 0 (No) and 1
(Yes).</p>
<p><strong>LAN speed.</strong> A value that represents the speed of the local
area network (LAN).</p>
<table width="80%" border>
<tr>
<th align="left" valign="top">Speed</th>
<th align="left" valign="top">Returned value</th>
</tr>
<tr>
<td align="left" valign="top" width="50%">4MB</td>
<td align="left" valign="top" width="50%">X'0000000000000000'</td>
</tr>
<tr>
<td align="left" valign="top">16MG</td>
<td align="left" valign="top">X'0000000000000001'</td>
</tr>
<tr>
<td align="left" valign="top">4MB and 16MB</td>
<td align="left" valign="top">X'0000000000000002'</td>
</tr>
<tr>
<td align="left" valign="top">Not applicable</td>
<td align="left" valign="top">X'0000000000000003'</td>
</tr>
</table>
<p><strong>Library mode.</strong> A value that represents how the media mover
is accessed through a library. Valid values are:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">Not in a library</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">In a library where the media mover is on a
different resource on this input/output processor (IOP).</td>
</tr>
<tr>
<td align="left" valign="top"><em>2</em></td>
<td align="left" valign="top">In a library where the media mover is accessed
through a communications line.</td>
</tr>
<tr>
<td align="left" valign="top"><em>3</em></td>
<td align="left" valign="top">In a library where the device and the media mover
are combined in the same resource.</td>
</tr>
</table>
<p><strong>Library reports elements flag.</strong> Whether the library reports
the address of the elements. Valid values for this field are 0 (No) and 1
(Yes).</p>
<p><strong>Library reports VPD flag.</strong> Whether the library reports vital
product data (VPD). Valid values for this field are 0 (No) and 1 (Yes).</p>
<p><strong>Media class.</strong> The format of the data on the media.</p>
<table width="80%" border>
<tr>
<th align="left" valign="top">Format</th>
<th align="left" valign="top">Returned value</th>
</tr>
<tr>
<td align="left" valign="top" width="50%">Unknown format</td>
<td align="left" valign="top" width="50%">X'0000000000000000'</td>
</tr>
<tr>
<td align="left" valign="top">1600 bpi format</td>
<td align="left" valign="top">X'0000000000000001'</td>
</tr>
<tr>
<td align="left" valign="top">3200 bpi format</td>
<td align="left" valign="top">X'0000000000000002'</td>
</tr>
<tr>
<td align="left" valign="top">6250 bpi format</td>
<td align="left" valign="top">X'000000000000003'</td>
</tr>
<tr>
<td align="left" valign="top">38000 bpi format</td>
<td align="left" valign="top">X'0000000000000004'</td>
</tr>
<tr>
<td align="left" valign="top">76000 bpi format</td>
<td align="left" valign="top">X'0000000000000005'</td>
</tr>
<tr>
<td align="left" valign="top">Qic24 format</td>
<td align="left" valign="top">X'0000000000000006'</td>
</tr>
<tr>
<td align="left" valign="top">Qic120 format</td>
<td align="left" valign="top">X'0000000000000007'</td>
</tr>
<tr>
<td align="left" valign="top">Qic150 format</td>
<td align="left" valign="top">X'0000000000000008'</td>
</tr>
<tr>
<td align="left" valign="top">Qic320 format</td>
<td align="left" valign="top">X'0000000000000009'</td>
</tr>
<tr>
<td align="left" valign="top">Qic1000 format</td>
<td align="left" valign="top">X'000000000000000A'</td>
</tr>
<tr>
<td align="left" valign="top">Qic2GB format</td>
<td align="left" valign="top">X'000000000000000B'</td>
</tr>
<tr>
<td align="left" valign="top">2pt3GB format</td>
<td align="left" valign="top">X'000000000000000C'</td>
</tr>
<tr>
<td align="left" valign="top">2pt5GB format</td>
<td align="left" valign="top">X'000000000000000D'</td>
</tr>
<tr>
<td align="left" valign="top">3480 format</td>
<td align="left" valign="top">X'000000000000000E'</td>
</tr>
<tr>
<td align="left" valign="top">3490 format</td>
<td align="left" valign="top">X'000000000000000F'</td>
</tr>
<tr>
<td align="left" valign="top">2 GB format</td>
<td align="left" valign="top">X'0000000000000010'</td>
</tr>
<tr>
<td align="left" valign="top">5 GB format</td>
<td align="left" valign="top">X'0000000000000011'</td>
</tr>
<tr>
<td align="left" valign="top">7 GB format</td>
<td align="left" valign="top">X'0000000000000012'</td>
</tr>
<tr>
<td align="left" valign="top">QIC 525 format</td>
<td align="left" valign="top">X'0000000000000013'</td>
</tr>
<tr>
<td align="left" valign="top">QIC 3040 format</td>
<td align="left" valign="top">X'0000000000000014'</td>
</tr>
<tr>
<td align="left" valign="top">ISO9660 format</td>
<td align="left" valign="top">X'0000000000000015'</td>
</tr>
<tr>
<td align="left" valign="top">HPOFS format</td>
<td align="left" valign="top">X'0000000000000016'</td>
</tr>
<tr>
<td align="left" valign="top">3590 format</td>
<td align="left" valign="top">X'0000000000000017'</td>
</tr>
<tr>
<td align="left" valign="top">77 tracks per side; 96 tracks per inch</td>
<td align="left" valign="top">X'0000000000000018'</td>
</tr>
<tr>
<td align="left" valign="top">77 tracks per side; 48 tracks per inch</td>
<td align="left" valign="top">X'0000000000000019'</td>
</tr>
<tr>
<td align="left" valign="top">FMT3570</td>
<td align="left" valign="top">X'000000000000001A'</td>
</tr>
<tr>
<td align="left" valign="top">QIC5010</td>
<td align="left" valign="top">X'000000000000001B'</td>
</tr>
</table>
<p><strong>Media format.</strong> The type of media on which the data is
stored.</p>
<table width="80%" border>
<tr>
<th align="left" valign="top">Media type</th>
<th align="left" valign="top">Returned value</th>
</tr>
<tr>
<td align="left" valign="top" width="50%">Unknown class</td>
<td align="left" valign="top" width="50%">X'0000000000000000'</td>
</tr>
<tr>
<td align="left" valign="top">1/2 in. reel tape</td>
<td align="left" valign="top">X'0000000000000001'</td>
</tr>
<tr>
<td align="left" valign="top">1/2 in. cartridge</td>
<td align="left" valign="top">X'0000000000000002'</td>
</tr>
<tr>
<td align="left" valign="top">1/4 in. cartridge</td>
<td align="left" valign="top">X'0000000000000003'</td>
</tr>
<tr>
<td align="left" valign="top">8 mm cartridge</td>
<td align="left" valign="top">X'0000000000000004'</td>
</tr>
<tr>
<td align="left" valign="top">5-1/4 in. diskette</td>
<td align="left" valign="top">X'0000000000000005'</td>
</tr>
<tr>
<td align="left" valign="top">8 in. diskette</td>
<td align="left" valign="top">X'0000000000000006'</td>
</tr>
<tr>
<td align="left" valign="top">WORM optical</td>
<td align="left" valign="top">X'0000000000000007'</td>
</tr>
<tr>
<td align="left" valign="top">CD-ROM optical</td>
<td align="left" valign="top">X'0000000000000008'</td>
</tr>
<tr>
<td align="left" valign="top">Magnet-optical</td>
<td align="left" valign="top">X'0000000000000009'</td>
</tr>
<tr>
<td align="left" valign="top">Mini</td>
<td align="left" valign="top">X'000000000000000A'</td>
</tr>
</table>
<p><strong>Network ID applicable flag.</strong> Whether the resource uses a
network ID. Valid values for this field are 0 (No) and 1 (Yes).</p>
<p><strong>Protocol supported.</strong> The value for the protocol to be
supported.</p>
<table width="80%" border>
<tr>
<th align="left" valign="top">Protocol</th>
<th align="left" valign="top">Value</th>
</tr>
<tr>
<td align="left" valign="top" width="50%">None</td>
<td align="left" valign="top" width="50%">X'0000000000000000'</td>
</tr>
<tr>
<td align="left" valign="top">SDLC</td>
<td align="left" valign="top">X'0000000000000001'</td>
</tr>
<tr>
<td align="left" valign="top">Bisynchronous</td>
<td align="left" valign="top">X'0000000000000002'</td>
</tr>
<tr>
<td align="left" valign="top">Asynchronous</td>
<td align="left" valign="top">X'0000000000000003'</td>
</tr>
<tr>
<td align="left" valign="top">X.25</td>
<td align="left" valign="top">X'0000000000000004'</td>
</tr>
<tr>
<td align="left" valign="top">Token ring</td>
<td align="left" valign="top">X'0000000000000005'</td>
</tr>
<tr>
<td align="left" valign="top">X.25 compact disc (CD)</td>
<td align="left" valign="top">X'0000000000000006'</td>
</tr>
<tr>
<td align="left" valign="top">Twinaxial DLC</td>
<td align="left" valign="top">X'0000000000000007'</td>
</tr>
<tr>
<td align="left" valign="top">Open in CD</td>
<td align="left" valign="top">X'0000000000000008'</td>
</tr>
<tr>
<td align="left" valign="top">Ethernet</td>
<td align="left" valign="top">X'0000000000000009'</td>
</tr>
<tr>
<td align="left" valign="top">Lap E</td>
<td align="left" valign="top">X'000000000000000A'</td>
</tr>
<tr>
<td align="left" valign="top">Lap D</td>
<td align="left" valign="top">X'000000000000000B'</td>
</tr>
<tr>
<td align="left" valign="top">Network node</td>
<td align="left" valign="top">X'000000000000000C'</td>
</tr>
<tr>
<td align="left" valign="top">FDDI</td>
<td align="left" valign="top">X'000000000000000D'</td>
</tr>
<tr>
<td align="left" valign="top">Frame relay direct</td>
<td align="left" valign="top">X'000000000000000E'</td>
</tr>
<tr>
<td align="left" valign="top">Fax</td>
<td align="left" valign="top">X'000000000000000F'</td>
</tr>
<tr>
<td align="left" valign="top">SDLC short hold mode</td>
<td align="left" valign="top">X'0000000000000011'</td>
</tr>
</table>
<p><strong>Read-only flag.</strong> Whether the device is read only. Valid
values for this field are 0 (No) and 1 (Yes).</p>
<p><strong>Resource classification 1.</strong> The type of hardware that the
resource is.</p>
<table width="80%" border>
<tr>
<th align="left" valign="top">Hardware type</th>
<th align="left" valign="top">Returned value</th>
</tr>
<tr>
<td align="left" valign="top" width="50%">Not available</td>
<td align="left" valign="top" width="50%">X'4000000000000000'</td>
</tr>
<tr>
<td align="left" valign="top">Any classification 1</td>
<td align="left" valign="top">X'4FFFFFFFFFFFFFFF'</td>
</tr>
<tr>
<td align="left" valign="top">IOP</td>
<td align="left" valign="top">X'0000000000000001'</td>
</tr>
<tr>
<td align="left" valign="top">Controller</td>
<td align="left" valign="top">X'0000000000000002'</td>
</tr>
<tr>
<td align="left" valign="top">Device</td>
<td align="left" valign="top">X'0000000000000004'</td>
</tr>
<tr>
<td align="left" valign="top">Port</td>
<td align="left" valign="top">X'0000000000000008'</td>
</tr>
<tr>
<td align="left" valign="top">Channel</td>
<td align="left" valign="top">X'0000000000000010'</td>
</tr>
<tr>
<td align="left" valign="top">Library</td>
<td align="left" valign="top">X'0000000000000020'</td>
</tr>
<tr>
<td align="left" valign="top">Bus controller</td>
<td align="left" valign="top">X'0000000000000040'</td>
</tr>
<tr>
<td align="left" valign="top">IO node</td>
<td align="left" valign="top">X'0000000000000080'</td>
</tr>
<tr>
<td align="left" valign="top">Bus</td>
<td align="left" valign="top">X'0000000000000100'</td>
</tr>
<tr>
<td align="left" valign="top">Bus extension</td>
<td align="left" valign="top">X'0000000000000200'</td>
</tr>
<tr>
<td align="left" valign="top">Path information unit (PIU)</td>
<td align="left" valign="top">X'0000000000000400'</td>
</tr>
<tr>
<td align="left" valign="top">Picker (PCK)</td>
<td align="left" valign="top">X'0000000000000800'</td>
</tr>
</table>
<p><strong>Resource classification 2.</strong> The type of controller that the
resource is.</p>
<table width="80%" border>
<tr>
<th align="left" valign="top">Controller type</th>
<th align="left" valign="top">Returned value</th>
</tr>
<tr>
<td align="left" valign="top" width="50%">Not available</td>
<td align="left" valign="top" width="50%">X'4000000000000000'</td>
</tr>
<tr>
<td align="left" valign="top">Any classification 2</td>
<td align="left" valign="top">X'4FFFFFFFFFFFFFFF'</td>
</tr>
<tr>
<td align="left" valign="top">Workstation</td>
<td align="left" valign="top">X'0000000000000001'</td>
</tr>
<tr>
<td align="left" valign="top">Storage</td>
<td align="left" valign="top">X'0000000000000002'</td>
</tr>
<tr>
<td align="left" valign="top">Communications</td>
<td align="left" valign="top">X'0000000000000003'</td>
</tr>
<tr>
<td align="left" valign="top">Workstation storage</td>
<td align="left" valign="top">X'0000000000000004'</td>
</tr>
<tr>
<td align="left" valign="top">Workstation communications</td>
<td align="left" valign="top">X'0000000000000005'</td>
</tr>
<tr>
<td align="left" valign="top">Storage communications</td>
<td align="left" valign="top">X'0000000000000006'</td>
</tr>
<tr>
<td align="left" valign="top">Storage communications workstation</td>
<td align="left" valign="top">X'0000000000000007'</td>
</tr>
<tr>
<td align="left" valign="top">Shared object clustering (SOC)</td>
<td align="left" valign="top">X'0000000000000008'</td>
</tr>
</table>
<p><strong>Resource classification 3.</strong> The type of device that the
resource is.</p>
<table width="80%" border>
<tr>
<th align="left" valign="top">Device type</th>
<th align="left" valign="top">Returned value</th>
</tr>
<tr>
<td align="left" valign="top" width="50%">Not available</td>
<td align="left" valign="top" width="50%">X'4000000000000000'</td>
</tr>
<tr>
<td align="left" valign="top">Any classification 3</td>
<td align="left" valign="top">X'4FFFFFFFFFFFFFFF'</td>
</tr>
<tr>
<td align="left" valign="top">Display</td>
<td align="left" valign="top">X'0000000000000001'</td>
</tr>
<tr>
<td align="left" valign="top">Printer</td>
<td align="left" valign="top">X'0000000000000002'</td>
</tr>
<tr>
<td align="left" valign="top">DASD</td>
<td align="left" valign="top">X'0000000000000004'</td>
</tr>
<tr>
<td align="left" valign="top">Diskette</td>
<td align="left" valign="top">X'0000000000000008'</td>
</tr>
<tr>
<td align="left" valign="top">Optical</td>
<td align="left" valign="top">X'0000000000000010'</td>
</tr>
<tr>
<td align="left" valign="top">Tape</td>
<td align="left" valign="top">X'0000000000000020'</td>
</tr>
<tr>
<td align="left" valign="top">Removable media</td>
<td align="left" valign="top">X'0000000000000038'</td>
</tr>
<tr>
<td align="left" valign="top">ISDN</td>
<td align="left" valign="top">X'0000000000000040'</td>
</tr>
<tr>
<td align="left" valign="top">X.25</td>
<td align="left" valign="top">X'0000000000000080'</td>
</tr>
<tr>
<td align="left" valign="top">Token ring</td>
<td align="left" valign="top">X'0000000000000100'</td>
</tr>
<tr>
<td align="left" valign="top">SDLC</td>
<td align="left" valign="top">X'0000000000000200'</td>
</tr>
<tr>
<td align="left" valign="top">Ethernet</td>
<td align="left" valign="top">X'0000000000000400'</td>
</tr>
<tr>
<td align="left" valign="top">FDDI</td>
<td align="left" valign="top">X'0000000000000800'</td>
</tr>
<tr>
<td align="left" valign="top">Token-ring FDDI</td>
<td align="left" valign="top">X'0000000000000900'</td>
</tr>
<tr>
<td align="left" valign="top">Frame relay</td>
<td align="left" valign="top">X'0000000000001000'</td>
</tr>
<tr>
<td align="left" valign="top">Frame relay SDLC</td>
<td align="left" valign="top">X'0000000000001200'</td>
</tr>
<tr>
<td align="left" valign="top">Cryptographic</td>
<td align="left" valign="top">X'0000000000002000'</td>
</tr>
<tr>
<td align="left" valign="top">Fax</td>
<td align="left" valign="top">X'0000000000004000'</td>
</tr>
<tr>
<td align="left" valign="top">Memory</td>
<td align="left" valign="top">X'0000000000008000'</td>
</tr>
<tr>
<td align="left" valign="top">Service processor</td>
<td align="left" valign="top">X'0000000000010000'</td>
</tr>
<tr>
<td align="left" valign="top">Main processor</td>
<td align="left" valign="top">X'0000000000020000'</td>
</tr>
<tr>
<td align="left" valign="top">Bus controller</td>
<td align="left" valign="top">X'0000000000040000'</td>
</tr>
<tr>
<td align="left" valign="top">System information</td>
<td align="left" valign="top">X'0000000000080000'</td>
</tr>
<tr>
<td align="left" valign="top">Control panel</td>
<td align="left" valign="top">X'0000000000100000'</td>
</tr>
<tr>
<td align="left" valign="top">Bus adapter</td>
<td align="left" valign="top">X'0000000000200000'</td>
</tr>
<tr>
<td align="left" valign="top">SPD bus</td>
<td align="left" valign="top">X'0000000000400000'</td>
</tr>
<tr>
<td align="left" valign="top">Bus extension</td>
<td align="left" valign="top">X'0000000000800000'</td>
</tr>
<tr>
<td align="left" valign="top">System bus adapter processor interface unit (Sba
PIU)</td>
<td align="left" valign="top">X'0000000001000000'</td>
</tr>
<tr>
<td align="left" valign="top" height="23">Twin optical bus controller</td>
<td align="left" valign="top" height="23">X'0000000002000000'</td>
</tr>
<tr>
<td align="left" valign="top">ASCII</td>
<td align="left" valign="top">X'0000000004000000'</td>
</tr>
<tr>
<td align="left" valign="top">ASCII display</td>
<td align="left" valign="top">X'0000000004000001'</td>
</tr>
<tr>
<td align="left" valign="top">ASCII printer</td>
<td align="left" valign="top">X'0000000004000002'</td>
</tr>
<tr>
<td align="left" valign="top">Twinaxial</td>
<td align="left" valign="top">X'0000000008000000'</td>
</tr>
<tr>
<td align="left" valign="top">Twinaxial display</td>
<td align="left" valign="top">X'0000000008000001'</td>
</tr>
<tr>
<td align="left" valign="top">Twinaxial printer</td>
<td align="left" valign="top">X'0000000008000002'</td>
</tr>
<tr>
<td align="left" valign="top">Apple</td>
<td align="left" valign="top">X'0000000010000000'</td>
</tr>
<tr>
<td align="left" valign="top">Apple token-ring LAN</td>
<td align="left" valign="top">X'0000000010000100'</td>
</tr>
<tr>
<td align="left" valign="top">Apple Ethernet</td>
<td align="left" valign="top">X'0000000010000400'</td>
</tr>
<tr>
<td align="left" valign="top">Wireless</td>
<td align="left" valign="top">X'0000000020000000'</td>
</tr>
<tr>
<td align="left" valign="top">SOC host</td>
<td align="left" valign="top">X'0000000040000000'</td>
</tr>
<tr>
<td align="left" valign="top">SOC nonhost</td>
<td align="left" valign="top">X'0000000080000000'</td>
</tr>
<tr>
<td align="left" valign="top">Internetwork Packet Exchange (IPX)</td>
<td align="left" valign="top">X'0000000100000000'</td>
</tr>
</table>
<p><strong>Type.</strong> The object type number.</p>
<br>
<h3>Error Messages</h3>
<table width="100%" cellpadding="5">
<!-- cols="15 85" -->
<tr>
<th align="left" valign="top" nowrap>Message ID</th>
<th align="left" valign="top">Error Message Text</th>
</tr>
<tr>
<td align="left" valign="top">CPF0B3B E</td>
<td align="left" valign="top">Resource name not found.</td>
</tr>
<tr>
<td align="left" valign="top">CPF0B3D E</td>
<td align="left" valign="top">Format &amp;1 is not valid with request indicator
&amp;2.</td>
</tr>
<tr>
<td align="left" valign="top">CPF0B33 E</td>
<td align="left" valign="top">The handle is not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF0B34 E</td>
<td align="left" valign="top">The handle is in wrong state for operation.</td>
</tr>
<tr>
<td align="left" valign="top">CPF0B35 E</td>
<td align="left" valign="top">Invalid class.</td>
</tr>
<tr>
<td align="left" valign="top">CPF0B36 E</td>
<td align="left" valign="top">Invalid subclass.</td>
</tr>
<tr>
<td align="left" valign="top">CPF0B37 E</td>
<td align="left" valign="top">Invalid type.</td>
</tr>
<tr>
<td align="left" valign="top">CPF0B46 E</td>
<td align="left" valign="top">Materialize failed.</td>
</tr>
<tr>
<td align="left" valign="top">CPF24B4 E</td>
<td align="left" valign="top">Severe error while addressing parameter
list.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C19 E</td>
<td align="left" valign="top">Error occurred with receiver variable
specified.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C21 E</td>
<td align="left" valign="top">Format name &amp;1 is not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C24 E</td>
<td align="left" valign="top">Length of the receiver variable is not
valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C90 E</td>
<td align="left" valign="top">Literal value cannot be changed.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3CF1 E</td>
<td align="left" valign="top">Error code parameter not valid.</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: V3R6
<hr>
<table align="center" cellpadding="2" cellspacing="2">
<tr align="center">
<td valign="middle" align="center"><a href="#Top_Of_Page">Top</a> | <a href=
"config.htm">Configuration APIs</a> | <a href="aplist.htm">API by
category</a></td>
</tr>
</table>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink