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

186 lines
5.0 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>End DASD Management Operation (QYASEDMO) 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. -->
<!-- WM SCRIPT A converted by B2H R4.1 (346) (CMS) by V2KEA304 -->
<!-- at RCHVMW2 on 17 Feb 1999 at 11:05:09 -->
<!-- Change History: -->
<!-- YYMMDD USERID Change description -->
<!-- File cleanup completed Oct 2001 by v2cdijab -->
<!-- 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>End DASD Management Operation (QYASEDMO) API</h2>
<div class="box" style="width: 60%;">
<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%">Session handle</td>
<td align="left" valign="top" width="20%">Input</td>
<td align="left" valign="top" width="20%">Char(8)</td>
</tr>
<tr>
<td align="center" valign="top">2</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: Yes<br>
<!-- iddvc RMBR -->
<br>
</div>
<p>The End DASD Management Operation (QYASEDMO) API attempts to cancel an
active operation of an active disk management session that was previously
started using the Start DASD Management Operation (QYASSDMO) API.</p>
<br>
<h3>Authorities and Locks</h3>
<p>To use this API, you must have *SERVICE special authority or be authorized
to the Service Disk Units function of Operating System/400 through iSeries
Navigator's Application Administration support. The Change Function Usage
Information (QSYCHFUI) API, with a function ID of QIBM_QYAS_SERVICE_DISKMGMT,
also can be used to change the list of users who are allowed to work with disk
units.</p>
<br>
<h3>Required Parameter Group</h3>
<dl>
<dt><strong>Session handle</strong></dt>
<dd>INPUT; CHAR(8)
<p>The 8-byte field containing a unique ID that was used on a preceding Start
DASD Management Operation (QYASDMO) API for the operation that is to be ended.
The session handle contains arbitrary binary data and should not be interpreted
as character data.</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>Error Messages</h3>
<table width="100%" cellpadding="5">
<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%">CPF2277 E</td>
<td align="left" valign="top" width="85%">User &amp;1 not allowed to use
function &amp;2.</td>
</tr>
<tr>
<td align="left" valign="top">CPFBA20 E</td>
<td align="left" valign="top">Session handle not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPFBA25 E</td>
<td align="left" valign="top">A general DASD management error has
occurred.</td>
</tr>
<tr>
<td align="left" valign="top">CPFBA45 E</td>
<td align="left" valign="top">Cannot end operation.</td>
</tr>
<tr>
<td align="left" valign="top">CPFBA46 E</td>
<td align="left" valign="top">No operation in progress.</td>
</tr>
<tr>
<td align="left" valign="top">CPFBA47 E</td>
<td align="left" valign="top">Session not active.</td>
</tr>
<tr>
<td align="left" valign="top">CPFBA48 E</td>
<td align="left" valign="top">Operation failed with unrecognized return code,
&amp;1.</td>
</tr>
<tr>
<td align="left" valign="top">CPFBA53 E</td>
<td align="left" valign="top">Unexpected authority validation error has
occurred.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C36 E</td>
<td align="left" valign="top">Number of parameters, &amp;1, entered for this
API was not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3CF1 E</td>
<td align="left" valign="top">Error code parameter not valid.</td>
</tr>
</table>
<br>
<hr>
API introduced: V4R5
<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>