146 lines
5.2 KiB
HTML
146 lines
5.2 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>Restore Authority using BRM (RSTAUTBRM)</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="RSTAUTBRM.Top_Of_Page"></a>
|
|
<h2>Restore Authority using BRM (RSTAUTBRM)</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="#RSTAUTBRM.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#RSTAUTBRM.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#RSTAUTBRM.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="RSTAUTBRM"></a>
|
|
<p>The Restore Authority using BRM (RSTAUTBRM) command reestablishes the object owner, primary group and authorization list names for objects on basic user auxiliary storage pools (2-32) if this information was saved.
|
|
</p>
|
|
<p>This information is saved unless it was explicitly omitted from the save by specifying *USRASPAUT as the omit for either a *SAVSYS or *SECDTA entry in the backup policy omit list.
|
|
</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>The user profiles must be restored before using the RSTAUTBRM command.
|
|
</li>
|
|
<li>The libraries and objects on the saved user auxiliary storage pools must be restored before using the RSTAUTBRM command.
|
|
</li>
|
|
<li>This command does not replace the i5/OS RSTAUT command. RSTAUTBRM is used in addition to the RSTAUT command when restoring the authority information of saved user auxiliary storage pool objects during a system recovery.
|
|
</li>
|
|
</ol>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTAUTBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="RSTAUTBRM.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="#RSTAUTBRM.USRASP"><b>USRASP</b></a></td>
|
|
<td valign="top">Auxiliary storage pool</td>
|
|
<td valign="top">Values (up to 31 repetitions): <i>Character value</i>, <b><u>*ALLUSR</u></b></td>
|
|
<td valign="top">Optional, Positional 1</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTAUTBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="RSTAUTBRM.USRASP"></a>
|
|
<h3>ASPs to restore (USRASP)</h3>
|
|
<p>Specifies the basic user auxiliary storage pools (2-32) for which saved authority information is to be restored.
|
|
</p>
|
|
<p>The libraries and objects must be restored to the basic user auxiliary storage pools before using the RSTAUTBRM command.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>A maximum of 31 values may be specified.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALLUSR</u></b></dt>
|
|
<dd>Saved authorization information is to be restored for objects that reside in all basic user auxiliary storage pools (2-32).
|
|
</dd>
|
|
<dt><b><i>auxiliary-storage-pool-number</i></b></dt>
|
|
<dd>Specifies the number identifying a basic user auxiliary storage pool containing the objects for which saved authority information is restored.
|
|
</dd>
|
|
<dt><b><i>auxiliary-storage-pool-name</i></b></dt>
|
|
<dd>Specifies the name identifying the basic user auxiliary storage pool containing the objects for which saved authority information is restored.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTAUTBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="RSTAUTBRM.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Restoring Saved Authority Information for All ASPs</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
RSTAUTBRM
|
|
-or-
|
|
RSTAUTBRM USRASP(*ALLUSR)
|
|
</pre>
|
|
</p>
|
|
<p>This command restores the owner profile, primary group, and authorization list names for objects contained in all basic user auxiliary storage pools (ASPs 2-32).
|
|
</p>
|
|
<p><b>Example 2: Restoring Saved Authority Information for ASPs 2 and 3</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
RSTAUTBRM USRASP(2 3)
|
|
</pre>
|
|
</p>
|
|
<p>This command restores the owner profile, primary group, and authorization list names for objects contained in basic user auxiliary storage pools 2 and 3.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTAUTBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="RSTAUTBRM.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>BRM4040</b></dt>
|
|
<dd>Access denied for user &1.
|
|
</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="#RSTAUTBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|