ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/addntwaute.htm

195 lines
7.1 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">
<title>Add NetWare Aut Entry (ADDNTWAUTE)</title>
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
</head>
<body bgcolor="white">
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<a name="ADDNTWAUTE.Top_Of_Page"></a>
<h2>Add NetWare Aut Entry (ADDNTWAUTE)</h2>
<table width="100%">
<tr>
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
<b>Threadsafe: </b>No
</td>
<td valign="top" align="right">
<a href="#ADDNTWAUTE.PARAMETERS.TABLE">Parameters</a><br>
<a href="#ADDNTWAUTE.COMMAND.EXAMPLES">Examples</a><br>
<a href="#ADDNTWAUTE.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="ADDNTWAUTE"></a>
<p>The Add NetWare Authentication Entry (ADDNTWAUTE) command adds authentication information for a server to a user profile. The information specifies how the user signs on to the server. This information is used to start authenticated connections to servers. An authenticated connection to a server is required to issue requests to the server. If an authenticated connection does not exist, the system attempts to start a connection using data stored in the authentication entries.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDNTWAUTE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="ADDNTWAUTE.PARAMETERS.TABLE">Parameters</a></h3>
<table border="1" cellpadding="4" cellspacing="0">
<!-- col1="10" col2="15" col3="30" col4="10" -->
<tr>
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
</tr>
<tr>
<td valign="top"><a href="#ADDNTWAUTE.SVRTYPE"><b>SVRTYPE</b></a></td>
<td valign="top">Server type</td>
<td valign="top">*NDS</td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#ADDNTWAUTE.NDSTREE"><b>NDSTREE</b></a></td>
<td valign="top">NDS tree</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDNTWAUTE.USRPRF"><b>USRPRF</b></a></td>
<td valign="top">User profile</td>
<td valign="top"><i>Name</i>, <b><u>*CURRENT</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDNTWAUTE.NDSCTX"><b>NDSCTX</b></a></td>
<td valign="top">NDS context</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDNTWAUTE.NTWUSER"><b>NTWUSER</b></a></td>
<td valign="top">NetWare user</td>
<td valign="top"><i>Character value</i>, <b><u>*USRPRF</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDNTWAUTE.PASSWORD"><b>PASSWORD</b></a></td>
<td valign="top">Password</td>
<td valign="top"><i>Character value</i>, *NONE, *STRNTWCNN</td>
<td valign="top">Required, Positional 2</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#ADDNTWAUTE.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="ADDNTWAUTE.SVRTYPE"></a>
<h3>Server type (SVRTYPE)</h3>
<p>Specifies the server type of the authentication entry.
</p>
<dl>
<dt><b>*NDS</b></dt>
<dd>The entry is for a NetWare Directory Services tree.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDNTWAUTE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDNTWAUTE.NDSTREE"></a>
<h3>NDS tree (NDSTREE)</h3>
<p>Specifies the NetWare Directory Services tree for which the authentication entry is to be added.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDNTWAUTE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDNTWAUTE.USRPRF"></a>
<h3>User profile (USRPRF)</h3>
<p>Specifies the user profile to which the authentication entry is to be added.
</p>
<dl>
<dt><b><u>*CURRENT</u></b></dt>
<dd>Use the current user profile.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the user profile. The user profile must be the current user profile, or the user must have *USE and *OBJMGT authority to the user profile, and *SECADM special authority.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDNTWAUTE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDNTWAUTE.NDSCTX"></a>
<h3>NDS context (NDSCTX)</h3>
<p>Specifies the NetWare Directory Services context in which the user name is defined. The NDS context and NetWare user name are combined to form the distinguished name for the user in the NDS tree.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDNTWAUTE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDNTWAUTE.NTWUSER"></a>
<h3>NetWare user (NTWUSER)</h3>
<p>Specifies the NetWare user name used to authenticate the user to the server.
</p>
<dl>
<dt><b><u>*USRPRF</u></b></dt>
<dd>The NetWare user name is the same as the name of the user profile (USRPRF parameter) to which the entry is being added.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the NetWare user name to be used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDNTWAUTE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDNTWAUTE.PASSWORD"></a>
<h3>Password (PASSWORD)</h3>
<p>Specifies the password used to authenticate the user to the server.
</p>
<dl>
<dt><b>*NONE</b></dt>
<dd>No password is needed to verify authority.
</dd>
<dt><b>*STRNTWCNN</b></dt>
<dd>No password is stored as part of the authentication entry. The password must be provided as part of a Start NetWare Connection (STRNTWCNN) request prior to issuing any requests to the server.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the password to be used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDNTWAUTE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="ADDNTWAUTE.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
ADDNTWAUTE SVRTYPE(*NDS) NDSTREE(IBMTREE)
NDSCTX('OU=PROG.OU=ROCH.O=IBM')
PASSWORD(*STRNTCNN)
</pre>
</p>
<p>This command adds an authentication entry for NDS tree IBMTREE to the current user profile. The user name is the same as the current user profile. The full distinguished name for the user (formed by combining the NDSCTX and NTWUSER parameters, and assuming the current user profile name is JOHN) is '.CN=JOHN.OU=PROG.OU=ROCH.O=IBM'. The Start NetWare Connection (STRNTWCNN) command must be used, with the correct password specified on the PASSWORD parameter, before requests can be sent to the server.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDNTWAUTE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="ADDNTWAUTE.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>FPE0217</b></dt>
<dd>Authentication entry not added due to errors.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDNTWAUTE.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>