101 lines
5.2 KiB
HTML
101 lines
5.2 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>Process Open List 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 -->
|
||
|
|
<!-- CVTTOMIT SCRIPT A converted by B2H R4.1 (346) (CMS) by KENTALA -->
|
||
|
|
<!-- at RCHVMW2 on 7 Oct 1998 at 12:07:10 -->
|
||
|
|
<!-- File restructured for V5R2 -->
|
||
|
|
<!-- 031111 JETAYLOR replaced API and/or Exit listings with -->
|
||
|
|
<!-- pagegenerator output from javascript array -->
|
||
|
|
<!-- 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>
|
||
|
|
|
||
|
|
<h2>Process Open List APIs</h2>
|
||
|
|
|
||
|
|
<p>The process open list APIs are used to access the data returned by the open
|
||
|
|
list APIs. You can get list entries, find entry numbers in lists and in message
|
||
|
|
lists, find field numbers in lists, retrieve server job information, and close
|
||
|
|
lists. Some examples of these open list APIs are:</p>
|
||
|
|
|
||
|
|
<ul>
|
||
|
|
<li>Open List of Job Log Messages (QGYOLJBL)</li>
|
||
|
|
|
||
|
|
<li>Open List of Messages (QGYOLMSG)</li>
|
||
|
|
|
||
|
|
<li>Open List of Objects (QGYOLOBJ)</li>
|
||
|
|
|
||
|
|
<li>Open List of Objects to be Backed Up (QEZOLBKL)</li>
|
||
|
|
|
||
|
|
<li>Open List of Printers (QGYRPRTL)</li>
|
||
|
|
|
||
|
|
<li>Open List of Spooled Files (QGYOLSPL)</li>
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
<p>These list APIs can improve perceived performance when creating lists. The
|
||
|
|
APIs create and make available to the caller a partial listing of the total
|
||
|
|
set of files, messages, or objects. This list is immediately available to be
|
||
|
|
acted upon, while the remainder of the list is being created. The user does
|
||
|
|
not have to wait for the entire list to be created. </p>
|
||
|
|
<p><strong>Note:</strong>
|
||
|
|
When using Open List APIs, you should use the Close List API
|
||
|
|
to close any open lists after they have been processed and
|
||
|
|
are no longer needed.
|
||
|
|
This frees any internal storage associated with that list.
|
||
|
|
Failure to close open lists when finished may result in the
|
||
|
|
inability to process subsequent Open Lists APIs.
|
||
|
|
</p>
|
||
|
|
<p>The open list APIs are available only if the Host Servers option of i5/OS<SUP>(TM)</SUP>
|
||
|
|
is installed. You can install this option by using the GO LICPGM function of
|
||
|
|
i5/OS. Select the Install Licensed Programs option on the Work with Licensed
|
||
|
|
Programs display, and select the Host Servers option on the Install Licensed
|
||
|
|
Programs display. Beginning
|
||
|
|
with i5/OS (OS/400) Version 5 Release 3, these and other Open List APIs are available
|
||
|
|
in i5/OS. However, the Host Servers option may still be required
|
||
|
|
so that applications from previous releases continue to function properly. Routing programs
|
||
|
|
are provided with the Host Servers option to transfer requests to the corresponding
|
||
|
|
program in i5/OS.</p>
|
||
|
|
<p>The process open list 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="qgychgsj.htm">Change Server Job</A> (QGYCHGSJ) sets the maximum number of auxiliary server jobs allowed for a server job with the iSeries.</li>
|
||
|
|
<li><A HREF="qgyclst.htm">Close List</A> (QGYCLST) closes a previously opened list. Any internal storage associated with that list is freed.</li>
|
||
|
|
<li><A HREF="qgyfnde.htm">Find Entry Number in List</A> (QGYFNDE) returns the number of the entry in a list of information for a given key value.</li>
|
||
|
|
<li><A HREF="qgyfndme.htm">Find Entry Number in Message List</A> (QGYFNDME) returns the number of the entry in a list of message information for a given key value.</li>
|
||
|
|
<li><A HREF="qgyfndf.htm">Find Field Numbers in List</A> (QGYFNDF) returns the number of the entries in a list of information and the value of that entry whenever the value of that field changes.</li>
|
||
|
|
<li><A HREF="qgygtle.htm">Get List Entries</A> (QGYGTLE) allows requests to get entries from previously opened lists on the server.</li>
|
||
|
|
<li><A HREF="qgyrtvsj.htm">Retrieve Server Job Information</A> (QGYRTVSJ) returns information about auxiliary server jobs started for the current job to the system.</li>
|
||
|
|
</ul>
|
||
|
|
<!--***************API END PASTE***************-->
|
||
|
|
|
||
|
|
<hr>
|
||
|
|
<center>
|
||
|
|
<table cellpadding="2" cellspacing="2">
|
||
|
|
<tr align="center">
|
||
|
|
<td valign="middle" align="center">
|
||
|
|
<a href="#top">Top</a> |
|
||
|
|
<a href="aplist.htm">APIs by category</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
</center>
|
||
|
|
</body>
|
||
|
|
</html>
|
||
|
|
|