204 lines
7.3 KiB
HTML
204 lines
7.3 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 Server Auth Entry (ADDSVRAUTE)</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="ADDSVRAUTE.Top_Of_Page"></a>
|
|
<h2>Add Server Auth Entry (ADDSVRAUTE)</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="#ADDSVRAUTE.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#ADDSVRAUTE.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#ADDSVRAUTE.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="ADDSVRAUTE"></a>
|
|
<p>The Add Server Authentication Entry (ADDSVRAUTE) command adds authentication information for use by application requesters in connecting to application servers.
|
|
</p>
|
|
<p>When using the ADDSVRAUTE command to add a server authorization entry for a Distributed Relational Database Architecture (DRDA) application that uses TCP/IP, make sure that the server name is entered in upper case.
|
|
</p>
|
|
<p><b>Restrictions:</b> You must have security administrator (*SECADM) special authority, and object management (*OBJMGT) and use (*USE) authorities to the user profile to which the server authentication entry is to be added, or else be signed on under that user profile, to run this command.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDSVRAUTE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="ADDSVRAUTE.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="#ADDSVRAUTE.USRPRF"><b>USRPRF</b></a></td>
|
|
<td valign="top">User profile</td>
|
|
<td valign="top"><i>Simple name</i>, *CURRENT</td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDSVRAUTE.SERVER"><b>SERVER</b></a></td>
|
|
<td valign="top">Server</td>
|
|
<td valign="top"><i>Character value</i></td>
|
|
<td valign="top">Required, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDSVRAUTE.USRID"><b>USRID</b></a></td>
|
|
<td valign="top">User ID</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="#ADDSVRAUTE.PASSWORD"><b>PASSWORD</b></a></td>
|
|
<td valign="top">User password</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDSVRAUTE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="ADDSVRAUTE.USRPRF"></a>
|
|
<h3>User profile (USRPRF)</h3>
|
|
<p>Specifies the user profile for which the server authentication entry is to be added.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*CURRENT</b></dt>
|
|
<dd>The server authentication entry will be added for the current user.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the user for which to add the server authentication entry.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDSVRAUTE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDSVRAUTE.SERVER"></a>
|
|
<h3>Server (SERVER)</h3>
|
|
<p>Specifies the name of the application server for which the entry is to be added.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name for the particular application server for which the entry is to be added. Specify no more than 200 characters.
|
|
<p>
|
|
<b>Note: </b>Refer to the documentation for the server that you are using to determine if there are any values that have special meaning. For example, the server name QDDMSERVER has special meaning if you are using the Distributed Data Management (DDM) server.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDSVRAUTE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDSVRAUTE.USRID"></a>
|
|
<h3>User ID (USRID)</h3>
|
|
<p>Specifies the user name for which requests will be made to the application server.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*USRPRF</u></b></dt>
|
|
<dd>The name specified in the user profile parameter will be the user ID specified on connection requests to the server.
|
|
</dd>
|
|
<dt><b><i>'name'</i></b></dt>
|
|
<dd>Specify the name of the user to be used on connection requests. Specify no more than 1000 characters.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDSVRAUTE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDSVRAUTE.PASSWORD"></a>
|
|
<h3>User password (PASSWORD)</h3>
|
|
<p>Specifies the password to be used to authenticate the user when the client attempts to connect to the server.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>If the retain server security data (QRETSVRSEC) system value is set to 0 (do not retain data), then the password is not saved in the entry.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>No password is supplied on the connection request.
|
|
</dd>
|
|
<dt><b><i>'password'</i></b></dt>
|
|
<dd>Specify the password associated with the user ID. Specify no more than 696 characters.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDSVRAUTE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="ADDSVRAUTE.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Adding a default remote user ID and password for the current user</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ADDSVRAUTE USRPRF(*CURRENT) SERVER(*ANY) USRID('JOHN')
|
|
PASSWORD('XU53W4')
|
|
</pre>
|
|
</p>
|
|
<p>This command adds a server authentication entry for the currently signed on user specifying that for connection requests to any server for which there is no specific authentication entry, a remote user ID of JOHN and a password of XU53W4 is to be used.
|
|
</p>
|
|
<p><b>Example 2: Adding an entry for another user for a specific server</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ADDSVRAUTE USRPRF(SUSAN) SERVER('MPLS_RDB') USRID('SUSIE')
|
|
PASSWORD('S23084')
|
|
</pre>
|
|
</p>
|
|
<p>This command adds an entry such that when a user is signed on to the local system under the user profile of SUSAN and attempts to connect to the server named MPLS_RDB, the user ID and password accompanying the connection request will be SUSIE and S23084.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDSVRAUTE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="ADDSVRAUTE.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF2204</b></dt>
|
|
<dd>User profile &1 not found.
|
|
</dd>
|
|
<dt><b>CPF2213</b></dt>
|
|
<dd>Not able to allocate user profile &1.
|
|
</dd>
|
|
<dt><b>CPF2222</b></dt>
|
|
<dd>Storage limit is greater than specified for user profile &1.
|
|
</dd>
|
|
<dt><b>CPF224F</b></dt>
|
|
<dd>Server authentication entry already exists.
|
|
</dd>
|
|
<dt><b>CPF225F</b></dt>
|
|
<dd>Not all information stored.
|
|
</dd>
|
|
<dt><b>CPF226C</b></dt>
|
|
<dd>Not authorized to perform function.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDSVRAUTE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|