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

132 lines
4.6 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Remove Server Auth Entry (RMVSVRAUTE)</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="RMVSVRAUTE.Top_Of_Page"></a>
<h2>Remove Server Auth Entry (RMVSVRAUTE)</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="#RMVSVRAUTE.PARAMETERS.TABLE">Parameters</a><br>
<a href="#RMVSVRAUTE.COMMAND.EXAMPLES">Examples</a><br>
<a href="#RMVSVRAUTE.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="RMVSVRAUTE"></a>
<p>The Remove Server Authentication Entry (RMVSVRAUTE) command is used to remove server authentication entries from the specified user profile. This authentication information is used by application requesters to connect to application servers. Once an entry is removed, attempting to make new connections to the server will result in either using other server authentication entries or if no matches are found, returning an error to the application.
</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 removed, or else be signed on under that user profile, to run this command.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVSVRAUTE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="RMVSVRAUTE.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="#RMVSVRAUTE.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="#RMVSVRAUTE.SERVER"><b>SERVER</b></a></td>
<td valign="top">Server</td>
<td valign="top"><i>Character value</i>, *ALL</td>
<td valign="top">Required, Positional 2</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#RMVSVRAUTE.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="RMVSVRAUTE.USRPRF"></a>
<h3>User profile (USRPRF)</h3>
<p>Specifies the user profile for which the server authentication entry is to be removed.
</p>
<dl>
<dt><b>*CURRENT</b></dt>
<dd>The server authentication entry is removed for the current user.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the user profile from which to remove the server authentication entry.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVSVRAUTE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RMVSVRAUTE.SERVER"></a>
<h3>Server (SERVER)</h3>
<p>Specifies the name of the application server.
</p>
<dl>
<dt><b>*ALL</b></dt>
<dd>All server authentication entries for this user profile are to be removed.
</dd>
<dt><b><i>'character-value'</i></b></dt>
<dd>Specify the name of the application server whose entry is to be removed. Specify no more than 200 characters.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVSVRAUTE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RMVSVRAUTE.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
RMVSVRAUTE USRPRF(*CURRENT) SERVER('MPLS_RDB')
</pre>
</p>
<p>This command removes the server authentication entry for MPLS_RDB from the current user profile.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVSVRAUTE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RMVSVRAUTE.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF2204</b></dt>
<dd>User profile &amp;1 not found.
</dd>
<dt><b>CPF2213</b></dt>
<dd>Not able to allocate user profile &amp;1.
</dd>
<dt><b>CPF225E</b></dt>
<dd>Server authentication entry does not exist.
</dd>
<dt><b>CPF226C</b></dt>
<dd>Not authorized to perform function.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVSVRAUTE.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>