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

111 lines
3.7 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>Auxiliary Storage Lower Limit Exit Program</title>
<!-- 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. -->
<!-- Begin Header Records ========================================= -->
<!-- WM SCRIPT A converted by B2H R4.1 (346) (CMS) by V2KEA304 -->
<!-- at RCHVMW2 on 17 Feb 1999 at 11:05:09 -->
<!-- File cleanup completed Nov 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>Auxiliary Storage Lower Limit Exit Program</h2>
<div class="box" style="width: 60%;">
<br>
&nbsp;&nbsp;Required Parameter: None<br>
<!-- iddvc RMBR -->
<br>
&nbsp;&nbsp;Exit Point Name: QIBM_QWC_QSTGLOWACN&nbsp;&nbsp;<br>
<!-- iddvc RMBR -->
<br>
&nbsp;&nbsp;Exit Point Format Name: STGL0100<br>
<!-- iddvc RMBR -->
<br>
</div>
<p>The Auxiliary Storage Lower Limit exit program is called when the available
storage in the system auxiliary storage pool (ASP) goes below the lower limit.
The exit program is called only if the QSTGLOWACN system value is set to
*REGFAC. The lower limit is specified by the QSTGLOWLMT system value.</p>
<p>When the storage lower limit is reached, the operating system submits a job
that calls the user-written exit program through the registration facility.
There are no input or output parameters.</p>
<p>This exit point supports any number of exit programs. (For information about
adding an exit program to an exit point, see the <a href=
"reg1.htm">Registration Facility APIs</a>.)</p>
<p>If available storage in the system ASP is still below the auxiliary storage
lower limit after the exit program has completed, another job is submitted to
call the exit program after half an hour. (Changing the QSTGLOWACN and
QSTGLOWLMT system values can cause the exit program to run again during this
time.) Otherwise, the exit program will be called when available storage goes
below the limit again.</p>
<p>The job is submitted to run in the QSYSWRK subsystem (using the QSYSJOBD job
description) under the QPGMR user profile. No other action is taken if the job
does not run.</p>
<p><strong>Notes:</strong></p>
<ol>
<li>The Auxiliary Storage Lower Limit exit point ignores any return codes or
error messages that are sent from the exit programs.<br><br></li>
<li>It is recommended that the Auxiliary Storage Lower Limit exit program exist
in a library in the system ASP or in a basic user ASP. It will not be found if
it exists in a library in an independent ASP.</li>
</ol>
<br>
<h3>Authorities and Locks</h3>
<dl>
<dt><em>User Profile Authority</em></dt>
<dd>All object (*ALLOBJ) and security administrator (*SECADM)
special authorities are needed
to add exit programs to the registration facility
or to remove exit programs from the registration facility.</dd>
</dl>
<br>
<h3>Required Parameter</h3>
<p>None.</p>
<hr>
Exit program introduced: V4R2
<hr>
<center>
<table cellpadding="2" cellspacing="2">
<tr align="center">
<td valign="middle" align="center"><a href="#Top_Of_Page">Top</a> | <a href=
"wm1.htm">Work Management APIs</a> | <a href="aplist.htm">APIs by
category</a></td>
</tr>
</table>
</center>
</body>
</html>