75 lines
4.6 KiB
HTML
75 lines
4.6 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>Hardware Resource APIs</title>
|
||
|
|
<!-- Begin Header Records ========================================== -->
|
||
|
|
<meta name="Copyright" content="Copyright (c) 2006 by IBM Corporation">
|
||
|
|
<!-- 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 Change description -->
|
||
|
|
<!-- 031106 JETAYLOR replaced API and/or Exit listings with -->
|
||
|
|
<!-- pagegenerator output from javascript array -->
|
||
|
|
<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>
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
<h2>Hardware Resource APIs</h2>
|
||
|
|
|
||
|
|
<p>The hardware resource APIs allow you to work with hardware resources. A
|
||
|
|
<strong>hardware resource</strong> is an addressable piece of hardware on the
|
||
|
|
system. A hardware resource is known to the system by its <strong>resource
|
||
|
|
name</strong>. A <strong>resource entry</strong> is the reference to the
|
||
|
|
hardware resource in the hardware resource information, which can be thought of
|
||
|
|
as a list of the hardware resources on the system.</p>
|
||
|
|
|
||
|
|
<p>Some of the hardware resource APIs use a first attempt and next attempts to
|
||
|
|
work with a list of items. The first attempt performs the requested action and
|
||
|
|
returns an indication of whether the action completed successfully or failed.
|
||
|
|
The next attempt repeats the requested action, continuing from the point in
|
||
|
|
which the previous attempt stopped. Through the use of attempts, an API that
|
||
|
|
returns items from a list can progress down the list, returning the items one
|
||
|
|
at a time.</p>
|
||
|
|
|
||
|
|
<p>The hardware resource APIs and their functions are:</p>
|
||
|
|
<!-- ***** NOTE ***** Do not manually update text or links in this section. -->
|
||
|
|
<!-- Updates made in this section *will* be overlaid by automated tools -->
|
||
|
|
<!-- Notify User Technologies of needed updates to be made in XML for API finder.-->
|
||
|
|
<!--***************API BEGIN PASTE***************-->
|
||
|
|
<ul>
|
||
|
|
<li><A HREF="qrzchge.htm">Change Resource Entry Information</A> (QRZCHGE) allows you to change the name of the resource and to do resource mapping.</li>
|
||
|
|
<li><A HREF="qrzcrth.htm">Create Handle</A> (QRZCRTH) creates a handle that is used as a placeholder when accessing items in a list using the<em>next</em>option.</li>
|
||
|
|
<li><A HREF="qrzdlth.htm">Delete Handle</A> (QRZDLTH) deletes a handle that was created using the Create Handle (QRZCRTH) API.</li>
|
||
|
|
<li><A HREF="qrzdlte.htm">Delete Resource Entry</A> (QRZDLTE) deletes a resource entry.</li>
|
||
|
|
<li><A HREF="qgyrhri.htm">Retrieve Hardware Resource Information</A> (QGYRHRI, QgyRtvHdwRscInfo) retrieves hardware resource information fields that provide a detailed description of the resource that is identified by the resource name parameter.</li>
|
||
|
|
<li><A HREF="qgyrhrl.htm">Retrieve Hardware Resource List</A> (QGYRHRL, QgyRtvHdwRscList) retrieves a list of hardware resource names and other hardware resource information fields.</li>
|
||
|
|
<li><A HREF="qrzrtvr.htm">Retrieve Hardware Resource Relative</A> (QRZRTVR) retrieves the resource name of a family member that matches the request criteria. The resource name then can be used to obtain more information about a specific hardware resource.</li>
|
||
|
|
<li><A HREF="qrzrrca.htm">Retrieve Resource Class Attributes</A> (QRZRRCA) retrieves class-specific information or object type values for a logical resource.</li>
|
||
|
|
<li><A HREF="qrzrrsi.htm">Retrieve Resource Information</A> (QRZRRSI) retrieves selected fields of a hardware resource from a known resource name.</li>
|
||
|
|
<li><A HREF="qrzsche.htm">Search Hardware Resource Entry</A> (QRZSCHE) retrieves the resource name of a hardware resource that matches the request criteria. The resource name can be used with other hardware resource APIs to get more information about a specific hardware resource.</li>
|
||
|
|
</ul>
|
||
|
|
<!--***************API END PASTE***************-->
|
||
|
|
<hr>
|
||
|
|
<center>
|
||
|
|
<table 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">APIs by category</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
</center>
|
||
|
|
</body>
|
||
|
|
</html>
|