friedkiwi/ibm-information-center
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
14ed2849c6
ibm-information-center/dist/eclipse/plugins/i5OS.ic.apis_5.4.0.1/qfpvfyae.htm

459 lines
12 KiB
HTML
Raw Blame History

<!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>Verify NetWare Authentication Entry (QfpzVfyNtwAutE) 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. -->
<!-- Change History: -->
<!-- YYMMDD USERID Change description -->
<!-- Sec SCRIPT A converted by B2H R4.1 (346) (CMS) by V2KEA304 -->
<!-- at RCHVMW2 on 17 Feb 1999 at 11:05:09 -->
<!-- Edited by Kersten Jan 02 -->
<!--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>Verify NetWare Authentication Entry (QfpzVfyNtwAutE) API</h2>
<div class="box" style="width: 80%;">
<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%">Entry identifier data</td>
<td align="left" valign="top" width="20%">Input</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 entry identifier</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">Entry identifier 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">4</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;Library Name/Service Program: QFPNTWE/QFPZAAPI<br>
<!-- iddvc RMBR -->
<br>
&nbsp;&nbsp;Threadsafe: No<br>
<!-- iddvc RMBR -->
<br>
</div>
<p>The Verify NetWare Authentication Entry (QfpzVfyNtwAutE) API verifies that
the specified authentication entry can be used to connect to a server. The user
name, password, and other data are sent to the server, where they are used to
attempt to start an authenticated connection to the server. This API might be
used, for example, to verify that the password is valid before submitting a
batch job that would use this entry.</p>
<br>
<h3>Authorities and Locks</h3>
<dl>
<dt><em>User Profile Authority</em></dt>
<dd>The user profile must be the current user profile, or the caller must have
*USE and *OBJMGT authority to the user profile and *SECADM special
authority.</dd>
</dl>
<br>
<h3><a name="HDRVSAERPG">Required Parameter Group</a></h3>
<dl>
<dt><strong>Entry identifier data</strong></dt>
<dd>INPUT; CHAR(*)
<p>The server and user name for the connection to be started. The content and
format of this structure are determined by the format name. See <a href=
"#HDRVSAEFMT">Format of Authentication Entry Identifier</a> for a description
of these formats.</p>
</dd>
<dt><strong>Length of entry identifier</strong></dt>
<dd>INPUT; BINARY(4)
<p>The length of the entry identifier structure.</p>
</dd>
<dt><strong>Entry identifier format name</strong></dt>
<dd>INPUT; CHAR(8)
<p>The content and format of the input data. Each format corresponds to a
method of identifying an authentication entry.</p>
<p>The possible format names follow:</p>
<table cellpadding="5">
<!-- cols="30 70" -->
<tr>
<td align="left" valign="top"><em><a href="#aute0100">AUTE0100</a></em></td>
<td align="left" valign="top">The NetWare Version 3.x server entry is
identified by the server name.</td>
</tr>
<tr>
<td align="left" valign="top"><em><a href="#aute0200">AUTE0200</a></em></td>
<td align="left" valign="top">The NetWare Directory Services tree entry is
identified by the NDS tree name.</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><a name="HDRVSAEFMT">Format of Authentication Entry Identifier</a></h3>
<p>For details about the format of the entry identifier, see the following
sections. For details about the fields in each format, see <a href=
"#HDRVSAEFLD">Field Descriptions</a>.</p>
<h4><a name="aute0100">AUTE0100 Format</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%">BINARY(4)</td>
<td align="left" valign="top" width="60%">Offset to server name</td>
</tr>
<tr>
<td align="center" valign="top">4</td>
<td align="center" valign="top">4</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Length of server name</td>
</tr>
<tr>
<td align="center" valign="top">8</td>
<td align="center" valign="top">8</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">User profile name</td>
</tr>
<tr>
<td align="center" valign="top">18</td>
<td align="center" valign="top">12</td>
<td align="left" valign="top">CHAR(6)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">&nbsp;</td>
<td align="center" valign="top">&nbsp;</td>
<td align="left" valign="top">CHAR(*)</td>
<td align="left" valign="top">Server name</td>
</tr>
</table>
<br>
<br>
<h4><a name="aute0200">AUTE0200 Format</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%">BINARY(4)</td>
<td align="left" valign="top" width="60%">Offset to NDS tree name</td>
</tr>
<tr>
<td align="center" valign="top">4</td>
<td align="center" valign="top">4</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Length of NDS tree name</td>
</tr>
<tr>
<td align="center" valign="top">8</td>
<td align="center" valign="top">8</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Offset to server name</td>
</tr>
<tr>
<td align="center" valign="top">12</td>
<td align="center" valign="top">C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Length of server name</td>
</tr>
<tr>
<td align="center" valign="top">16</td>
<td align="center" valign="top">10</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">User profile name</td>
</tr>
<tr>
<td align="center" valign="top">26</td>
<td align="center" valign="top">1A</td>
<td align="left" valign="top">CHAR(6)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">&nbsp;</td>
<td align="center" valign="top">&nbsp;</td>
<td align="left" valign="top">CHAR(*)</td>
<td align="left" valign="top">NDS tree name</td>
</tr>
<tr>
<td align="center" valign="top">&nbsp;</td>
<td align="center" valign="top">&nbsp;</td>
<td align="left" valign="top">CHAR(*)</td>
<td align="left" valign="top">Server name</td>
</tr>
</table>
<br>
<br>
<h3><a name="HDRVSAEFLD">Field Descriptions</a></h3>
<p><strong>Length of NDS tree name.</strong> The length, in bytes, of the NDS
tree name.</p>
<p><strong>Length of server name.</strong> The length, in bytes, of the server
name.</p>
<p><strong>NDS tree name.</strong> For *NDS trees, the name of the directory
tree.</p>
<p><strong>Offset to NDS tree name.</strong> The offset, in bytes, from the
start of the input data area to the NDS tree name.</p>
<p><strong>Offset to server name.</strong> The offset, in bytes, from the start
of the input data area to the server name.</p>
<p><strong>Server name.</strong> For *NETWARE3 servers, the name of the
server.</p>
<p>For *NDS servers, the name of the server on which to verify the
authentication entry.</p>
<p>For *NDS servers, the following special value may be specified:</p>
<table cellpadding="5">
<!-- cols="10 90" -->
<tr>
<td align="left" valign="top"><em>*ANY</em></td>
<td align="left" valign="top">Any server in the specified NDS tree.</td>
</tr>
</table>
<p><strong>Reserved.</strong> Set this field to binary zeros.</p>
<p><strong>User profile name.</strong> The name of the user profile that
contains the authentication entry.</p>
<p>You can use the following special values for the object name:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*CURRENT</em></td>
<td align="left" valign="top">The current user profile.</td>
</tr>
</table>
<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 width="15%" valign="top">CPF2204 E</td>
<td width="85%" valign="top">User profile &amp;1 not found.</td>
</tr>
<tr>
<td align="left" valign="top">CPF2217 E</td>
<td align="left" valign="top">Not authorized to user profile &amp;1.</td>
</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">CPF3C1D E</td>
<td align="left" valign="top">Length specified in parameter &amp;1 not
valid.</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">FPE0211 E</td>
<td align="left" valign="top">Parameter length &amp;1 not valid for field
&amp;2.</td>
</tr>
<tr>
<td align="left" valign="top">FPE0212 E</td>
<td align="left" valign="top">Field offset and length not within data.</td>
</tr>
<tr>
<td align="left" valign="top">FPE0215 E</td>
<td align="left" valign="top">Could not find authentication entry for
&amp;1.</td>
</tr>
<tr>
<td align="left" valign="top">FPE021C E</td>
<td align="left" valign="top">Not able to contact server &amp;1.</td>
</tr>
<tr>
<td align="left" valign="top">FPE0235 E</td>
<td align="left" valign="top">Error &amp;2 connecting to server &amp;3.</td>
</tr>
<tr>
<td align="left" valign="top">FPE023C E</td>
<td align="left" valign="top">Server is not a &amp;2 server. Server:
&amp;1.</td>
</tr>
<tr>
<td align="left" valign="top">FPE023D E</td>
<td align="left" valign="top">NDS tree not known to system. Tree: &amp;1.</td>
</tr>
<tr>
<td align="left" valign="top">FPE023E E</td>
<td align="left" valign="top">Server &amp;1 not found in tree &amp;2.</td>
</tr>
</table>
<br>
<hr>
API introduced: V3R7
<hr>
<center>
<table cellpadding="2" cellspacing="2">
<tr align="center">
<td valign="middle" align="center"><a href="#Top_Of_Page">Top</a> | <a href=
"sec.htm">Security APIs</a> | <a href="aplist.htm">APIs by category</a></td>
</tr>
</table>
</center>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink