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

935 lines
23 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>Open List of Printers (QGYRPRTL) 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. -->
<!-- Print 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 Edited by Kersten Oct 2001 -->
<!--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 language="Javascript" src="../rzahg/synch.js" type="text/javascript">
</script>
<h2>Open List of Printers (QGYRPRTL) API</h2>
<div class="box" style="width: 75%;">
<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%">Receiver variable</td>
<td align="left" valign="top" width="20%">Output</td>
<td align="left" valign="top" width="20%">Char(*)</td>
</tr>
<tr>
<td align="center" valign="top">2</td>
<td align="left" valign="top">Length of receiver variable</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Binary(4)</td>
</tr>
<tr>
<td align="center" valign="top">3</td>
<td align="left" valign="top">List information</td>
<td align="left" valign="top">Output</td>
<td align="left" valign="top">Char(80)</td>
</tr>
<tr>
<td align="center" valign="top">4</td>
<td align="left" valign="top">Number of records to return</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Binary(4)</td>
</tr>
<tr>
<td align="center" valign="top">5</td>
<td align="left" valign="top">Filter information</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Char(*)</td>
</tr>
<tr>
<td align="center" valign="top">6</td>
<td align="left" valign="top">Format name</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Char(8)</td>
</tr>
<tr>
<td align="center" valign="top">7</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: No<br>
<!-- iddvc RMBR -->
<br>
</div>
<p>The Open List of Printers (QGYRPRTL) API generates a list of printers on the
system and information about the printers. The list can include all printers on
the system, a specific list of printers, or the printers for a single output
queue. The list will be sorted by printer name.</p>
<p><strong>Note:</strong> The QTEMP library and the system portion of the
library list could be different between the main job and the server job when
the list is being built asynchronously. If this is a problem, then request that
the list be built synchronously.</p>
<p>For more information, see <a href="misc1b.htm">Process Open List
APIs</a></p>
<br>
<h3>Authorities and Locks</h3>
<p>None.</p>
<br>
<h3>Required Parameter Group</h3>
<dl>
<dt><strong>Receiver variable</strong></dt>
<dd>OUTPUT; CHAR(*)
<p>The receiver variable that receives the information requested. You can
specify the size of the area to be smaller than the format requested as long as
you specify the length parameter correctly. As a result, the API returns only
the data that the area can hold.</p>
</dd>
<dt><strong>Length of receiver variable</strong></dt>
<dd>INPUT; BINARY(4)
<p>The length of the receiver variable provided. The length of receiver
variable parameter may be specified up to the size of the receiver variable
specified in the user program. If the length of receiver variable parameter
specified is larger than the allocated size of the receiver variable specified
in the user program, the results are not predictable. The minimum length is 8
bytes.</p>
</dd>
<dt><strong>List information</strong></dt>
<dd>OUTPUT; CHAR(80)
<p>The variable used to return status information about the list of printers
that were opened. For a description of the layout of this parameter, see <a
href="../apiref/oli.htm">Format of Open List Information</a>.</p>
</dd>
<dt><strong>Number of records to return</strong></dt>
<dd>INPUT; BINARY(4)
<p>The number of records in the list to put into the receiver variable after
the filtering and sorting is done.</p>
<p>If the value zero is specified, only the list information is returned and no
actual list entries are returned.</p>
</dd>
<dt><strong>Filter information</strong></dt>
<dd>INPUT; CHAR(*)
<p>The information in this parameter is used to determine which printers to
include in the list. Printers can be filtered based on printer name, output
queue name, or both. See <a href="#HDRRPRTLFI">Format of Filter Information</a>
for a description of the layout of this parameter.</p>
</dd>
<dt><strong>Format name</strong></dt>
<dd>INPUT; CHAR(8)
<p>The format of the printer information being returned.</p>
<p>You must specify one of the following:</p>
<table cellpadding="5">
<!-- cols="35 65" -->
<tr>
<td valign="top"><em><a href="#HDRPRTL100">PRTL0100</a></em></td>
<td valign="top">The basic information about the printer.</td>
</tr>
<tr>
<td valign="top"><em><a href="#HDRPRTL200">PRTL0200</a></em></td>
<td valign="top">All the information in format PRTL0100 plus additional
information about the output queue and the writer for the printer, and
information about the spooled file currently being printed.</td>
</tr>
</table>
<br>
</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>Format of Receiver Variable</h3>
<p>The following tables describe the order and format of the data that is
returned in the receiver variable.</p>
<br>
<h4><a name="HDRPRTL100">Format PRTL0100</a></h4>
<table border width="80%">
<tr>
<th align="center" valign="bottom" colspan="2">Offset</th>
<th align="left" valign="bottom" rowspan="2">Type</th>
<th align="left" valign="bottom" rowspan="2">Field</th>
</tr>
<tr>
<th align="center" valign="bottom">Dec</th>
<th align="center" valign="bottom">Hex</th>
</tr>
<tr>
<td align="center" valign="top" width="10%">0</td>
<td align="center" valign="top" width="10%">0</td>
<td align="left" valign="top" width="20%">CHAR(10)</td>
<td align="left" valign="top" width="60%">Device name</td>
</tr>
<tr>
<td align="center" valign="top">10</td>
<td align="center" valign="top">A</td>
<td align="left" valign="top">CHAR(50)</td>
<td align="left" valign="top">Text description</td>
</tr>
<tr>
<td align="center" valign="top">60</td>
<td align="center" valign="top">3C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Overall status</td>
</tr>
</table>
<br>
<br>
<h4><a name="HDRPRTL200">Format PRTL0200</a></h4>
<table border width="80%">
<tr>
<th align="center" valign="bottom" colspan="2">Offset</th>
<th align="left" valign="bottom" rowspan="2">Type</th>
<th align="left" valign="bottom" rowspan="2">Field</th>
</tr>
<tr>
<th align="center" valign="bottom">Dec</th>
<th align="center" valign="bottom">Hex</th>
</tr>
<tr>
<td align="center" valign="top" width="10%">0</td>
<td align="center" valign="top" width="10%">0</td>
<td align="left" valign="top" width="20%">CHAR(10)</td>
<td align="left" valign="top" width="60%">Device name</td>
</tr>
<tr>
<td align="center" valign="top">10</td>
<td align="center" valign="top">A</td>
<td align="left" valign="top">CHAR(50)</td>
<td align="left" valign="top">Text description</td>
</tr>
<tr>
<td align="center" valign="top">60</td>
<td align="center" valign="top">3C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Overall status</td>
</tr>
<tr>
<td align="center" valign="top">64</td>
<td align="center" valign="top">40</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Device status</td>
</tr>
<tr>
<td align="center" valign="top">68</td>
<td align="center" valign="top">44</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Output queue name</td>
</tr>
<tr>
<td align="center" valign="top">78</td>
<td align="center" valign="top">4E</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Output queue library</td>
</tr>
<tr>
<td align="center" valign="top">88</td>
<td align="center" valign="top">58</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Output queue status</td>
</tr>
<tr>
<td align="center" valign="top">89</td>
<td align="center" valign="top">59</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Writer name</td>
</tr>
<tr>
<td align="center" valign="top">99</td>
<td align="center" valign="top">63</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Writer status</td>
</tr>
<tr>
<td align="center" valign="top">100</td>
<td align="center" valign="top">64</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Writer started</td>
</tr>
<tr>
<td align="center" valign="top">101</td>
<td align="center" valign="top">65</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Form type</td>
</tr>
<tr>
<td align="center" valign="top">111</td>
<td align="center" valign="top">6F</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Current file name</td>
</tr>
<tr>
<td align="center" valign="top">121</td>
<td align="center" valign="top">79</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Current file user</td>
</tr>
<tr>
<td align="center" valign="top">131</td>
<td align="center" valign="top">83</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Current file user-specified data</td>
</tr>
<tr>
<td align="center" valign="top">141</td>
<td align="center" valign="top">8D</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Network directory publishing status</td>
</tr>
</table>
<br>
<br>
<h3>Field Descriptions</h3>
<p><strong>Current file name.</strong> The name of the spooled file currently
being processed by the writer. This field is blank when no file is
printing.</p>
<p><strong>Current file user.</strong> The name of the user who owns the
spooled file currently being processed by the writer. This field is blank when
no file is printing.</p>
<p><strong>Current file user-specified data.</strong> The user-specified data
that describes the file currently being processed by the writer.</p>
<p><strong>Device name.</strong> The name of the printer device.</p>
<p><strong>Device status.</strong> The status of the printer device using two
fields:</p>
<p><strong>Note:</strong> Not all of the following values apply to printer
devices.</p>
<table cellpadding="5" width="50%">
<!-- cols="15 85" -->
<tr>
<th align="left" valign="bottom">Status Numeric<br>
Code (decimal)</th>
<th align="left" valign="bottom">Overall Status</th>
</tr>
<tr>
<td align="left" valign="top">0</td>
<td align="left" valign="top">VARIED OFF</td>
</tr>
<tr>
<td align="left" valign="top">5</td>
<td align="left" valign="top">AS/36 DISABLED</td>
</tr>
<tr>
<td align="left" valign="top">10</td>
<td align="left" valign="top">VARY OFF PENDING</td>
</tr>
<tr>
<td align="left" valign="top">20</td>
<td align="left" valign="top">VARY ON PENDING</td>
</tr>
<tr>
<td align="left" valign="top">30</td>
<td align="left" valign="top">VARIED ON</td>
</tr>
<tr>
<td align="left" valign="top">40</td>
<td align="left" valign="top">CONNECT PENDING</td>
</tr>
<tr>
<td align="left" valign="top">50</td>
<td align="left" valign="top">SIGNON DISPLAY</td>
</tr>
<tr>
<td align="left" valign="top">60</td>
<td align="left" valign="top">ACTIVE</td>
</tr>
<tr>
<td align="left" valign="top">62</td>
<td align="left" valign="top">AS/36 ENABLED</td>
</tr>
<tr>
<td align="left" valign="top">63</td>
<td align="left" valign="top">ACTIVE READER</td>
</tr>
<tr>
<td align="left" valign="top">66</td>
<td align="left" valign="top">ACTIVE WRITER</td>
</tr>
<tr>
<td align="left" valign="top">70</td>
<td align="left" valign="top">HELD</td>
</tr>
<tr>
<td align="left" valign="top">75</td>
<td align="left" valign="top">POWERED OFF</td>
</tr>
<tr>
<td align="left" valign="top">80</td>
<td align="left" valign="top">RCYPND</td>
</tr>
<tr>
<td align="left" valign="top">90</td>
<td align="left" valign="top">RCYCNL</td>
</tr>
<tr>
<td align="left" valign="top">95</td>
<td align="left" valign="top">SYSTEM REQUEST</td>
</tr>
<tr>
<td align="left" valign="top">100</td>
<td align="left" valign="top">FAILED</td>
</tr>
<tr>
<td align="left" valign="top">103</td>
<td align="left" valign="top">FAILED READER</td>
</tr>
<tr>
<td align="left" valign="top">106</td>
<td align="left" valign="top">FAILED WRITER</td>
</tr>
<tr>
<td align="left" valign="top">110</td>
<td align="left" valign="top">DIAGNOSTIC MODE</td>
</tr>
<tr>
<td align="left" valign="top">111</td>
<td align="left" valign="top">DAMAGED</td>
</tr>
<tr>
<td align="left" valign="top">112</td>
<td align="left" valign="top">LOCKED</td>
</tr>
<tr>
<td align="left" valign="top">113</td>
<td align="left" valign="top">UNKNOWN</td>
</tr>
</table>
<br>
<p><strong>Form type.</strong> The type of form being used to print the spooled
file.</p>
<p>Possible values are:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*ALL</em></td>
<td align="left" valign="top">The writer is started with the option to print
all spooled files of any form type.<br>
<br>
</td>
</tr>
<tr>
<td align="left" valign="top"><em>*FORMS</em></td>
<td align="left" valign="top">The writer is started with the option to print
all the spooled files with the same form type before using a different form
type.<br>
<br>
</td>
</tr>
<tr>
<td align="left" valign="top"><em>*STD</em></td>
<td align="left" valign="top">The writer is started with the option to print
all the spooled files with a form type of *STD.<br>
<br>
</td>
</tr>
<tr>
<td align="left" valign="top"><em>Form type name</em></td>
<td align="left" valign="top">The writer is started with the option to print
all the spooled files with the form type you specified.</td>
</tr>
</table>
<br>
<p><strong>Network directory publishing stastus.</strong> Whether the printer
is published in the network directory. Possible values are:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">Printer is not published</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">Printer is published</td>
</tr>
</table>
<p><strong>Output queue library name.</strong> The name of the library that
contains the output queue from which spooled files are selected for
printing.</p>
<p><strong>Output queue name.</strong> The name of the output queue from which
spooled files are being selected for printing.</p>
<p><strong>Output queue status.</strong> The status of the output queue from
which spooled files are being selected for printing.</p>
<p>Possible values are:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>H</em></td>
<td align="left" valign="top">The output queue is held.</td>
</tr>
<tr>
<td align="left" valign="top"><em>R</em></td>
<td align="left" valign="top">The output queue is released.</td>
</tr>
</table>
<p><strong>Overall status.</strong> The overall status of the logical printer.
Possible values are:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">Unavailable</td>
</tr>
<tr>
<td align="left" valign="top"><em>2</em></td>
<td align="left" valign="top">Powered off or not yet available</td>
</tr>
<tr>
<td align="left" valign="top"><em>3</em></td>
<td align="left" valign="top">Stopped</td>
</tr>
<tr>
<td align="left" valign="top"><em>4</em></td>
<td align="left" valign="top">Message waiting</td>
</tr>
<tr>
<td align="left" valign="top"><em>5</em></td>
<td align="left" valign="top">Held</td>
</tr>
<tr>
<td align="left" valign="top"><em>6</em></td>
<td align="left" valign="top">Stop (pending)</td>
</tr>
<tr>
<td align="left" valign="top"><em>7</em></td>
<td align="left" valign="top">Hold (pending)</td>
</tr>
<tr>
<td align="left" valign="top"><em>8</em></td>
<td align="left" valign="top">Waiting for printer</td>
</tr>
<tr>
<td align="left" valign="top"><em>9</em></td>
<td align="left" valign="top">Waiting to start</td>
</tr>
<tr>
<td align="left" valign="top"><em>10</em></td>
<td align="left" valign="top">Printing</td>
</tr>
<tr>
<td align="left" valign="top"><em>11</em></td>
<td align="left" valign="top">Waiting for printer output</td>
</tr>
<tr>
<td align="left" valign="top"><em>12</em></td>
<td align="left" valign="top">Connect pending</td>
</tr>
<tr>
<td align="left" valign="top"><em>13</em></td>
<td align="left" valign="top">Powered off</td>
</tr>
<tr>
<td align="left" valign="top"><em>14</em></td>
<td align="left" valign="top">Unusable</td>
</tr>
<tr>
<td align="left" valign="top"><em>15</em></td>
<td align="left" valign="top">Being serviced</td>
</tr>
<tr>
<td align="left" valign="top"><em>999</em></td>
<td align="left" valign="top">Unknown</td>
</tr>
</table>
<br>
<p><strong>Text description.</strong> The text description of the printer
device.</p>
<p><strong>Writer name.</strong> The name of the writer for this printer.</p>
<p><strong>Writer started.</strong> Indication of whether or not a writer is
started for this printer. Possible values are:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">No writer is started</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">Writer is started</td>
</tr>
</table>
<br>
<p><strong>Writer status.</strong> The status of the writer for this printer.
Possible values are:</p>
<table cellpadding="5">
<!-- cols="10 90" -->
<tr>
<td align="left" valign="top"><em>X'01'</em></td>
<td align="left" valign="top">Started</td>
</tr>
<tr>
<td align="left" valign="top"><em>X'02'</em></td>
<td align="left" valign="top">Ended</td>
</tr>
<tr>
<td align="left" valign="top"><em>X'03'</em></td>
<td align="left" valign="top">On job queue</td>
</tr>
<tr>
<td align="left" valign="top"><em>X'04'</em></td>
<td align="left" valign="top">Held</td>
</tr>
<tr>
<td align="left" valign="top"><em>X'05'</em></td>
<td align="left" valign="top">Message waiting</td>
</tr>
</table>
<br>
<h3><a name="HDRRPRTLFI">Format of Filter Information</a></h3>
<table border width="80%">
<tr>
<th align="center" valign="bottom" colspan="2">Offset</th>
<th align="left" valign="bottom" rowspan="2">Type</th>
<th align="left" valign="bottom" rowspan="2">Field</th>
</tr>
<tr>
<th align="center" valign="bottom">Dec</th>
<th align="center" valign="bottom">Hex</th>
</tr>
<tr>
<td align="center" valign="top" width="10%">0</td>
<td align="center" valign="top" width="10%">0</td>
<td align="left" valign="top" width="20%">BINARY(4)</td>
<td align="left" valign="top" width="60%">Number of printer names</td>
</tr>
<tr>
<td align="left" valign="top" rowspan="2" colspan="2">Offsets vary. These
fields repeat, in the order listed, for each printer to filter on.</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Printer name</td>
</tr>
<tr>
<td align="left" valign="top">CHAR(2)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="left" valign="top" colspan="2">Offset varies.</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Number of output queues</td>
</tr>
<tr>
<td align="left" valign="top" rowspan="2" colspan="2">Offsets vary. These
fields repeat, in the order listed, for each output queue to filter on.</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Output queue</td>
</tr>
<tr>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Output queue library</td>
</tr>
</table>
<br>
<p>When no filter is to be done, the filter specification must be two BINARY(4)
values set to zero.</p>
<br>
<h3>Field Descriptions</h3>
<p><strong>Number of output queues.</strong> The total number of output queue
names in the output queue name array.</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">Does not filter by output queue</td>
</tr>
<tr>
<td align="left" valign="top"><em>1-1000</em></td>
<td align="left" valign="top">Filters the specified number of output queue
names</td>
</tr>
</table>
<br>
<p><strong>Number of printer names.</strong> The total number of printer device
names in the printer names array.</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">Does not filter by printer name</td>
</tr>
<tr>
<td align="left" valign="top"><em>1-1000</em></td>
<td align="left" valign="top">Filters the specified number of printer
names</td>
</tr>
</table>
<br>
<p><strong>Output queue.</strong> The name of an output queue to be included in
the list.</p>
<p><strong>Output queue library.</strong> The name of the library that contains
the output queue.</p>
<p><strong>Printer name.</strong> The name of a printer to be included in the
list.</p>
<br>
<h3>Error Messages</h3>
<table width="100%" cellpadding="5">
<!-- cols="15 85" -->
<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">CPF24B4 E</td>
<td align="left" valign="top">Severe error while addressing parameter list.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C19 E</td>
<td align="left" valign="top">Error occurred with receiver variable specified.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C21 E</td>
<td align="left" valign="top">Format name &amp;1 is not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C90 E</td>
<td align="left" valign="top">Literal value cannot be changed.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3CF1 E</td>
<td align="left" valign="top">Error code parameter not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9872 E</td>
<td align="left" valign="top">Program or service program &amp;1 in library &amp;2 ended.
Reason code &amp;3.</td>
</tr>
<tr>
<td align="left" valign="top">GUI0027 E</td>
<td align="left" valign="top">&amp;1 is not valid for number of records to return.</td>
</tr>
<tr>
<td align="left" valign="top">GUI0108 E</td>
<td align="left" valign="top">Filter information is not valid. Reason code &amp;1.</td>
</tr>
</table>
<br>
<hr>
API introduced: V3R6
<hr>
<table cellpadding="2" cellspacing="2" align="center">
<tr align="center">
<td valign="middle" align="center"><a href="#Top_Of_Page">Top</a> | <a href=
"print1.htm">Print APIs</a> | <a href="aplist.htm">APIs by
category</a></td>
</tr>
</table>
</body>
</html>