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

160 lines
5.5 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>Set User Usage for BRM (SETUSRBRM)</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="SETUSRBRM.Top_Of_Page"></a>
<h2>Set User Usage for BRM (SETUSRBRM)</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="#SETUSRBRM.PARAMETERS.TABLE">Parameters</a><br>
<a href="#SETUSRBRM.COMMAND.EXAMPLES">Examples</a><br>
<a href="#SETUSRBRM.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="SETUSRBRM"></a>
<p>The Set User Usage for BRM (SETUSRBRM) command allows you to set or reset function usage values for a user or group profile.
</p>
<p>This command will use the registration facility to set the BRMS recommended usage options for each BRMS function registered with the system. SETUSRBRM does not not control security to BRMS objects. Use i5/OS security to maintain user authority to BRMS objects.
</p>
<p>For more information, see section "The Functional Usage Model abd BRMS Security Considerations" in the Backup, Recovery and Media Services manual.
</p>
<p>To use this command, you must have the Backup Recovery and Media Services for iSeries, 5722-BR1, licensed program installed.
</p>
<p><b>Restrictions: </b>
</p>
<ol>
<li>*SECADM authority is required to use the SETUSRBRM command.
</li>
<li>The BRMS Advanced feature (Option 2) is required to use this command.
</li>
</ol>
</div>
<table width="100%">
<tr><td align="right"><a href="#SETUSRBRM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="SETUSRBRM.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="#SETUSRBRM.USER"><b>USER</b></a></td>
<td valign="top">User</td>
<td valign="top"><i>Character value</i>, *DEFAULT</td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#SETUSRBRM.USAGE"><b>USAGE</b></a></td>
<td valign="top">Usage</td>
<td valign="top"><i>Character value</i>, <b><u>*OPERATOR</u></b>, *ADMIN</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#SETUSRBRM.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="SETUSRBRM.USER"></a>
<h3>User (USER)</h3>
<p>Specifies the user or group profile to be given usage of BRMS functions. This is a required parameter.
</p>
<dl>
<dt><b><i>user-or-group-profile</i></b></dt>
<dd>Specify the name of an existing user or group profile. The usage for the specified user or group profile will be set for BRMS functions.
</dd>
<dt><b>*DEFAULT</b></dt>
<dd>The default public usage will be set for BRMS functions.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SETUSRBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SETUSRBRM.USAGE"></a>
<h3>Usage (USAGE)</h3>
<p>Specifies the usage that will be given to the user or group profile specified in the <b>User (USER)</b> parameter. Specific usage controls can be tailored using iSeries Navigator.
</p>
<p>To navigate to Backup Recovery and Media Services functions, click on the system name in the iSeries Navigator hierarchy, click on the Configure Application Administration task, or choose File and click on Application Administration. Open the Backup Recovery and Media Services for iSeries folder listed under the Host Applications tab.
</p>
<dl>
<dt><b><u>*OPERATOR</u></b></dt>
<dd>The user or group profile specified in the <b>User (USER)</b> parameter will be given usage to BRMS functions recommended for operators. These include:
<ul>
<li>Basic archive activities
</li>
<li>Basic backup activities
</li>
<li>Basic media activities
</li>
<li>Basic migration activities
</li>
<li>Basic movement activities
</li>
</ul>
</dd>
<dt><b>*ADMIN</b></dt>
<dd>The user or group profile specified in the <b>User (USER)</b> parameter will be given usage to all BRMS functions recommended for administrators.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SETUSRBRM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="SETUSRBRM.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Setting Administrator Usage</b>
</p>
<p>
<pre>
SETUSRBRM USER(payroll) USAGE(*ADMIN)
</pre>
</p>
<p>This command gives the group profile 'payroll' usage of all BRMS functions.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#SETUSRBRM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="SETUSRBRM.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>BRM1917</b></dt>
<dd>Feature not installed.
</dd>
<dt><b>BRM1921</b></dt>
<dd>Feature not licensed.
</dd>
<dt><b>BRM40A2</b></dt>
<dd>BRMS product initialization required.
</dd>
<dt><b>CPF9800</b></dt>
<dd>All CPF98xx messages could be signaled. xx is from 01 to FF.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SETUSRBRM.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>