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

185 lines
5.2 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<!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>Define Heap Allocation Strategy (CEE4DAS) 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 Change description -->
<!-- ILE8A SCRIPT A converted by B2H R4.1 (346) (CMS) by NLJONES at -->
<!-- RCHVMX on 25 Feb 1999 at 15:15:15 -->
<!-- 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>Define Heap Allocation Strategy (CEE4DAS) API</h2>
<div class="box" style="width: 65%;">
<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="40%">alloc_strat_id</td>
<td align="left" valign="top" width="15%">Input</td>
<td align="left" valign="top" width="15%">INT4</td>
</tr>
<tr>
<td align="center" valign="top">2</td>
<td align="left" valign="top">alloc_strat_in</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">CEE4ALC</td>
</tr>
</table>
<br>
&nbsp;&nbsp;Omissible Parameter Group:<br>
<!-- iddvc RMBR -->
<br>
<table width="100%">
<tr>
<td align="center" valign="top" width="10%">3</td>
<td align="left" valign="top" width="40%">alloc_strat_out</td>
<td align="left" valign="top" width="15%">Output</td>
<td align="left" valign="top" width="15%">CEE4ALC</td>
</tr>
<tr>
<td align="center" valign="top">4</td>
<td align="left" valign="top">fc</td>
<td align="left" valign="top">Output</td>
<td align="left" valign="top">FEEDBACK</td>
</tr>
</table>
<br>
&nbsp;&nbsp;Service Program Name: QLEAWI<br>
<!-- iddvc RMBR -->
<br>
&nbsp;&nbsp;Default Public Authority: *USE<br>
<!-- iddvc RMBR -->
<br>
&nbsp;&nbsp;Threadsafe: Yes<br>
<!-- iddvc RMBR -->
<br>
</div>
<p>The Define Heap Allocation Strategy (CEE4DAS) API defines a system-specific
allocation strategy and associates the defined strategy with a specified
allocation strategy identifier. When creating a heap using the CEECRHP API, the
allocation strategy identifier can be used within the activation group in which
it was defined.</p>
<!-- Please NOTE: DO NOT DELETE THIS SECTION if this API has no authorities and locks. -->
<!-- Instead, use the commented out coding below to indicate NONE. -->
<h3>Authorities and Locks</h3>
<!-- Use this if there are no authorities and locks. -->
<p>None.</p>
<br>
<h3>Required Parameter Group</h3>
<dl>
<dt><strong>alloc_strat_ID (input)</strong></dt>
<dd>The allocation strategy identifier being defined. The valid values are 40
through 44.<br>
<br>
</dd>
<dt><strong>alloc_strat_in (input)</strong></dt>
<dd>A structure of allocation strategy type CEE4ALC that defines the new
allocation strategy to be assigned to the specified allocation strategy
identifier. See <a href="CEE4ALC.htm">Allocation Strategy Type (CEE4ALC)</a>
for a description.</dd>
</dl>
<br>
<h3>Omissible Parameter Group</h3>
<dl>
<dt><strong>alloc_strat_out (output)</strong></dt>
<dd>An optional structure of type CEE4ALC that will be set to the value of the
previous allocation strategy that was assigned to the specified allocation
strategy identifier. If no previous allocation strategy was assigned, the
default allocation strategy is returned. See <a href=
"CEE4ALC.htm#HDRDEFHP">User-Defined Allocation Strategy</a> for more
information.<br>
<br>
</dd>
<dt><strong>fc (output)</strong></dt>
<dd>A 12-byte feedback code.</dd>
</dl>
<br>
<h3>Feedback Codes and Conditions</h3>
<table cellpadding="3">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top">CEE0000</td>
<td align="left" valign="top">The API completed successfully</td>
</tr>
<tr>
<td align="left" valign="top">Severity: 00</td>
<td align="left" valign="top">&nbsp;</td>
</tr>
<tr>
<td align="left" valign="top">CEE0816</td>
<td align="left" valign="top">The allocation strategy identifier is out of
range</td>
</tr>
<tr>
<td align="left" valign="top">Severity: 30</td>
<td align="left" valign="top">&nbsp;</td>
</tr>
</table>
<br>
<h3>Usage Notes</h3>
<p>The CEE4DAS API does not perform a validity check on the contents of
<em>alloc_strat_in</em>. When the defined allocation strategy is used, checking
is enforced by the CEECRHP API.</p>
<hr>
API introduced: V2R3
<hr>
<center>
<table cellpadding="2" cellspacing="2">
<tr align="center">
<td valign="middle" align="center"><a href="#Top_Of_Page">Top</a> | <a href=
"ile1a1.htm">ILE CEE APIs</a> | <a href="aplist.htm">APIs by category</a></td>
</tr>
</table>
</center>
</body>
</html>