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

401 lines
16 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>Retrieve Auth List Entry (RTVAUTLE)</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="RTVAUTLE.Top_Of_Page"></a>
<h2>Retrieve Auth List Entry (RTVAUTLE)</h2>
<table width="100%">
<tr>
<td valign="top" align="left"><b>Where allowed to run: </b>Compiled CL program or interpreted REXX (*BPGM *IPGM *BREXX *IREXX)<br>
<b>Threadsafe: </b>No
</td>
<td valign="top" align="right">
<a href="#RTVAUTLE.PARAMETERS.TABLE">Parameters</a><br>
<a href="#RTVAUTLE.COMMAND.EXAMPLES">Examples</a><br>
<a href="#RTVAUTLE.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="RTVAUTLE"></a>
<p>The Retrieve Authorization List Entry (RTVAUTLE) command is used in a CL program or REXX procedure to retrieve the authorities that a user has on the authorization list. It can be used with the Change Authorization List Entry command to change the user's authorities to include new authorities in addition to the existing authorities for the user.
</p>
<p>The authorization list name and user name must be specified. The variables for each of the authorities the user might have are returned blank if the user does not have the authority; they are returned with the correct value for the Change Authorization List Entry (CHGAUTLE) command if the user has the authority. The values are returned in the specified variables for the specified user.
</p>
<p>Users with authorization list management (*AUTLMGT) authority, or who own the authorization list, can retrieve authority for any user on the list. Other users can get their own authorities or the authority of *PUBLIC.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVAUTLE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="RTVAUTLE.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="#RTVAUTLE.AUTL"><b>AUTL</b></a></td>
<td valign="top">Authorization list</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#RTVAUTLE.USER"><b>USER</b></a></td>
<td valign="top">User</td>
<td valign="top"><i>Name</i>, *PUBLIC</td>
<td valign="top">Required, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#RTVAUTLE.ALL"><b>ALL</b></a></td>
<td valign="top">CL var for *ALL (10)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVAUTLE.CHANGE"><b>CHANGE</b></a></td>
<td valign="top">CL var for *CHANGE (10)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVAUTLE.USE"><b>USE</b></a></td>
<td valign="top">CL var for *USE (10)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVAUTLE.EXCLUDE"><b>EXCLUDE</b></a></td>
<td valign="top">CL var for *EXCLUDE (10)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVAUTLE.OBJALTER"><b>OBJALTER</b></a></td>
<td valign="top">CL var for *OBJALTER (10)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVAUTLE.OBJEXIST"><b>OBJEXIST</b></a></td>
<td valign="top">CL var for *OBJEXIST (10)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVAUTLE.OBJMGT"><b>OBJMGT</b></a></td>
<td valign="top">CL var for *OBJMGT (10)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVAUTLE.OBJOPR"><b>OBJOPR</b></a></td>
<td valign="top">CL var for *OBJOPR (10)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVAUTLE.OBJREF"><b>OBJREF</b></a></td>
<td valign="top">CL var for *OBJREF (10)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVAUTLE.READ"><b>READ</b></a></td>
<td valign="top">CL var for *READ (10)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVAUTLE.ADD"><b>ADD</b></a></td>
<td valign="top">CL var for *ADD (10)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVAUTLE.UPDATE"><b>UPDATE</b></a></td>
<td valign="top">CL var for *UPD (10)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVAUTLE.DELETE"><b>DELETE</b></a></td>
<td valign="top">CL var for *DLT (10)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVAUTLE.EXECUTE"><b>EXECUTE</b></a></td>
<td valign="top">CL var for *EXECUTE (10)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVAUTLE.AUTLMGT"><b>AUTLMGT</b></a></td>
<td valign="top">CL var for *AUTLMGT (10)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#RTVAUTLE.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="RTVAUTLE.AUTL"></a>
<h3>Authorization list (AUTL)</h3>
<p>Specifies the authorization list that the user's authorities come from.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the authorization list to be changed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVAUTLE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVAUTLE.USER"></a>
<h3>User (USER)</h3>
<p>Specifies the user whose information is to be retrieved. If a variable is specified, it must be a 10-character field which contains a user name or the value *PUBLIC.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b>*PUBLIC</b></dt>
<dd>The information returned in the specified parameter is for the users who do not have any specific authority to the authorization list, and whose groups do not have any specific authority to the authorization list.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the user profile of the user whose information is to be retrieved.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVAUTLE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVAUTLE.ALL"></a>
<h3>CL var for *ALL (10) (ALL)</h3>
<p>Specifies the name of a variable that is used to return the special value of *ALL, if the user has *ALL authority. In CL, this should be a 10-character variable.
</p>
<p>Blanks are returned for the variable if the user does not have this authority.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVAUTLE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVAUTLE.CHANGE"></a>
<h3>CL var for *CHANGE (10) (CHANGE)</h3>
<p>Specifies the name of a variable that is used to return the special value of *CHANGE, if the user has change authority. In CL, this should be a 10-character variable.
</p>
<p>Blanks are returned for the variable if the user does not have this authority.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVAUTLE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVAUTLE.USE"></a>
<h3>CL var for *USE (10) (USE)</h3>
<p>Specifies the name of a variable that is used to return the special value of *USE, if the user has use authority. In CL, this should be a 10-character variable.
</p>
<p>Blanks are returned for the variable if the user does not have this authority.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVAUTLE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVAUTLE.EXCLUDE"></a>
<h3>CL var for *EXCLUDE (10) (EXCLUDE)</h3>
<p>Specifies the name of a variable that is used to return the special value of *EXCLUDE, if the user has that authority. In CL, this should be a 10-character variable.
</p>
<p>Blanks are returned for the variable if the user does not have this authority.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVAUTLE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVAUTLE.OBJALTER"></a>
<h3>CL var for *OBJALTER (10) (OBJALTER)</h3>
<p>Specifies the name of a variable that is used to return *OBJALTER if the user has *OBJALTER authority. In CL programs, the variable has a length of 10 characters. Blanks are returned in the variable if the user does not have *OBJALTER authority.
</p>
<p>Blanks are returned for the variable if the user does not have this authority.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVAUTLE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVAUTLE.OBJEXIST"></a>
<h3>CL var for *OBJEXIST (10) (OBJEXIST)</h3>
<p>Specifies the name of a variable that is used to return the special value of *OBJEXIST, if the user has that authority. In CL, this should be a 10-character variable.
</p>
<p>Blanks are returned for the variable if the user does not have this authority.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVAUTLE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVAUTLE.OBJMGT"></a>
<h3>CL var for *OBJMGT (10) (OBJMGT)</h3>
<p>Specifies the name of a variable that is used to return the special value of *OBJMGT, if the user has object management authority. In CL, this should be a 10-character variable.
</p>
<p>Blanks are returned for the variable if the user does not have this authority.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVAUTLE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVAUTLE.OBJOPR"></a>
<h3>CL var for *OBJOPR (10) (OBJOPR)</h3>
<p>Specifies the name of a variable that is used to return the special value of *OBJOPR, if the user has object operation authority. In CL, this should be a 10-character variable.
</p>
<p>Blanks are returned for the variable if the user does not have this authority.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVAUTLE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVAUTLE.OBJREF"></a>
<h3>CL var for *OBJREF (10) (OBJREF)</h3>
<p>Specifies the name of a variable that is used to return *OBJREF if the user has *OBJREF authority. In CL programs, the variable has a length of 10 characters. Blanks are returned in the variable if the user does not have *OBJREF authority.
</p>
<p>Blanks are returned for the variable if the user does not have this authority.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVAUTLE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVAUTLE.READ"></a>
<h3>CL var for *READ (10) (READ)</h3>
<p>Specifies the name of a variable that is used to return the special value of *READ, if the user has read authority. In CL, this should be a 10-character variable.
</p>
<p>Blanks are returned for the variable if the user does not have this authority.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVAUTLE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVAUTLE.ADD"></a>
<h3>CL var for *ADD (10) (ADD)</h3>
<p>Specifies the name of a variable that is used to return the special value of *ADD, if the user has add authority. In CL, this should be a 10-character variable.
</p>
<p>Blanks are returned for the variable if the user does not have this authority.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVAUTLE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVAUTLE.UPDATE"></a>
<h3>CL var for *UPD (10) (UPDATE)</h3>
<p>Specifies the name of a variable that is used to return the special value of *UPD, if the user has update authority. In CL, this should be a 10-character variable.
</p>
<p>Blanks are returned for the variable if the user does not have this authority.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVAUTLE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVAUTLE.DELETE"></a>
<h3>CL var for *DLT (10) (DELETE)</h3>
<p>Specifies the name of a variable that is used to return the special value of *DLT, if the user has delete authority. In CL, this should be a 10-character variable.
</p>
<p>Blanks are returned for the variable if the user does not have this authority.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVAUTLE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVAUTLE.EXECUTE"></a>
<h3>CL var for *EXECUTE (10) (EXECUTE)</h3>
<p>Specifies the name of a variable that is used to return *EXECUTE if the user has *EXECUTE authority. In CL programs, the variable has a length of 10 characters. Blanks are returned in the variable if the user does not have *EXECUTE authority.
</p>
<p>Blanks are returned for the variable if the user does not have this authority.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVAUTLE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVAUTLE.AUTLMGT"></a>
<h3>CL var for *AUTLMGT (10) (AUTLMGT)</h3>
<p>Specifies the name of a variable that is used to return the special value of *AUTLMGT, if the user has authorization list management authority.
</p>
<p>Blanks are returned for the variable if the user does not have this authority.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVAUTLE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RTVAUTLE.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
ADDAUTLE AUTL(PAYROLL) USER(TOM)
AUT(*OBJOPR *READ *UPD *AUTLMGT)
</pre>
</p>
<p>When user Smith calls a CL program containing the following:
</p>
<p>
<pre>
DCL &amp;CHG *CHAR 10
DCL &amp;ALL *CHAR 10
DCL &amp;USE *CHAR 10
DCL &amp;EXCL *CHAR 10
DCL &amp;OBJOP *CHAR 10
DCL &amp;ALTER *CHAR 10
DCL &amp;REFER *CHAR 10
DCL &amp;READ *CHAR 10
DCL &amp;ADD *CHAR 10
DCL &amp;UPD *CHAR 10
DCL &amp;DLT *CHAR 10
DCL &amp;EXEC *CHAR 10
DCL &amp;AUTLM *CHAR 10
:
RTVAUTLE AUTL(PAYROLL) USER(TOM) USE(&amp;USE) +
OBJOPR(&amp;OBJOP) AUTLMGT(&amp;AUTLM)
</pre>
</p>
<p>This command retrieves the following authorities from the authorization list PAYROLL for user TOM: *USE, *OBJOPR, and *AUTLMGT. If TOM does not have the authority, blanks are returned.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVAUTLE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RTVAUTLE.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF22A7</b></dt>
<dd>User &amp;1 not on authorization list &amp;2, no authorities retrieved.
</dd>
<dt><b>CPF22A8</b></dt>
<dd>Not authorized to retrieve authorities for user &amp;1.
</dd>
<dt><b>CPF2204</b></dt>
<dd>User profile &amp;1 not found.
</dd>
<dt><b>CPF2283</b></dt>
<dd>Authorization list &amp;1 does not exist.
</dd>
<dt><b>CPF2289</b></dt>
<dd>Unable to allocate authorization list &amp;1.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVAUTLE.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>