103 lines
5.6 KiB
HTML
103 lines
5.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>Disk Management APIs</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 Change description -->
|
||
|
|
<!-- 031104 JETAYLOR replaced API and Exit listings with -->
|
||
|
|
<!-- pagegenerator output from javascript array -->
|
||
|
|
<!-- End Header Records -->
|
||
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
||
|
|
</head>
|
||
|
|
<body>
|
||
|
|
<!-- End Header Records -->
|
||
|
|
<!--Java sync-link-->
|
||
|
|
<script type="text/javascript" language="Javascript" src="../rzahg/synch.js">
|
||
|
|
</script>
|
||
|
|
|
||
|
|
<a name="Top_Of_Page"></a>
|
||
|
|
|
||
|
|
<h2>Disk Management APIs</h2>
|
||
|
|
|
||
|
|
<p>The Disk Management APIs provide basic control of disk units in the system.
|
||
|
|
These APIs can be used to perform a variety of actions, such as changing the
|
||
|
|
storage threshold for an auxiliary storage pool (ASP), adding a disk unit to an
|
||
|
|
ASP, resuming protection on a disk unit, and formatting a disk unit. In
|
||
|
|
general, these actions represent the disk management options available through
|
||
|
|
the Work with Disk Units menu options from the i5/OS<SUP>(R)</SUP> command to Start a
|
||
|
|
Service Tool (STRSST). The Start DASD Management Operation (QYASSDMO) API
|
||
|
|
provides a complete list of DASD management configuration actions.</p>
|
||
|
|
|
||
|
|
<p>The Retrieve DASD Management Information (QYASRDI) API and Open List of ASPs
|
||
|
|
(QYASPOL) API return general information. These APIs do not require a disk
|
||
|
|
management session handle.</p>
|
||
|
|
|
||
|
|
<p>The remaining APIs use a configuration session between the system disk
|
||
|
|
manager and the configuration application. This session handle must be reserved
|
||
|
|
using the Start DASD Management Session (QYASSDMS) API. The system disk manager
|
||
|
|
supports only one active session at a time. The Work with Disk Units options
|
||
|
|
under Dedicated Service Tools (DST) and System Service Tools (SST), the
|
||
|
|
iSeries<SUP>(TM)</SUP> Navigator disk management client, and all other applications
|
||
|
|
performing disk operations require a session to perform their requests.
|
||
|
|
Therefore, it is important that applications use End DASD management Session
|
||
|
|
(QYASEDMS) to release that session when all operations are complete.</p>
|
||
|
|
|
||
|
|
<p>Most disk management operations require a handle to a previously reserved
|
||
|
|
configuration session. The Start DASD Management Operation (QYASSDMO) API
|
||
|
|
initiates an action. Most operations run to completion and return completion
|
||
|
|
status on the start request. Some operations require a longer period of time in
|
||
|
|
which to execute. These long-running operations return immediately, but must be
|
||
|
|
checked for operation completion. The Retrieve DASD Management Status
|
||
|
|
(QYASRDMS) API allows an application to check for status on a long-running
|
||
|
|
operation. The End DASD Management Operation (QYASEDMO) provides a cancel
|
||
|
|
mechanism. It is the responsibility of the application to know which operations
|
||
|
|
return status immediately and which applications require additional status
|
||
|
|
checking.</p>
|
||
|
|
|
||
|
|
<p>
|
||
|
|
For information regarding how to work with disk units, auxiliary storage
|
||
|
|
pools, and storage protection, see the <a href="../rzaly/rzalydmkickoff.htm">
|
||
|
|
Disk management</a> topic and
|
||
|
|
the
|
||
|
|
<a href="../bookssc415304.pdf" target="_blank">Backup and
|
||
|
|
Recovery</a><img src="wbpdf.gif" alt="Link to PDF"> book.
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<p>The Disk Management APIs 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><img src="delta.gif" alt="Start of change" border="0"><A HREF="qyaspctlaa.htm">Control ASP Access </A> (QYASPCTLAA) enables exclusive use on an IASP. <img src="deltaend.gif" ALT="End of change" border="0"></li>
|
||
|
|
<li><A HREF="qyasedmo.htm">End DASD Management Operation</A> (QYASEDMO) ends an active operation.</li>
|
||
|
|
<li><A HREF="qyasedms.htm">End DASD Management Session</A> (QYASEDMS) releases a client's reservation.</li>
|
||
|
|
<li><A HREF="qyasrdi.htm">Retrieve DASD Information</A> (QYASRDI) retrieves disk unit information.</li>
|
||
|
|
<li><A HREF="qyasrdms.htm">Retrieve DASD Management Status</A> (QYASRDMS) retrieves status information for an active operation.</li>
|
||
|
|
<li><img src="delta.gif" alt="Start of change" border="0"><A HREF="qyaspprbdy.htm">Set Pointer Reset Boundary</A> (QYASPPRBDY) sets a boundary for SYSBAS to IASP pointers. <img src="deltaend.gif" ALT="End of change" border="0"></li>
|
||
|
|
<li><A HREF="qyassdmo.htm">Start DASD Management Operation</A> (QYASSDMO) requests the disk manager to perform an operation.</li>
|
||
|
|
<li><A HREF="qyassdms.htm">Start DASD Management Session</A> (QYASSDMS) reserves the disk manager for a specific client.</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>
|