ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzalu_5.4.0.1/rzalunpse.htm

152 lines
6.6 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en-US" xml:lang="en-us">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="dc.language" scheme="rfc1766" content="en-us" />
<!-- 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. -->
<meta name="dc.date" scheme="iso8601" content="2005-09-06" />
<meta name="copyright" content="(C) Copyright IBM Corporation 1998, 2006" />
<meta name="security" content="public" />
<meta name="Robots" content="index,follow"/>
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
<title>Exit point QIBM_QNPS_ENTRY</title>
<link rel="stylesheet" type="text/css" href="ibmidwb.css" />
<link rel="stylesheet" type="text/css" href="ic.css" />
</head>
<body>
<a id="Top_Of_Page" name="Top_Of_Page"></a><!-- Java sync-link -->
<script language = "Javascript" src = "../rzahg/synch.js" type="text/javascript"></script>
<a name="rzalunpse"></a>
<h5 id="rzalunpse">Exit point QIBM_QNPS_ENTRY</h5>
<p>Exit Point QIBM_QNPS_ENTRY is used by exit programs that want to control
which users can access the network print server. The called exit program is
passed two parameters. These parameters are pointers to structures in user
domain storage. These structures, collectively, comprise format ENTR0100.</p>
<p><span class="bold">Required parameters</span></p><blockquote>
<p><span class="bold">Required parameter group</span></p>
<a name="wq72"></a>
<table id="wq72" width="100%" summary="" border="0" frame="void" rules="none">
<tbody valign="top">
<tr>
<td width="25%" align="right" valign="top">1</td>
<td width="25%" align="left" valign="top">Return code</td>
<td width="25%" align="left" valign="top">Output</td>
<td width="25%" align="left" valign="top">CHAR(1)</td>
</tr>
<tr>
<td align="right" valign="top">2</td>
<td align="left" valign="top">Server information</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">CHAR(32)</td>
</tr>
</tbody>
</table>
<dl class="parml">
<dt class="bold">Return code</dt>
<dd>OUTPUT; CHAR(1) The return code parameter is a pointer to a structure
in user domain that contains the return code from the exit program. The return
code is checked on return from the call to the exit program.
<p>A return code
value of hexadecimal F1 indicates that the network print server allows access
and continues processing.</p>
<p>Any other return code value indicates that
the network print server rejects access and stops processing. The exit program
being called must log any specific errors.</p>
</dd>
</dl>
<p>The structure of the return code follows</p>
<a name="wq73"></a>
<table id="wq73" width="100%" summary="" border="1" frame="border" rules="all">
<thead valign="bottom">
<tr>
<th id="wq74" colspan="2" align="center" valign="bottom">Offset</th>
<th id="wq75" width="33%" rowspan="2" align="left" valign="bottom">Type</th>
<th id="wq76" width="33%" rowspan="2" align="left" valign="bottom">Field</th>
</tr>
<tr>
<th id="wq77" width="16%" align="left" valign="bottom">Dec</th>
<th id="wq78" width="16%" align="left" valign="bottom">Hex</th>
</tr>
</thead>
<tbody valign="top">
<tr>
<td align="center" valign="top" headers="wq74 wq77">0</td>
<td align="center" valign="top" headers="wq74 wq78">0</td>
<td align="left" valign="top" headers="wq75">CHAR(1)</td>
<td align="left" valign="top" headers="wq76">Return code</td>
</tr>
</tbody>
</table>
<dl class="parml">
<dt class="bold">Server information</dt>
<dd>INPUT; CHAR(32) The server information structure contains the user profile
name, server identifier, format name, and server function identifier.
</dd>
</dl>
<p>The structure of the server information follows</p>
<a name="wq79"></a>
<table id="wq79" width="100%" summary="" border="1" frame="border" rules="all">
<thead valign="bottom">
<tr>
<th id="wq80" colspan="2" align="center" valign="bottom">Offset</th>
<th id="wq81" width="25%" rowspan="2" align="left" valign="bottom">Type</th>
<th id="wq82" width="25%" rowspan="2" align="left" valign="bottom">Field</th>
</tr>
<tr>
<th id="wq83" width="25%" align="left" valign="bottom">Dec</th>
<th id="wq84" width="25%" align="left" valign="bottom">Hex</th>
</tr>
</thead>
<tbody valign="top">
<tr>
<td align="center" valign="top" headers="wq80 wq83">0</td>
<td align="center" valign="top" headers="wq80 wq84">0</td>
<td align="left" valign="top" headers="wq81">CHAR(10)</td>
<td align="left" valign="top" headers="wq82">User profile name</td>
</tr>
<tr>
<td align="center" valign="top" headers="wq80 wq83">10</td>
<td align="center" valign="top" headers="wq80 wq84">A</td>
<td align="left" valign="top" headers="wq81">CHAR(10)</td>
<td align="left" valign="top" headers="wq82">Server identifier</td>
</tr>
<tr>
<td align="center" valign="top" headers="wq80 wq83">20</td>
<td align="center" valign="top" headers="wq80 wq84">14</td>
<td align="left" valign="top" headers="wq81">CHAR(8)</td>
<td align="left" valign="top" headers="wq82">Format name</td>
</tr>
<tr>
<td align="center" valign="top" headers="wq80 wq83">28</td>
<td align="center" valign="top" headers="wq80 wq84">1C</td>
<td align="left" valign="top" headers="wq81">BINARY(4)</td>
<td align="left" valign="top" headers="wq82">Function identifier</td>
</tr>
</tbody>
</table></blockquote>
<p><span class="bold">Parameter field descriptions</span></p><blockquote>
<dl>
<dt class="bold">Format name</dt>
<dd>The name of the format being used.
For entry support the value is ENTR0100.</dd>
<dt class="bold">Function identifier</dt>
<dd>This parameter identifies,
within a server, the function of the exit point. For entry support, the value
is hexadecimal 0802.</dd>
<dt class="bold">Server identifier</dt>
<dd>This parameter identifies the
i5/OS server being called. The value for the network print server is QNPSERVR.</dd>
<dt class="bold">User profile name</dt>
<dd>The user, from IBM eServer iSeries
Access for Windows, that is making the call to the network print server.</dd></dl></blockquote>
<a id="Bot_Of_Page" name="Bot_Of_Page"></a>
</body>
</html>