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

412 lines
18 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>Restore DLO using BRM (RSTDLOBRM)</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="RSTDLOBRM.Top_Of_Page"></a>
<h2>Restore DLO using BRM (RSTDLOBRM)</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="#RSTDLOBRM.PARAMETERS.TABLE">Parameters</a><br>
<a href="#RSTDLOBRM.COMMAND.EXAMPLES">Examples</a><br>
<a href="#RSTDLOBRM.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="RSTDLOBRM"></a>
<p>The Restore DLO using BRM (RSTDLOBRM) command restores documents, folder and distribution objects (mail) to the system from tape or save files. The media policy in force when the media information was saved determines whether this information resides on tape or is stored in save files.
</p>
<p>
<b>Note: </b>Using the RSTDLOBRM command allows you to restore selected copies of document, folder and distribution objects to the system based on the number of copies that are in the BRMS media content information. This is accomplished by specifying a copy number for the <b>Save level (SAVLVL)</b> parameter.
</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>To use this command, you must be enrolled in the system distribution directory.
</li>
<li>You must have authority to the Restore Document Library Object (RSTDLO) command to use this command.
</li>
<li>You must have *CHANGE authority to the parent folder and *ALL authority to the document if it already exists on the system.
</li>
<li>You must have *EXECUTE authority to the document library.
</li>
<li>You cannot run another RSTDLOBRM, RSTDLO, SAVDLOBRM, SAVDLO or Reclaim Document Library Object (RCLDLO) command specifying DLO(*ALL) while this command is running.
</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>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="#RSTDLOBRM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="RSTDLOBRM.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="#RSTDLOBRM.DLO"><b>DLO</b></a></td>
<td valign="top">Document library object</td>
<td valign="top"><i>Character value</i>, *ALL</td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#RSTDLOBRM.SAVFLR"><b>SAVFLR</b></a></td>
<td valign="top">Saved folder</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Required, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#RSTDLOBRM.DEV"><b>DEV</b></a></td>
<td valign="top">Device</td>
<td valign="top"><i>Name</i>, *MEDCLS</td>
<td valign="top">Required, Positional 3</td>
</tr>
<tr>
<td valign="top"><a href="#RSTDLOBRM.RSTFLR"><b>RSTFLR</b></a></td>
<td valign="top">Restore into folder</td>
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RSTDLOBRM.RENAME"><b>RENAME</b></a></td>
<td valign="top">New object name</td>
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RSTDLOBRM.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="#RSTDLOBRM.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="#RSTDLOBRM.NEWOBJ"><b>NEWOBJ</b></a></td>
<td valign="top">Object name generation</td>
<td valign="top"><b><u>*SAME</u></b>, *NEW</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RSTDLOBRM.ALWOBJDIF"><b>ALWOBJDIF</b></a></td>
<td valign="top">Allow object differences</td>
<td valign="top"><b><u>*NONE</u></b>, *ALL</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RSTDLOBRM.RSTASP"><b>RSTASP</b></a></td>
<td valign="top">Restore to ASP</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="#RSTDLOBRM.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="#RSTDLOBRM.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="RSTDLOBRM.DLO"></a>
<h3>Document library object (DLO)</h3>
<p>Specifies the name of the document library object that you want to restore. This is a required parameter.
</p>
<dl>
<dt><b>*ALL</b></dt>
<dd>All documents, folders and distribution objects (mail) that are saved on media and meet the criteria specified on the <b>Saved folder (SAVFLR)</b> parameter are restored.
</dd>
<dt><b><i>document-name</i></b></dt>
<dd>Specify the name of the document library object that you want to restore.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RSTDLOBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RSTDLOBRM.SAVFLR"></a>
<h3>Saved folder (SAVFLR)</h3>
<p>Specifies the name of the folder on the media from which the documents are restored.
</p>
<p>This is a required field.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RSTDLOBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RSTDLOBRM.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 that is known to the system 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>
<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="#RSTDLOBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RSTDLOBRM.RSTFLR"></a>
<h3>Restore into folder (RSTFLR)</h3>
<p>Specifies the name of the folder in which the restored folders and documents to be restored will be placed. The folder must exist on the system or when *ALL is specified on the <b>Document library object (DL0)</b> parameter, the saved folder must exist on the media.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The folders and documents to be restored are placed into the same folder from which they were saved.
</dd>
<dt><b><i>restore-folder-name</i></b></dt>
<dd>Specify the name of the folder where the restored documents and folders are to be placed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RSTDLOBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RSTDLOBRM.RENAME"></a>
<h3>New object name (RENAME)</h3>
<p>Specifies the new user-assigned name for the restored document.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The document is restored with the name it had when it was saved.
</dd>
<dt><b><i>document-name</i></b></dt>
<dd>Specify the new user-assigned name that the document had after being restored.
<p>
<b>Note: </b>You cannot specify a document name if you specify *ALL in the <b>Document library object (DLO)</b> parameter.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RSTDLOBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RSTDLOBRM.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="#RSTDLOBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RSTDLOBRM.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="#RSTDLOBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RSTDLOBRM.NEWOBJ"></a>
<h3>Object name generation (NEWOBJ)</h3>
<p>Specifies whether a new library-assigned name and system object name are generated for the folders and documents being restored.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The library-assigned name and system object name do not change.
</dd>
<dt><b>*NEW</b></dt>
<dd>A new library-assigned name and system object name are generated for each document or folder being restored.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RSTDLOBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RSTDLOBRM.ALWOBJDIF"></a>
<h3>Allow object differences (ALWOBJDIF)</h3>
<p>Specifies whether differences are allowed between the saved objects and the restored objects.
</p>
<p>
<b>Note: </b>To use this parameter, you need *ALLOBJ special authority.
</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>
</div>
<table width="100%">
<tr><td align="right"><a href="#RSTDLOBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RSTDLOBRM.RSTASP"></a>
<h3>Restore to ASP (RSTASP)</h3>
<p>Specifies the system (1) or basic user auxiliary storage pool (2-32) number to which you want to restore document library objects.
</p>
<dl>
<dt><b><u>*SAVASP</u></b></dt>
<dd>Restore the saved document library object to the auxiliary storage pool that it resided in when it was saved by BRMS.
</dd>
<dt><b>*SYSTEM</b></dt>
<dd>The document library object is restored to the system (1) auxiliary storage pool.
</dd>
<dt><b><i>restore-to-ASP-name</i></b></dt>
<dd>Specify the name of the system (1) or basic user auxiliary storage pool (2-32) to which you are restoring the document library object.
</dd>
<dt><b><i>restore-to-ASP-number</i></b></dt>
<dd>Specify the number of the system (1) or basic user auxiliary storage pool (2-32) number to which you want to restore the document library object.
</dd>
</dl>
<p>
<b>Note: </b>UDFS, primary and secondary auxiliary storage pools are not supported for this parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RSTDLOBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RSTDLOBRM.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="#RSTDLOBRM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RSTDLOBRM.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Restoring All DLOs in a Subfolder</b>
</p>
<p>
<pre>
RSTDLOBRM DLO(*ALL) SAVFLR('ACCTMST/ACCT03')
COPY(*CURRENT) DEV(TAP09)
</pre>
</p>
<p>This command allows you to select and restore folders and subfolders that were saved using the SAVDLOBRM command and whose contents information still exist in the media contents information. In this example, the restore operation is for all DLO with a folder called ACCTMST and a subfolder called ACCT03. The most recent copy is restored using device TAP09.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RSTDLOBRM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RSTDLOBRM.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>BRM2112</b></dt>
<dd>ASP &amp;2 not valid.
</dd>
<dt><b>BRM4040</b></dt>
<dd>Access denied for user &amp;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="#RSTDLOBRM.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>