572 lines
26 KiB
HTML
572 lines
26 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 Object using BRM (RSTBRM)</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="RSTBRM.Top_Of_Page"></a>
|
||
|
|
<h2>Restore Object using BRM (RSTBRM)</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="#RSTBRM.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#RSTBRM.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#RSTBRM.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="RSTBRM"></a>
|
||
|
|
<p>The Restore Object using BRM (RSTBRM) command restores a copy of one or more objects that can be used in the integrated file system.
|
||
|
|
</p>
|
||
|
|
<p>For more information about integrated file system commands, see the Integrated File System Introduction book.
|
||
|
|
</p>
|
||
|
|
<p>Virtual tape media and devices can be used with this command. The following restrictions apply to the use of virtual media and virtual devices.
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>The <b>Device (DEV) </b>parameter is limited on only one device or *MEDCLS special value for serial operations.
|
||
|
|
</li>
|
||
|
|
<li>Execute authority is required to the Load or Unload Image Catalog (LODIMGCLG) command.
|
||
|
|
</li>
|
||
|
|
<li>*CHANGE authority is required to the image catalogs.
|
||
|
|
</li>
|
||
|
|
<li>Execute (*X) authority is required to each directory in the image catalog path name.
|
||
|
|
</li>
|
||
|
|
<li>Read, write, execute (*RWX) authority is required to each image file in the parent directory that will be loaded or mounted.
|
||
|
|
</li>
|
||
|
|
<li>*USE authority is required to the virtual devices using the image catalogs.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<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>For detailed restrictions on using this command to restore objects by using name patterns in the root directory, to restore objects in libraries, or to restore document library objects, see the <b>Restore Object (RST) </b>command in the Backup and Recovery book.
|
||
|
|
</li>
|
||
|
|
<li>The RSTBRM command does not support optical files.
|
||
|
|
</li>
|
||
|
|
<li>You must have authority to use the Restore Object (RST) command.
|
||
|
|
</li>
|
||
|
|
<li>You must have save system (*SAVSYS) special authority, or have all of the following object authorities:
|
||
|
|
<ul>
|
||
|
|
<li>You must have *W and *OBJEXIST authority to restore a file if it already exists on the system.
|
||
|
|
</li>
|
||
|
|
<li>You must have *WX authority to the parent directory.
|
||
|
|
</li>
|
||
|
|
<li>You must have *ADD authority to the owning user profile of the directory into which the parent directories are created.
|
||
|
|
</li>
|
||
|
|
<li>You must have *ALLOBJ special authority to create parent directories with a user profile other than your own.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
<li>You must have *ALLOBJ special authority to use any value other than *NONE for the ALWOBJDIF parameter.
|
||
|
|
</li>
|
||
|
|
<li>You can restore data from a TSM server device by using this command. You can only specify one TSM device or *MEDCLS, which must select a TSM device. The TSM device selected can either be *APPC, which supports the SNA network protocol, or *NET, which supports the TCP/IP protocol.
|
||
|
|
</li>
|
||
|
|
<li>This command should not be used by control group *EXIT item processing as results will be unpredictable.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RSTBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="RSTBRM.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="#RSTBRM.DEV"><b>DEV</b></a></td>
|
||
|
|
<td valign="top">Device</td>
|
||
|
|
<td valign="top">Values (up to 4 repetitions): <i>Name</i>, *MEDCLS</td>
|
||
|
|
<td valign="top">Required, Positional 1</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#RSTBRM.PRLRSC"><b>PRLRSC</b></a></td>
|
||
|
|
<td valign="top">Parallel device resources</td>
|
||
|
|
<td valign="top"><i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Minimum resources</td>
|
||
|
|
<td valign="top">
|
||
|
|
1-32, <b><u>*SAV</u></b>, *NONE, *AVAIL</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Maximum resources</td>
|
||
|
|
<td valign="top">
|
||
|
|
1-32, <b><u>*MIN</u></b>, *AVAIL</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="4"><a href="#RSTBRM.OBJ"><b>OBJ</b></a></td>
|
||
|
|
<td valign="top">Objects</td>
|
||
|
|
<td valign="top">Values (up to 300 repetitions): <i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="4">Optional, Positional 2</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Name</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Path name</i>, <b><u>*</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Include or omit</td>
|
||
|
|
<td valign="top">
|
||
|
|
<b><u>*INCLUDE</u></b>, *OMIT</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 3: New object name</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Path name</i>, <b><u>*SAME</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#RSTBRM.SUBTREE"><b>SUBTREE</b></a></td>
|
||
|
|
<td valign="top">Directory subtree</td>
|
||
|
|
<td valign="top"><b><u>*ALL</u></b>, *DIR, *NONE, *OBJ</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#RSTBRM.SAVLVL"><b>SAVLVL</b></a></td>
|
||
|
|
<td valign="top">Save level</td>
|
||
|
|
<td valign="top">1-99, <b><u>*CURRENT</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#RSTBRM.ENDOPT"><b>ENDOPT</b></a></td>
|
||
|
|
<td valign="top">End of tape option</td>
|
||
|
|
<td valign="top"><b><u>*REWIND</u></b>, *LEAVE, *UNLOAD</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#RSTBRM.OPTION"><b>OPTION</b></a></td>
|
||
|
|
<td valign="top">Option</td>
|
||
|
|
<td valign="top"><b><u>*ALL</u></b>, *NEW, *OLD</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#RSTBRM.ALWOBJDIF"><b>ALWOBJDIF</b></a></td>
|
||
|
|
<td valign="top">Allow object differences</td>
|
||
|
|
<td valign="top">Single values: <b><u>*NONE</u></b>, *ALL<br>Other values (up to 2 repetitions): *AUTL, *OWNER, *PGP</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#RSTBRM.OBJID"><b>OBJID</b></a></td>
|
||
|
|
<td valign="top">Object ID</td>
|
||
|
|
<td valign="top"><b><u>*SAVED</u></b>, *SYS</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#RSTBRM.CRTPRNDIR"><b>CRTPRNDIR</b></a></td>
|
||
|
|
<td valign="top">Create parent directories</td>
|
||
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#RSTBRM.PRNDIROWN"><b>PRNDIROWN</b></a></td>
|
||
|
|
<td valign="top">Parent directory owner</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*PARENT</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#RSTBRM.FROMSYS"><b>FROMSYS</b></a></td>
|
||
|
|
<td valign="top">From system</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*LCL</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RSTBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="RSTBRM.DEV"></a>
|
||
|
|
<h3>Device (DEV)</h3>
|
||
|
|
<p>Specifies the device name or a specific media class that is to be used to restore the object. You must use a single device for recovery processing.
|
||
|
|
</p>
|
||
|
|
<p>You can restore data from a TSM (ADSM) server using this command. You can only specify one TSM type server or *MEDCLS, which must select a TSM server. The device selected can either be *APPC, which supports SNA network protocol, or *NET, which supports TCPIP protocol.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*MEDCLS</b></dt>
|
||
|
|
<dd>BRMS determines the media class of the media on which the requested item is saved. Once the media class is determined, a device supporting that media class is selected to restore the requested object or objects.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>device-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the device that you want to use to restore the selected object or objects.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RSTBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RSTBRM.PRLRSC"></a>
|
||
|
|
<h3>Parallel device resources (PRLRSC)</h3>
|
||
|
|
<p>Specifies the minimum and maximum number of device resources to be used in a restore operation.
|
||
|
|
</p>
|
||
|
|
<p><b>Element 1: Minimum Resources</b>
|
||
|
|
</p>
|
||
|
|
<p>Specifies the minimum number of device resources required for a parallel restore.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>If a Media Library Device (MLB) is being used and the required resources are not available, the command will wait for the MLB to become available for a time period specified by the user. The wait time is determined by the value specified on the *MLB device description for INLMNTWAIT. If a *TAP device is being used and the required resources are not available, the command will fail.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>Transferring save files to tape does not support parallel operations.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAV</u></b></dt>
|
||
|
|
<dd>Specifies that the same number of device resources used for the save will be used for the restore. If the save was a serial save, then the restore will also be serial.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*AVAIL</b></dt>
|
||
|
|
<dd>Use any available devices up to the maximum specified. Specifying this value for the minimum will allow BRMS to use any available resources, but will complete using one resource if only one is available at the start of the command.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NONE</b></dt>
|
||
|
|
<dd>No device resources are to be used. The restore will be performed as a serial restore.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>1-32</i></b></dt>
|
||
|
|
<dd>Specify the minimum number of device resources to be used with this restore command, up to the maximum of what was used for the save.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: Maximum Resources</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*MIN</u></b></dt>
|
||
|
|
<dd>Uses the value specified for the minimum number of device resources.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*AVAIL</b></dt>
|
||
|
|
<dd>Use any available devices. Specifying this value for the maximum will allow BRMS to use any available resources but at a minimum use the value specified in the minimum element.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>1-32</i></b></dt>
|
||
|
|
<dd>Specify the maximum number of device resources to be used with this restore command, up to the maximum of what was used for the save.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RSTBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RSTBRM.OBJ"></a>
|
||
|
|
<h3>Objects (OBJ)</h3>
|
||
|
|
<p>Specifies the objects that you want to include or exclude from a list of objects you want to restore. A maximum of 300 object name patterns can be specified.
|
||
|
|
</p>
|
||
|
|
<p>For more information on specifying path names, refer to <b>Chapter 2 </b> of the Command Language Reference book.
|
||
|
|
</p>
|
||
|
|
<p>Additional information about object name patterns is in the Integrated File System Introduction book. The first element specifies the path names of the objects saved on the media. Directory abbreviations (for example, the current directory) are expanded with their current values, not the values they had at the time of the save operation.
|
||
|
|
</p>
|
||
|
|
<p><b>Element 1: Name </b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>object-path-name-pattern</i></b></dt>
|
||
|
|
<dd>Specify an object path name or a pattern that can match many names.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: Include or omit </b>
|
||
|
|
</p>
|
||
|
|
<p>The second part specifies whether names that match the pattern should be included or omitted from the operation. Note that in determining whether a name matches a pattern, relative name patterns are always treated as relative to the current working directory. The SUBTREE parameter determines whether the subtrees are included or omitted.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*INCLUDE</u></b></dt>
|
||
|
|
<dd>Objects that match the object name pattern are to be restored, unless overridden by an *OMIT specification.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*OMIT</b></dt>
|
||
|
|
<dd>Objects matching the object name pattern are not to be restored. This overrides a *INCLUDE specification and is intended to be used to omit a subset of a previously selected pattern.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 3: New object name </b>
|
||
|
|
</p>
|
||
|
|
<p>The third element specifies the new path name of the object.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The objects are to be restored with the same names they had when they were saved.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>new-path-name</i></b></dt>
|
||
|
|
<dd>Specify the path name with which to restore the object. If a pattern is specified in the first element, the new path name must be the directory into which to restore any objects that match the pattern. If an object name is specified in element 1, each component in the new path must exist with the exception of the last component. If the object described in the last component doesn't exist, it will be restored as new.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RSTBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RSTBRM.SUBTREE"></a>
|
||
|
|
<h3>Directory subtree (SUBTREE)</h3>
|
||
|
|
<p>Specifies whether directory subtrees are included in the restore operation.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ALL</u></b></dt>
|
||
|
|
<dd>The entire subtree for each directory that matches the object name pattern is included. The subtree includes all subdirectories and the objects within those subdirectories.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*DIR</b></dt>
|
||
|
|
<dd>Objects in the first level of each directory that matches the object name pattern are included. The subdirectories of each matching directory are included, but the objects in the subdirectories are not included.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NONE</b></dt>
|
||
|
|
<dd>No subtrees are included in the restore operation. If a directory matches the object name pattern specified, the objects in the directory are included. If the directory has subdirectories, neither the subdirectories nor the objects in the subdirectories are included.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*OBJ</b></dt>
|
||
|
|
<dd>Only the objects that exactly match the object name pattern will be processed. If the object name pattern specifies a directory, objects in the directory are not included.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RSTBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RSTBRM.SAVLVL"></a>
|
||
|
|
<h3>Save level (SAVLVL)</h3>
|
||
|
|
<p>Specifies the copy of the object that you want to restore from the media content information.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*CURRENT</u></b></dt>
|
||
|
|
<dd>The most current copy of the object is restored.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>save-level-number</i></b></dt>
|
||
|
|
<dd>Specify the age of the copy that you want to restore from the media content information. You can specify a copy number from 1 - 99. For instance, if you want to restore the next to the last most recent copy specify 1.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RSTBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RSTBRM.ENDOPT"></a>
|
||
|
|
<h3>End of tape option (ENDOPT)</h3>
|
||
|
|
<p>Specifies, when volume is used, what positioning operation is automatically done on the volume after the restore operation ends. If more than one volume is included, this parameter applies only to the last volume used; all other volumes are rewound and unloaded when the end of the volume is reached.
|
||
|
|
</p>
|
||
|
|
<p>If you specify *LEAVE and the device is a shared device, the device will not be varied off after the save operation. If you specify *LEAVE and the device is not a shared device, the device will be varied off after the save operation.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*REWIND</u></b></dt>
|
||
|
|
<dd>The volume is automatically rewound but not unloaded after the recovery operation ends.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LEAVE</b></dt>
|
||
|
|
<dd>The volume does not rewind or unload after the operation ends. It remains at the current position on the device.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*UNLOAD</b></dt>
|
||
|
|
<dd>The volume is automatically rewound and unloaded after the recovery operation ends.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RSTBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RSTBRM.OPTION"></a>
|
||
|
|
<h3>Option (OPTION)</h3>
|
||
|
|
<p>Specifies how to handle restoring each object.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ALL</u></b></dt>
|
||
|
|
<dd>All the objects are restored to the system. Saved objects replace the objects on the system. Saved objects not on the system are added to the system. Objects in the system library but not in the saved library remain in the library.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NEW</b></dt>
|
||
|
|
<dd>Only the objects that do not exist on the system are restored.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*OLD</b></dt>
|
||
|
|
<dd>Only the objects that exist on the system are restored.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RSTBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RSTBRM.ALWOBJDIF"></a>
|
||
|
|
<h3>Allow object differences (ALWOBJDIF)</h3>
|
||
|
|
<p>Specifies whether differences are allowed between the saved objects and the restored objects. These differences include:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li><b>Authorization list: </b>The authorization list of an object on the system is different than the authorization list of an object from the save operation. Or the system on which a new object with an authorization list is being restored is different from the system on which it was saved.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<ul>
|
||
|
|
<li><b>Ownership: </b>The owner of an object on the system is different than the owner of an object from the save operation.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<ul>
|
||
|
|
<li><b>Primary Group: </b>The primary group of an object on the system is different than the primary group of an object from the save operation.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>To use this parameter, you need *ALLOBJ special authority.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>None of the differences listed above are allowed on the restore operation.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>All of the differences listed above are allowed on the restore operation. File level identifier and member level identifier differences are handled differently than the *FILELVL value. If there is a file level difference and *ALL is specified on the <b>Data base member option (MBROPT)</b> parameter, the existing version of the file is renamed and the saved version of the file is restored. If there is a member level difference, the existing version of the member is renamed and the saved version of the member is restored. This value will restore the saved data, but the result may not be correct. For other differences, see the description of each individual value to determine how differences are handled.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>If restoring objects that BRMS saved with SAVOBJ or SAVCHGOBJ, BRMS will change the parameter to ALWOBJDIF(*FILELVL *AUTL *OWNER *PGP) for these objects to prevent the renaming.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Other values (up to 4 repetitions)</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*AUTL</b></dt>
|
||
|
|
<dd>Authorization list differences are allowed.
|
||
|
|
<p>If an object already exists on the system with a different authorization list than the saved object, the object is restored with the authorization list of the object on the system. New objects that are being restored to a system that is different from which they were saved are restored and linked to their authorization list. If the authorization list does not exist on the new system, the public authority is set to *EXCLUDE.
|
||
|
|
</p>
|
||
|
|
<p>If this value is not specified, authorization list differences are not allowed. If an object already exists on the system with a different authorization list than the saved object, the object is not restored. New objects that are being restored to a system that is different from which they were saved are restored, but they are not linked to the authorization list, and the public authority is set to *EXCLUDE.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*OWNER</b></dt>
|
||
|
|
<dd>Ownership differences are allowed.
|
||
|
|
<p>If an object already exists on the system with a different owner than the saved object, the object is restored with the owner of the object on the system.
|
||
|
|
</p>
|
||
|
|
<p>If this value is not specified, ownership differences are not allowed. If an object already exists on the system with a different owner than the saved object, the object is not restored.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*PGP</b></dt>
|
||
|
|
<dd>Primary group differences are allowed.
|
||
|
|
<p>If an object already exists on the system with a different primary group than the saved object, the object is restored with the primary group of the object on the system.
|
||
|
|
</p>
|
||
|
|
<p>If this value is not specified, primary group differences are not allowed. If an object already exists on the system with a different primary group than the saved object, the object is not restored.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RSTBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RSTBRM.OBJID"></a>
|
||
|
|
<h3>Object ID (OBJID)</h3>
|
||
|
|
<p>Specifies whether the SOM object ID of the restored object will be the SOM object ID of the object from the save media, the SOM object ID of the object that exists on the system prior to the restore, or a new SOM object ID generated by the system if the object does not exist on the system prior to the restore.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAVED</u></b></dt>
|
||
|
|
<dd>The restored object will have the SOM object ID it had when it was saved.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SYS</b></dt>
|
||
|
|
<dd>The restored object may have a new SOM object ID generated by the system. If the object is being restored as a new object, a new SOM object ID will be given to the restored object. If an object with the same name as the object from the media already exists on the system, the SOM object ID of the restored object will be the same as the SOM object ID of the object on the system before the restore.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RSTBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RSTBRM.CRTPRNDIR"></a>
|
||
|
|
<h3>Create parent directories (CRTPRNDIR)</h3>
|
||
|
|
<p>Specifies whether parent directories are to be created automatically if the directories do not exist before the object is restored. This parameter only applies to "root" (/), QOpenSys, and user-defined file systems.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NO</u></b></dt>
|
||
|
|
<dd>Specifies parent directories are not to be automatically created.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>Specifies parent directories are to be automatically created. The parent directory owner can be specified using the <b>Parent directories owner (PRNDIROWN) </b>parameter.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RSTBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RSTBRM.PRNDIROWN"></a>
|
||
|
|
<h3>Parent directory owner (PRNDIROWN)</h3>
|
||
|
|
<p>Specifies the name of the owner to be used for the parent directory when creating parent directories which do not exist.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*PARENT</u></b></dt>
|
||
|
|
<dd>Specifies the owner of the directory into which the parent directory is created will be used for the owner of the created parent directory.
|
||
|
|
</dd>
|
||
|
|
<dt><b>user-profile</b></dt>
|
||
|
|
<dd>Specifies the name of the user profile to use for the parent directory owner when creating parent directories which do not exist.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RSTBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RSTBRM.FROMSYS"></a>
|
||
|
|
<h3>From system (FROMSYS)</h3>
|
||
|
|
<p>Specifies the location and network identification of the system from which you want to restore media information to the local system.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>Use the Display Network Attributes (DSPNETA) command to view the system network attributes.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>The BRMS Network feature (Option 1) is required to use this value if a value other than *LCL is specified.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LCL</u></b></dt>
|
||
|
|
<dd>Specifies that the from-system is the local system. BRMS uses the <b>Default local location name (LCLLOCNAME)</b> network attribute and not the <b>System name (SYSNAME)</b> network attribute to determine the current system name. In most cases, the systems have the same value specified for LCLLOCNAME as for SYSNAME.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>location-name</i></b></dt>
|
||
|
|
<dd>Specifies the <b>Default local location name (LCLLOCNAME)</b> network attribute of the remote system for the network operation. The current system <b>Local network ID (LCLNETID)</b> network attribute is used to connect with the remote system.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>network-id.location-name</i></b></dt>
|
||
|
|
<dd>Specifies the <b>Local network ID (LCLNETID)</b> and the <b>Default local location name (LCLLOCNAME)</b> network attributes of the remote system for the network operation. Specify these values using the format nnnnnnnn.cccccccc where nnnnnnnn is the LCLNETID and cccccccc is the LCLLOCNAME.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RSTBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="RSTBRM.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Restoring All Integrated File System Objects</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
RSTBRM DEV(TAPE01)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command allows you to select and restore integrated file system objects that were saved using the SAVBRM command and whose contents information still exist in the media contents information. In this example, the restore operation is for all integrated file system objects and will use device TAPE01 for the restore operation.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RSTBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="RSTBRM.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>BRM1177</b></dt>
|
||
|
|
<dd>Cannot establish connection with remote system.
|
||
|
|
</dd>
|
||
|
|
<dt><b>BRM1917</b></dt>
|
||
|
|
<dd>Feature not installed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>BRM1921</b></dt>
|
||
|
|
<dd>Feature not licensed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>BRM2262</b></dt>
|
||
|
|
<dd>Errors occurred receiving data from TSM server.
|
||
|
|
</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>CPF3700</b></dt>
|
||
|
|
<dd>All CPF37xx messages could be signaled. xx is from 01 to FF.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3800</b></dt>
|
||
|
|
<dd>All CPF38xx messages could be signaled. xx is from 01 to FF.
|
||
|
|
</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="#RSTBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|