619 lines
31 KiB
HTML
619 lines
31 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 Library using BRM (RSTLIBBRM)</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="RSTLIBBRM.Top_Of_Page"></a>
|
|
<h2>Restore Library using BRM (RSTLIBBRM)</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="#RSTLIBBRM.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#RSTLIBBRM.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#RSTLIBBRM.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="RSTLIBBRM"></a>
|
|
<p>The Restore Library using BRM (RSTLIBBRM) command allows you to restore a library that is in the BRMS media information. Any library that was saved by the Save Library using BRM (SAVLIBBRM) command or was in a control group that was saved can be restored by the RSTLIBBRM command. The RSTLIBBRM command restores the whole library, which includes the library description, object descriptions and contents of the objects in the library.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>Using the RSTLIBBRM command allows you to restore selected copies of a library from the BRMS media content information. For instance, a recovery request for a copy of a library will restore the full backup of the library that corresponds to the copy requested in the <b>Save level (SAVLVL)</b> parameter, plus the last incremental backup of that library preceding the next full backup of the library, plus any object level saves that are between the two full saves. This assures that the copy that you requested has all changes applied prior to the next full save.
|
|
</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>You must have authority to the Restore Library (RSTLIB) command to use this command.
|
|
</li>
|
|
<li>You must have save system (*SAVSYS) special authority, or have all of the following object authorities:
|
|
<ul>
|
|
<li>You must have *ADD and *READ authority to the QSYS library to restore libraries which do not exist.
|
|
</li>
|
|
<li>You must have *OBJEXIST authority to restore over objects contained in a library.
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li>You must have *USE authority to any auxiliary storage pool device specified for the <b>Auxiliary storage pool (RSTASP)</b> 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>*ALLOBJ special authority is required to use any value other than *NONE for the ALWOBJDIF parameter.
|
|
</li>
|
|
<li>These additional restrictions apply when applying journal changes:
|
|
<ul>
|
|
<li>You must have authority to the APYJRNCHG command.
|
|
</li>
|
|
<li>You must have *EXECUTE authority to the libraries containing the files, journals and journal receivers.
|
|
</li>
|
|
<li>You must have *OBJEXIST authority to restore any files that already exist on the system.
|
|
</li>
|
|
<li>You must have *CHANGE and *OBJMGT authority to apply journal changes to journaled files.
|
|
</li>
|
|
<li>You must have *USE authority to any journal or journal receiver used to apply journal changes.
|
|
</li>
|
|
</ul>
|
|
</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="#RSTLIBBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="RSTLIBBRM.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="#RSTLIBBRM.SAVLIB"><b>SAVLIB</b></a></td>
|
|
<td valign="top">Library</td>
|
|
<td valign="top">Single values: *MEDINF<br>Other values (up to 50 repetitions): <i>Name</i></td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RSTLIBBRM.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 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#RSTLIBBRM.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, Positional 3</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"><a href="#RSTLIBBRM.SAVLVL"><b>SAVLVL</b></a></td>
|
|
<td valign="top">Save level</td>
|
|
<td valign="top">1-99, <b><u>*CURRENT</u></b>, *SAVDATE</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RSTLIBBRM.SAVDATE"><b>SAVDATE</b></a></td>
|
|
<td valign="top">Save date</td>
|
|
<td valign="top"><i>Date</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RSTLIBBRM.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="#RSTLIBBRM.OPTION"><b>OPTION</b></a></td>
|
|
<td valign="top">Option</td>
|
|
<td valign="top"><b><u>*ALL</u></b>, *NEW, *OLD, *FREE</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RSTLIBBRM.MBROPT"><b>MBROPT</b></a></td>
|
|
<td valign="top">Database member option</td>
|
|
<td valign="top"><b><u>*MATCH</u></b>, *ALL, *NEW, *OLD</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RSTLIBBRM.SPLFDTA"><b>SPLFDTA</b></a></td>
|
|
<td valign="top">Spooled file data</td>
|
|
<td valign="top"><b><u>*NEW</u></b>, *NONE</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RSTLIBBRM.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 4 repetitions): *AUTL, *FILELVL, *OWNER, *PGP</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RSTLIBBRM.RSTLIB"><b>RSTLIB</b></a></td>
|
|
<td valign="top">Restore to library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*SAVLIB</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RSTLIBBRM.RSTASP"><b>RSTASP</b></a></td>
|
|
<td valign="top">Auxiliary storage pool</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*SAVASP</u></b>, *SYSTEM</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RSTLIBBRM.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="#RSTLIBBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="RSTLIBBRM.SAVLIB"></a>
|
|
<h3>Library (SAVLIB)</h3>
|
|
<p>Specifies the name of the library that you want to restore.
|
|
</p>
|
|
<p>This is a required field.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*MEDINF</b></dt>
|
|
<dd>You want to restore BRMS media information. The QUSRBRM library contains the BRMS media information.
|
|
<p>
|
|
<b>Note: </b>Recovery for library level information consists of seven objects that are restored to the QUSRBRM library. Recovery for object level information consists of the eight objects that are restored to the QUSRBRM library. The first seven objects are required for library level recovery and the eighth object is required for object level recovery.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
<p><b>Other values (up to 50 repetitions)</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>library-name</i></b></dt>
|
|
<dd>Specify the name of the library that you want to restore. The library name must be an entry in the BRMS media content information.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTLIBBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RSTLIBBRM.DEV"></a>
|
|
<h3>Device (DEV)</h3>
|
|
<p>Specifies the name of the devices used for the restore operation. The device must already be in the BRMS device table.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>Multiple systems can share the use of a tape device or a Media library device (MLB). When the device is a tape device (not an MLB device), BRMS can help you manage the use of the device by multiple systems if you indicate that the device is shared.
|
|
</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 the density specified in the media class is selected to perform the save operation.
|
|
<p>
|
|
<b>Note: </b>The special value *MEDCLS can be specified up to four times on the <b>Device (DEV)</b> parameter only if the parallel Min Resource is of value *NONE. Otherwise, *MEDCLS can only be specified once. BRMS will attempt to use the maximum number of devices that can be allocated for this operation.
|
|
</p>
|
|
<p>To perform a parallel restore with more devices, the value *MEDCLS can and may only be specified once and parallel minimum and maximum resources must be greater than one or *SAV.
|
|
</p>
|
|
</dd>
|
|
<dt><b><i>device-name</i></b></dt>
|
|
<dd>Specify the names of one or more devices used for the restore operation. If you are using more than one device (up to a maximum of four), specify the names of the devices in the order in which they are used.
|
|
<p>
|
|
<b>Note: </b>When doing a serial restore, only one media library device can be specified. When doing a parallel restore, multiple media library devices can be specified.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTLIBBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RSTLIBBRM.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="#RSTLIBBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RSTLIBBRM.SAVLVL"></a>
|
|
<h3>Save level (SAVLVL)</h3>
|
|
<p>Specifies the copy of the library 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 library is restored. This will include the most recent library as well as all incremental backups of the library.
|
|
</dd>
|
|
<dt><b>*SAVDATE</b></dt>
|
|
<dd>Specifies a save date will be used to identify the level of object you want to restore. The save date is specified on <b>Save date (SAVDATE) </b>parameter.
|
|
</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="#RSTLIBBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RSTLIBBRM.SAVDATE"></a>
|
|
<h3>Save date (SAVDATE)</h3>
|
|
<p>Specifies a save date for the object you want to restore. The most recent save of the object on the specified date will be restored. The object is not restored if no save of the object occurred on the specified date.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>A value must be specified for this parameter if *SAVDATE is specified for the <b> Save level (SAVLVL)</b> parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>save-date</i></b></dt>
|
|
<dd>Specify the save date of the object you want to restore. The date must be entered in the format specified by the QDATFMT system value with or without date separators. The system value QDATSEP specifies the date seperator character that can be used.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTLIBBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RSTLIBBRM.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="#RSTLIBBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RSTLIBBRM.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 in the saved library are restored to the library. Old objects on tape or in a save file replace the current versions in the library on the system. Objects not having a current version are added to the library on the system. Objects presently in the library, but not on the media, remain in the library.
|
|
</dd>
|
|
<dt><b>*FREE</b></dt>
|
|
<dd>The saved objects are restored only if they exist in the system library with their space freed. The saved version of each object is restored in the system in its previously freed space. This option restores objects that had their space freed when they were saved. If any saved objects are no longer part of the current version of the library, or if the space is not free for any object, the object is not restored. The restore operation continues, and all of the freed objects are restored.
|
|
</dd>
|
|
<dt><b>*NEW</b></dt>
|
|
<dd>Only the objects in the saved library that do not exist in the current version of the library on the system are added to the library. Only objects not known to the library on the system are restored; known objects are not restored. This option restores objects that were deleted after they were saved or that are new to this library. If any saved objects have a version already in the library on the system, they are not restored, and an informational message is sent for each one, but the restore operation continues.
|
|
</dd>
|
|
<dt><b>*OLD</b></dt>
|
|
<dd>Only the objects in the library having a saved version are restored; that is, the version of each object currently in the library is replaced by the saved version. Only objects known to the library are restored. If any saved objects are no longer part of the online version of the library, they are not added to the library; an informational message is sent for each one, but the restore continues.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTLIBBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RSTLIBBRM.MBROPT"></a>
|
|
<h3>Database member option (MBROPT)</h3>
|
|
<p>Specifies for database files that exist on the system, which members are restored. If *MATCH is used, the member list in the saved file must match, member for member, the current version in the system. All members are restored for files that do not exist, if the file is restored.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*MATCH</u></b></dt>
|
|
<dd>The saved members are restored if the lists of the members where they exist are a match, member for member, for the lists of the current system version. MBROPT(*MATCH) is not valid when *ALL is specified on the <b>Allow object differences (ALWOBJDIF)</b> parameter.
|
|
</dd>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>All members in the saved file are restored.
|
|
</dd>
|
|
<dt><b>*NEW</b></dt>
|
|
<dd>Only new members (members not known to the system) are restored.
|
|
</dd>
|
|
<dt><b>*OLD</b></dt>
|
|
<dd>Only members already known to the system are restored.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTLIBBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RSTLIBBRM.SPLFDTA"></a>
|
|
<h3>Spooled file data (SPLFDTA)</h3>
|
|
<p>Specifies whether saved spooled file data and attributes are restored for restored output queues.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NEW</u></b></dt>
|
|
<dd>Specifies new saved spooled file data and attributes are restored for saved output queues. The saved spooled files will be restored to the same output queue from which these were saved if there is no existing spooled file on the system having the same attributes.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>Specifies no spooled file data or attributes are restored for restored output queues.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTLIBBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RSTLIBBRM.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>File level identifier: </b>The creation date and time of the database file on the system does not match the creation date and time of the file that was saved.
|
|
</li>
|
|
</ul>
|
|
<ul>
|
|
<li><b>Member level identifier: </b>The creation date and time of the database file member on the system does not match the creation date and time of the member that 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>*FILELVL</b></dt>
|
|
<dd>File level identifier and member level identifier differences are allowed.
|
|
<p>An attempt will be made to restore existing physical files even though the physical file on the save media may have a different file level identifier or member level identifier than the physical file on the system. The physical file data will only be restored for those physical files whose format level identifiers on the save media match the format level identifiers of the corresponding physical file on the system.
|
|
</p>
|
|
<p>If this value is not specified, file level identifier and member level identifier differences are not allowed. If an object already exists on the system with a different file level identifier or member level identifier than the saved object, the object is not restored.
|
|
</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="#RSTLIBBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RSTLIBBRM.RSTLIB"></a>
|
|
<h3>Restore to library (RSTLIB)</h3>
|
|
<p>Specifies whether the library contents are restored to the same library from which they were saved, or to a different library.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAVLIB</u></b></dt>
|
|
<dd>The library contents are restored to the same library or libraries in which they were saved.
|
|
</dd>
|
|
<dt><b><i>library-name</i></b></dt>
|
|
<dd>Specify the name of the library to which the saved library contents are restored.
|
|
<p>
|
|
<b>Note: </b>If a Structured Query Language (SQL) database is restored to a library other than the one in which it was saved, the journals are not restored.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTLIBBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RSTLIBBRM.RSTASP"></a>
|
|
<h3>ASP (RSTASP)</h3>
|
|
<p>Specifies whether libraries and objects are restored to the auxiliary storage pool from which they were saved or to a different auxiliary storage pool. Libraries and their contained objects can only be restored to the system (1) auxiliary storage pool, a basic user (2-32) auxiliary storage pool, a primary auxiliary storage pool or a secondary auxiliary storage pool.
|
|
</p>
|
|
<p>More information about object types which can be restored to auxiliary storage pools can be found in the Backup and Recovery book.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAVASP</u></b></dt>
|
|
<dd>The library and objects are restored to the ASP from which they were saved.
|
|
</dd>
|
|
<dt><b>*SYSTEM</b></dt>
|
|
<dd>The library and objects are restored to the system (1) auxiliary storage pool.
|
|
</dd>
|
|
<dt><b><i>auxiliary-storage-pool-name</i></b></dt>
|
|
<dd>The library and objects are restored to the auxiliary storage pool identified by this name. This can be the name of any available basic user auxiliary storage pool (2-32) or any available primary or secondary auxiliary storage pool.
|
|
</dd>
|
|
<dt><b><i>auxiliary-storage-pool-number</i></b></dt>
|
|
<dd>The library and objects are restored to the system (1) or basic auxiliary storage pools (2-32) identified by this number. The range of auxiliary storage pool number is 1-32.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTLIBBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RSTLIBBRM.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>
|
|
<p>If the FROMSYS parameter is specified and the connection to the remote system could not be established then the command will not use local data to perform the restore operation. Use the Work with Media Information (WRKMEDIBRM) or Start Recovery using BRM (STRRCYBRM) commands to select and restore the object.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTLIBBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="RSTLIBBRM.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Restoring a Library using BRMS</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
RSTLIBBRM SAVLIB(MYLIB) DEV(*MEDCLS) COPY(2) RSTASP(3)
|
|
</pre>
|
|
</p>
|
|
<p>This command restores a library called MYLIB. Any device that supports the media class assigned to the media containing MYLIB can be used in the restore operation. The second copy of the library in the media information is restored to auxiliary storage pool (ASP) 3.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTLIBBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="RSTLIBBRM.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>BRM2112</b></dt>
|
|
<dd>ASP &2 not valid.
|
|
</dd>
|
|
<dt><b>CPF4040</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="#RSTLIBBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|