152 lines
6.6 KiB
HTML
152 lines
6.6 KiB
HTML
|
<?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>
|