989 lines
45 KiB
HTML
989 lines
45 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>Start Recovery using BRM (STRRCYBRM)</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="STRRCYBRM.Top_Of_Page"></a>
|
||
|
|
<h2>Start Recovery using BRM (STRRCYBRM)</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="#STRRCYBRM.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#STRRCYBRM.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#STRRCYBRM.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="STRRCYBRM"></a>
|
||
|
|
<p>The Start Recovery using BRM (STRRCYBRM) command recovers items ranging from a single library to the entire system. Any library or group of libraries that were saved by a BRMS save command can be restored by this command. Recovery is based on entries in the BRMS media inventory contents information.
|
||
|
|
</p>
|
||
|
|
<p>Recovery using the STRRCYBRM uses the most recent times and dates of entries in the BRMS media content information. This reflects the order in which libraries and objects were saved. For instance, a recovery request for a library will restore the most recent full backup of a library, the latest incremental backup of that library, and all object level saves that have dates after the last full save.
|
||
|
|
</p>
|
||
|
|
<p>BRMS always uses non-duplicated media information when selecting items for recovery regardless of whether the location of the media if a value of *ALL is specified for the <b>Volume location (LOC) </b>parameter. If you want to select recovery items from duplicated media information, then specify *YES on the <b>Use duplicate media (USEDUPMED) </b>parameter.
|
||
|
|
</p>
|
||
|
|
<p>The design of the STRRCYBRM command concerning libraries is to report all the resources needed to recover a library in its entirety. This means that during the search of media information a full backup is required as a starting point in recovering the library. If a full backup is not found meeting the search criteria, any subsequent saves of objects for that library are ignored. This could happen if control group A saves libraries full and control group B saves libraries incremental and the STRRCYBRM OPTION(*CTLGRP) CTLGRP((B) is issued. This could also happen if the time period specified does not have a full backup of the library.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>Prior to processing a restore, you should use the report option (*REPORT) to produce a report of the steps required to restore a portion of the system or the entire system. The report that is produced is the Recovery Analysis report. The report, if printed, is written to printer file QP1ARCY.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>When you are restoring multiple items, such as a *SYSTEM , *SYSBAS or *SAVSYS, it is advisable to first run a Recovery Analysis Report to assist you in evaluating the steps required to restore the requested items. For instance, BRMS cannot install the Licensed Internal Code and restore the operating system for you automatically. The report assists you in locating the required volumes and identifies the manual steps needed to restore the Licensed Internal Code, the operating system, the BRMS product and required system libraries.
|
||
|
|
</p>
|
||
|
|
<p>After you have performed the manual steps, BRMS is able to provide automated assistance in restoring the remainder of the system. The steps required to restore the system are provided in the Recovery Analysis report.
|
||
|
|
</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>You must have authority to the following restore commands:
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
Restore Object (RST)
|
||
|
|
Restore Document Library Object (RSTDLO)
|
||
|
|
Restore Library (RSTLIB)
|
||
|
|
Restore Object (RSTOBJ)
|
||
|
|
Restore Configuration (RSTCFG)
|
||
|
|
Restore User Profiles (RSTUSRPRF)
|
||
|
|
Restore System Information (RSTSYSINF)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>and must have the object authorities required by those commands as outlined in Appendix D of the iSeries Security Reference.
|
||
|
|
</p>
|
||
|
|
</li>
|
||
|
|
<li>To restore libraries and objects:
|
||
|
|
<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>To restore documents and folders:
|
||
|
|
<ul>
|
||
|
|
<li>You must be enrolled in the system distribution directory.
|
||
|
|
</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>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
<li>To restore directories and files:
|
||
|
|
<ul>
|
||
|
|
<li>You must have *W and *OBJEXIST authority to 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 *USE authority to any auxiliary storage pool device when recovering objects to auxiliary storage pool devices.
|
||
|
|
</li>
|
||
|
|
<li>These additional restrictions apply when *APYJRNCHG is specified for the <b>Option (OPTION) </b>parameter:
|
||
|
|
<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="#STRRCYBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="STRRCYBRM.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="#STRRCYBRM.OPTION"><b>OPTION</b></a></td>
|
||
|
|
<td valign="top">Option</td>
|
||
|
|
<td valign="top"><b><u>*SYSTEM</u></b>, *ALLDLO, *ALLUSR, *APYJRNCHG, *ASP, *ASPDEV, *CTLGRP, *IBM, *LIB, *LNKLIST, *RCYEXITPGM, *RESUME, *SAVSYS, *SYSBAS</td>
|
||
|
|
<td valign="top">Optional, Positional 1</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRRCYBRM.ACTION"><b>ACTION</b></a></td>
|
||
|
|
<td valign="top">Action</td>
|
||
|
|
<td valign="top"><b><u>*REPORT</u></b>, *RESTORE</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="7"><a href="#STRRCYBRM.PERIOD"><b>PERIOD</b></a></td>
|
||
|
|
<td valign="top">Time period for recovery</td>
|
||
|
|
<td valign="top"><i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="7">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Start time and date</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Element list</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" style="padding-left:10pt">Element 1: Beginning time</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Time</i>, <b><u>*AVAIL</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" style="padding-left:10pt">Element 2: Beginning date</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i>, <b><u>*BEGIN</u></b>, *CURRENT</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: End time and date</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Element list</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" style="padding-left:10pt">Element 1: Ending time</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Time</i>, <b><u>*AVAIL</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" style="padding-left:10pt">Element 2: Ending date</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i>, <b><u>*END</u></b>, *CURRENT</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRRCYBRM.USESAVF"><b>USESAVF</b></a></td>
|
||
|
|
<td valign="top">Use save files</td>
|
||
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRRCYBRM.USEADSM"><b>USEADSM</b></a></td>
|
||
|
|
<td valign="top">Use TSM</td>
|
||
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRRCYBRM.ASP"><b>ASP</b></a></td>
|
||
|
|
<td valign="top">Auxiliary storage pool</td>
|
||
|
|
<td valign="top">1-32, <b><u>*SYSTEM</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRRCYBRM.LIB"><b>LIB</b></a></td>
|
||
|
|
<td valign="top">Library</td>
|
||
|
|
<td valign="top"><i>Generic name, name</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRRCYBRM.LIST"><b>LIST</b></a></td>
|
||
|
|
<td valign="top">List</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*ALL</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#STRRCYBRM.JRN"><b>JRN</b></a></td>
|
||
|
|
<td valign="top">Journal</td>
|
||
|
|
<td valign="top">Single values: <b><u>*JRNLST</u></b><br>Other values (up to 25 repetitions): <i>Qualified object name</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Qualifier 1: Journal</td>
|
||
|
|
<td valign="top"><i>Name</i></td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top">Qualifier 2: Library</td>
|
||
|
|
<td valign="top"><i>Name</i></td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top" rowspan="4"><a href="#STRRCYBRM.ASPDEV"><b>ASPDEV</b></a></td>
|
||
|
|
<td valign="top">ASP device</td>
|
||
|
|
<td valign="top">Values (up to 25 repetitions): <i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="4">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: From system</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Name</i>, <b><u>*LCL</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Auxiliary storage pool</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Name</i>, <b><u>*ALL</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 3: Objects</td>
|
||
|
|
<td valign="top">
|
||
|
|
<b><u>*ALL</u></b>, *LIB, *LNK</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#STRRCYBRM.CTLGRP"><b>CTLGRP</b></a></td>
|
||
|
|
<td valign="top">Control group selection</td>
|
||
|
|
<td valign="top">Single values: <b><u>*SELECT</u></b><br>Other values (up to 300 repetitions): <i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Control group</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Name</i>, *NONE, *BKUGRP, *SYSGRP, *SYSTEM</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Sequence number</td>
|
||
|
|
<td valign="top">
|
||
|
|
1-99, <b><u>1</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRRCYBRM.OMITLIB"><b>OMITLIB</b></a></td>
|
||
|
|
<td valign="top">Libraries to omit</td>
|
||
|
|
<td valign="top">Values (up to 25 repetitions): <i>Generic name, name</i>, <b><u>*DELETE</u></b>, *NONE</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRRCYBRM.ALWDUP"><b>ALWDUP</b></a></td>
|
||
|
|
<td valign="top">Allow duplicate entries</td>
|
||
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRRCYBRM.LOC"><b>LOC</b></a></td>
|
||
|
|
<td valign="top">Volume location</td>
|
||
|
|
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values (up to 10 repetitions): <i>Name</i>, *HOME</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRRCYBRM.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>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRRCYBRM.PRTSYSINF"><b>PRTSYSINF</b></a></td>
|
||
|
|
<td valign="top">Print system information</td>
|
||
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRRCYBRM.USEDUPMED"><b>USEDUPMED</b></a></td>
|
||
|
|
<td valign="top">Use duplicate media</td>
|
||
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRRCYBRM.USRRCYINF"><b>USRRCYINF</b></a></td>
|
||
|
|
<td valign="top">User recovery information</td>
|
||
|
|
<td valign="top"><b><u>*NONE</u></b>, *ADD</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRCYBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="STRRCYBRM.OPTION"></a>
|
||
|
|
<h3>Option (OPTION)</h3>
|
||
|
|
<p>Specifies what you want to restore from the BRMS media content inventory.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SYSTEM</u></b></dt>
|
||
|
|
<dd>You want to restore the system (1) and basic user (2-32) auxiliary storage pools and auxiliary storage pool devices based on the BRMS media content information.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ALLDLO</b></dt>
|
||
|
|
<dd>You want to restore all documents, folders, and distribution objects (mail) from the media content information that meet the specified starting and ending date.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ALLUSR</b></dt>
|
||
|
|
<dd>You want to restore all user libraries that were saved using the *ALLUSR special value.
|
||
|
|
<p>Refer to the Special Values table for the Save Library (SAVLIB) Command in the Saving Libraries section of the iSeries Backup and Recovery book for a list of libraries which can be restored using this special value.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*APYJRNCHG</b></dt>
|
||
|
|
<dd>You want to apply journaled changes. Specify the journals using the <b>Journal (JRN)</b> parameter. The value of the <b>From system (FROMSYS)</b> parameter will be ignored if this value is specified.
|
||
|
|
<p>If you want to apply journaled changes to a point in time, specify the point in time on the <b>End time and date </b>prompt of the <b>Time period for recovery (PERIOD) </b>parameter.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ASP</b></dt>
|
||
|
|
<dd>You want to restore the system (1) or basic user (2-32) auxiliary storage pool. You must specify the auxiliary storage pool using the <b>Auxiliary storage pool (ASP) </b> parameter. If you are restoring system (1) auxiliary storage pool, only user data is restored, not the operating system.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ASPDEV</b></dt>
|
||
|
|
<dd>You want to restore auxiliary storage pool devices. Specify the systems, auxiliary storage pool devices, and objects using the <b>ASP device (ASPDEV)</b> parameter. The value of the <b>From system (FROMSYS)</b> parameter will be ignored if this value is specified.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CTLGRP</b></dt>
|
||
|
|
<dd>You want to restore a control group and its associated save items from the media content information. You must specify the control group name in the <b>Control group selection (CTLGRP)</b> parameter.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>When you select *NONE in the CTLGRP parameter you are indicating that you want to restore saved items from the media content information file not associated with a control group name.
|
||
|
|
</p>
|
||
|
|
<p>Additionally you have the option of selecting up to 300 control groups to restore when you use the *SELECT option in the CTLGRP parameter. You can sequence the order in which the selected control groups are restored by using the <b>Sequence number</b> element of the CTLGRP parameter.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*IBM</b></dt>
|
||
|
|
<dd>You want to restore all system (IBM) libraries that were saved using the *IBM special value.
|
||
|
|
<p>Refer to the Special Values table for the Save Library (SAVLIB) Command in the Saving Libraries section of the iSeries Backup and Recovery book for a list of libraries which can be restored using this special value.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LIB</b></dt>
|
||
|
|
<dd>You want to restore a library from the media content information. You must specify the library name in the <b>Library (LIB)</b> parameter. The latest version of the library is restored from the BRMS media content information by using the latest full save plus any incremental and object saves subsequent to the latest full save.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LNKLIST</b></dt>
|
||
|
|
<dd>You want to restore all integrated file system objects that were specified in a list from the media content information that meet the specified starting and ending date. Specify the backup link list using the <b>List (LIST)</b> parameter when using this special value.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*RCYEXITPGM</b></dt>
|
||
|
|
<dd>Any objects that have been recovered and are waiting for a recovery exit program to be called to reestablish relationships between related objects will be called passing the list of objects that were restored.
|
||
|
|
<p>This step is required to successfully rebuild objects that specified recovery exit processing when the objects were saved.
|
||
|
|
</p>
|
||
|
|
<p>During a complete system recovery, steps are provided to restore all system and user data back to the system. Some of these objects were saved requesting that a recovery exit program be called via the <b>Recovery exit program (RCYEXITPGM)</b> parameter. The objects are all restored by BRMS in the appropriate recovery step, and each object that requires a call to a recovery exit program is put into a list. After all data for the recovery is restored, the exit program is called for each package through processing of this option.
|
||
|
|
</p>
|
||
|
|
<p>A package is a related group of media files that were grouped together during the save operation by specifying a value on the <b>Package identifier (PKGID)</b> parameter.
|
||
|
|
</p>
|
||
|
|
<p>In a recovery of a single object or package that had requested a recovery exit program be called on recovery, this step will be done in the same way, the objects will be restored and the exit program will be called with the list of objects.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*RESUME</b></dt>
|
||
|
|
<dd>You want to start the recovery from the point where the recovery stopped.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SAVSYS</b></dt>
|
||
|
|
<dd>You want to restore the operating system based on the BRMS media content information.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SYSBAS</b></dt>
|
||
|
|
<dd>You want to restore only the system (1) and basic user auxiliary storage pools (2-32) based on the BRMS media content information.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRCYBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRRCYBRM.ACTION"></a>
|
||
|
|
<h3>Action (ACTION)</h3>
|
||
|
|
<p>You can either specify whether you want to create a Recovery Analysis Report or perform an actual recovery.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*REPORT</u></b></dt>
|
||
|
|
<dd>You want to create the Recovery Analysis Report. This is recommended prior to restoring the system or *IBM to assure that the required media is available and that all necessary saves have been performed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*RESTORE</b></dt>
|
||
|
|
<dd>You want to restore the requested items from the BRMS media content information.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>If you specify *RESTORE and have specified *SYSTEM for the <b>Option (OPTION)</b> parameter, you will be returned to the Perform Recovery display.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRCYBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRRCYBRM.PERIOD"></a>
|
||
|
|
<h3>Time period for recovery (PERIOD)</h3>
|
||
|
|
<p>Specifies the period of time for which the recovery items are selected for recovery. Selected items are either included in the recovery report or recovered. This is dependent on the value specified in the <b>Action (ACTION)</b> parameter.
|
||
|
|
</p>
|
||
|
|
<p><b>Element 1: Start Time and date</b>
|
||
|
|
</p>
|
||
|
|
<p><b>Element 1: Beginning time</b>
|
||
|
|
</p>
|
||
|
|
<p>One of the following is used to specify the beginning creation time at which or after recovery items are included. Any items created before the specified time and date are not included in the selected recovery items.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*AVAIL</u></b></dt>
|
||
|
|
<dd>Any time that is available for the beginning date is included.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>begin-time</i></b></dt>
|
||
|
|
<dd>Specify the beginning time for the specified beginning date that indicates which recovery items are to be included.
|
||
|
|
<p>The time is specified in 24-hour format and can be specified with or without a time separator:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>Without a time separator, specify a string of 4 or 6 digits (hhmm or hhmmss) where hh=hours, mm=minutes and ss=seconds. Hours, minutes, and seconds must each be exactly 2 digits (using leading zeros if necessary).
|
||
|
|
</li>
|
||
|
|
<li>With a time separator, specify a string of 5 or 8 digits where the time separator specified for your job is used to separate the hours, minutes, and seconds. If you enter this command from the command line, the string must be enclosed in apostrophes. If a time separator other than the separator specified for your job is used, this command will fail.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: Beginning date</b>
|
||
|
|
</p>
|
||
|
|
<p>One of the following is used to specify the beginning date on or after which the recovery items must have been saved. Any entries saved prior to the specified date are not included in the recovery.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*BEGIN</u></b></dt>
|
||
|
|
<dd>Recovery items from the beginning of the media content information are recovered.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CURRENT</b></dt>
|
||
|
|
<dd>Recovery items with a current date creation date and between the specified beginning and ending times (if specified) are recovered.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>begin-date</i></b></dt>
|
||
|
|
<dd>Specify the beginning date. The date must be specified in the job date format.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: End time and date</b>
|
||
|
|
</p>
|
||
|
|
<p><b>Element 1: Ending time</b>
|
||
|
|
</p>
|
||
|
|
<p>One of the following is used to specify the ending time before which recovery items are included. Any items created after the specified time and date are not included in the recovery items selected for recovery.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*AVAIL</u></b></dt>
|
||
|
|
<dd>Any time that is available for the ending date is included.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>end-time</i></b></dt>
|
||
|
|
<dd>Specify the ending time for the specified ending date that indicates which recovery items are to be included.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: Ending date</b>
|
||
|
|
</p>
|
||
|
|
<p>One of the following is used to specify the ending date on which or before which the recovery items must have been saved. Any recovery items created after the specified date are not included in the recovery operation.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*END</u></b></dt>
|
||
|
|
<dd>The recovery items to the end of the recovery information are recovered.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CURRENT</b></dt>
|
||
|
|
<dd>Recovery items whose save date is on or before the current date are included in the recovery.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>end-date</i></b></dt>
|
||
|
|
<dd>Specify the ending date. The date must be specified in the job date format.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRCYBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRRCYBRM.USESAVF"></a>
|
||
|
|
<h3>Use save files (USESAVF)</h3>
|
||
|
|
<p>Specifies whether you want to use save files for recovery.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*YES</u></b></dt>
|
||
|
|
<dd>You do want to use save files for recovery. If the library that you want to recover is saved both on tape and a save file, and the save time and dates are the same, then BRMS will use the save file for recovery.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>You do not want to use save files for recovery.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRCYBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRRCYBRM.USEADSM"></a>
|
||
|
|
<h3>Use ADSM (USEADSM)</h3>
|
||
|
|
<p>Specifies whether data stored on the TSM (ADSM) server is included in the recovery. When the recovery includes data saved to TSM servers, additional steps are added to the recovery report to assist in the recovery of this data. During a full system recovery, the TSM server data is recovered after the system (1) and basic user (2-32) auxiliary storage pool data is recovered and after the initial IPL. This assures the necessary operating system resources are available for establishing the connection to the TSM server. BRMS also makes recovery decisions based on where the recovery data resides. For example, when the current full backup is stored on a TSM server, but incremental backups are stored on tape, the BRMS report or plan will indicate that the full backup from the TSM server must occur first, followed by the recovery of the incremental saves from tape.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*YES</u></b></dt>
|
||
|
|
<dd>Include TSM data in the recovery report or plan.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>Do not include TSM data in the recovery report or plan.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRCYBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRRCYBRM.ASP"></a>
|
||
|
|
<h3>Auxiliary storage pool (ASP)</h3>
|
||
|
|
<p>Specifies the system (1) or basic user (2-32) auxiliary storage pool that you want to restore. The ASP parameter is a required field when the <b>Option (OPTION)</b> parameter is *ASP. If you are restoring the system (1) auxiliary storage pool, only user data is restored, not the operating system.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SYSTEM</u></b></dt>
|
||
|
|
<dd>You want to restore the system (1) auxiliary storage pool.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>auxiliary storage pool name</i></b></dt>
|
||
|
|
<dd>Specify the name of the basic user auxiliary storage pool that you want to restore.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>auxiliary-storage-pool-number</i></b></dt>
|
||
|
|
<dd>Specify the number of the system (1) or basic user (2-32) auxiliary storage pool that you want to restore.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRCYBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRRCYBRM.LIB"></a>
|
||
|
|
<h3>Library (LIB)</h3>
|
||
|
|
<p>Specifies the name of the library that you want to restore. Library is a required field when the Option field contains *LIB.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>library-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the library that you want to restore.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>generic*-library-name</i></b></dt>
|
||
|
|
<dd>Specify one or more generic names of groups of libraries that you want to restore. A generic name is a character string that contains one or more characters followed by an asterisk (*). If an * is not specified with the name, the system assumes that the name is a complete library name.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRCYBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRRCYBRM.LIST"></a>
|
||
|
|
<h3>List (LIST)</h3>
|
||
|
|
<p>Specifies the name of the list for the recovery operation.
|
||
|
|
</p>
|
||
|
|
<p>When *LNKLIST is specified for the <b>Option (OPTION)</b> parameter the <b>List (LIST)</b> parameter specifies the name of the integrated file system list that you want to restore. You can restore a single list or all lists.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ALL</u></b></dt>
|
||
|
|
<dd>All integrated file system lists are selected for recovery.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>link-list-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the integrated file system list that you want to restore.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRCYBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRRCYBRM.JRN"></a>
|
||
|
|
<h3>Journal (JRN)</h3>
|
||
|
|
<p>Specifies the qualified names of the journals to be included in the apply journal changes operation. Up to 25 qualified names can be specified.
|
||
|
|
</p>
|
||
|
|
<p><b>Restrictions:</b>
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>This parameter is only valid when *APYJRNCHG is specified for the <b>Option (OPTION)</b> parameter.
|
||
|
|
</li>
|
||
|
|
<li>*LCL must be specified for the <b>From system (FROMSYS)</b> parameter.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*JRNLST</u></b></dt>
|
||
|
|
<dd>The names of the journals to be included in the apply journal changes operation are retrieved from a list of saved journals.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Qualifier 1: Journal </b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the journal to be included in the apply journal changes operation.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Qualifier 2: Library </b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the library containing the journal to be included in the apply journal changes operation.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRCYBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRRCYBRM.ASPDEV"></a>
|
||
|
|
<h3>ASP device (ASPDEV)</h3>
|
||
|
|
<p>Specifies auxiliary storage pool devices which are to be included in the recovery of the current system. Up to 25 iterations can be specified.
|
||
|
|
</p>
|
||
|
|
<p><b>Restrictions: </b>
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>This parameter is only valid when *SYSTEM or *ASPDEV is specified for the <b>Option (OPTION)</b> parameter.
|
||
|
|
</li>
|
||
|
|
<li>*LCL must be specified for the <b>From system (FROMSYS)</b> parameter.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>To include objects in auxiliary storage pool devices saved on other systems in the recovery, the current system must be receiving media content information from the systems which saved the auxiliary storage pool device information.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>To recover objects in auxiliary storage pool devices saved on other systems, the current system must have devices which support the density of the media volumes containing the saved items.
|
||
|
|
</p>
|
||
|
|
<p><b>Element 1: From system </b>
|
||
|
|
</p>
|
||
|
|
<p>Specifies the system where the auxiliary storage pool device was saved.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LCL</u></b></dt>
|
||
|
|
<dd>Include auxiliary storage pool devices saved on the current system in the recovery.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>system-name</i></b></dt>
|
||
|
|
<dd>Include auxiliary storage pool devices saved on the specified system in the recovery.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>network-id.system-name</i></b></dt>
|
||
|
|
<dd>Include auxiliary storage pool devices saved on the specified system in the recovery. Format of the system name is nnnnnnnn.cccccccc where nnnnnnnn is the network identifier and cccccccc is the default local location name.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: Auxiliary storage pool </b>
|
||
|
|
</p>
|
||
|
|
<p>Specifies the name of the auxiliary storage pool device.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ALL</u></b></dt>
|
||
|
|
<dd>Include all auxiliary storage pool devices in the recovery.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>auxiliary-storage-pool-name</i></b></dt>
|
||
|
|
<dd>Include the auxiliary storage pool device identified by this name in the recovery.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 3: Objects </b>
|
||
|
|
</p>
|
||
|
|
<p>Specifies the type of objects.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ALL</u></b></dt>
|
||
|
|
<dd>Include all objects in the recovery.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LIB</b></dt>
|
||
|
|
<dd>Include only library objects in the recovery.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LNK</b></dt>
|
||
|
|
<dd>Include only directory and file objects in the recovery.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRCYBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRRCYBRM.CTLGRP"></a>
|
||
|
|
<h3>Control group selection (CTLGRP)</h3>
|
||
|
|
<p>Specifies the name of the control group that you want to restore. The CTLGRP) parameter is a required field when the <b>Option (OPTION)</b> parameter contains *CTLGRP. You can specify a single control group or you can specify multiple control groups and sequence the order in which they are restored.
|
||
|
|
</p>
|
||
|
|
<p>When you want to select a control group or groups from a list of control groups, specify *SELECT in the CTLGRP parameter and press Enter. You are taken to the Select and Sequence Control Groups display where all control groups that are in the media content information are displayed. You can select and sequence each control group that you want to restore by putting a sequence number by each control group to establish a relative restore order. Sequence numbers can range from 1 to 99. Up to 300 control groups can be selected and can share the same sequence number.
|
||
|
|
</p>
|
||
|
|
<p>If the full and incremental saves are done in different control groups, it would be necessary to specify both control groups in order for the incremental entries to be selected. For example you could specify STRRCYBRM OPTION(*CTLGRP) CTLGRP((A) (B)).
|
||
|
|
</p>
|
||
|
|
<p>A sequence number can be used with the control group names to ensure the sequence of the entries on the report. Do not sequence the incremental control group ahead of the full control group. If this is done, the full save will be restored over the incremental. It is a good idea to use different sequence numbers for control groups that are running at the same time. Otherwise there may be alot of loading and unloading of different tapes. For instance, control group C runs at the same time as A, and D the same time as B. In this case STRRCYBRM OPTION(*CTLGRP) CTLGRP((A 10) (C 10) (B 20) (D 20) may be an appropriate use of sequence numbers.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*SELECT</b></dt>
|
||
|
|
<dd>You want to select a control group or groups from a list of control groups to restore from the media content information. This parameter can not be used in batch operations.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Other values (up to 300 repetitions)</b>
|
||
|
|
</p>
|
||
|
|
<p><b>Element 1: Control group </b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*NONE</b></dt>
|
||
|
|
<dd>You want to restore data that is not associated with a control group.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*BKUGRP</b></dt>
|
||
|
|
<dd>You want to restore the backup user data control group.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SYSGRP</b></dt>
|
||
|
|
<dd>You want to restore the system data control group.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SYSTEM</b></dt>
|
||
|
|
<dd>You want to restore the backup entire system control group.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>control-group-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the control group that you want to restore.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: Sequence number </b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>sequence-number</i></b></dt>
|
||
|
|
<dd>Specify a number from 1 to 99 to indicate the order in which you want to restore selected control groups. You can specify the same sequence number on several control groups.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>The sequence number is ignored if *NONE is specified in the CTLGRP parameter.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRCYBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRRCYBRM.OMITLIB"></a>
|
||
|
|
<h3>Libraries to omit (OMITLIB)</h3>
|
||
|
|
<p>Specifies the libraries you want to omit from recovery. You can choose to includes all libraries, or exclude deleted libraries and/or specifies libraries, and/or generic libraries. Up to 25 iterations can be specified.
|
||
|
|
</p>
|
||
|
|
<p>Single values:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*NONE</b></dt>
|
||
|
|
<dd>Include all libraries in the recovery.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>Other values:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*DELETE</u></b></dt>
|
||
|
|
<dd>Exclude deleted libraries from the recovery.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>library-name</i></b></dt>
|
||
|
|
<dd>Exclude the named library from recovery.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>*generic-library-name</i></b></dt>
|
||
|
|
<dd>Exclude libraries beginning with this generic name from recovery.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRCYBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRRCYBRM.ALWDUP"></a>
|
||
|
|
<h3>Allow duplicate entries (ALWDUP)</h3>
|
||
|
|
<p>Specifies whether to allow duplicate entries in the list of control groups that you can select to restore.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NO</u></b></dt>
|
||
|
|
<dd>Duplicate control group entries are not allowed in the Select and Sequence Control Groups display.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>Duplicates are allowed in the Select and Sequence Control Groups display.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRCYBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRRCYBRM.LOC"></a>
|
||
|
|
<h3>Volume location (LOC)</h3>
|
||
|
|
<p>Specifies the locations that you want to include in the recovery.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ALL</u></b></dt>
|
||
|
|
<dd>Include all locations that have been set up in BRMS.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Other values (up to 10 repetitions)</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*HOME</b></dt>
|
||
|
|
<dd>Include the home location in the recovery.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>location-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the location that you want to include in the recovery. You can specify up to 10 locations.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRCYBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRRCYBRM.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="#STRRCYBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRRCYBRM.PRTSYSINF"></a>
|
||
|
|
<h3>Print system information (PRTSYSINF)</h3>
|
||
|
|
<p>Specifies whether you want to include system information in recovery reports that you print when processing this command. If you specify *YES, the Print System Information (PRTSYSINF) command is processed.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NO</u></b></dt>
|
||
|
|
<dd>Do not included system information when recovery reports are printed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>Include system information when recovery reports are printed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRCYBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRRCYBRM.USEDUPMED"></a>
|
||
|
|
<h3>Use duplicate media (USEDUPMED)</h3>
|
||
|
|
<p>Specifies whether you want to use the original save media or duplicate save media when selecting history items for recovery. You may want to use this option if you move your original media offsite and keep duplicates of the original media onsite. The default value is *NO.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NO</u></b></dt>
|
||
|
|
<dd>Specifies you want to use the original save media when selecting history items for recovery.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>Specifies you want to use duplicate media when selecting history items for recovery.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRCYBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRRCYBRM.USRRCYINF"></a>
|
||
|
|
<h3>User recovery (USRRCYINF)</h3>
|
||
|
|
<p>Specifies whether you want user recovery information added to the BRMS Recovery Report (QP1ARCY) created by this command.
|
||
|
|
</p>
|
||
|
|
<p><b>Usage notes: </b>
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>User recovery information can be included in the recovery report by adding records containing the information to the appropriate members of file QO1AUSRRCY in library QUSRBRM. Add records to member PROLOG to include user recovery information to the prolog information in the report. Add records to members STEPnnn to include user recovery information to specific steps in the report, where nnn is the step number as it appears on the report. Up to 92 bytes of user recovery information can be added to each record. There is no limit to the number of records.
|
||
|
|
</li>
|
||
|
|
<li>User recovery information is added to the report following the BRMS information and before any saved items in the step. This information will be clearly highlighted on the report as user recovery information.
|
||
|
|
</li>
|
||
|
|
<li>Each record is read sequentially from the file member, starting from the first record and ending with the last record, and will be added to the report in the same order as read. Each record will be placed on the report following the last printed line starting in column 8.
|
||
|
|
</li>
|
||
|
|
<li>The user is responsible for all spacing, positioning and translation of the recovery information in each record.
|
||
|
|
</li>
|
||
|
|
<li>The user is responsible for assuring the accuracy of the user recovery information.
|
||
|
|
</li>
|
||
|
|
<li>The step numbers in the report differ depending on the value of the <b>Option (OPTION) </b>parameter and the content of the recovery. If the OPTION or content is changed, the names of the members in file QO1AUSRRCY may need to be renamed accordingly. The step numbers should be consistent if the report type and saved item content are consistent.
|
||
|
|
</li>
|
||
|
|
<li>No exception is signaled if user recovery information is requested but no records are found in the members.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>Specifies no user recovery information is available for the report.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ADD</b></dt>
|
||
|
|
<dd>Specifies user recovery information is available and is to be added to the report.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This value can only be specified if *REPORT is specified for the <b>Action (ACTION) </b>parameter.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRCYBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="STRRCYBRM.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Print the Recovering Your Entire System Report</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
STRRCYBRM OPTION(*SYSTEM)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command produces a recovery report to assist you in restoring the entire system which includes the system (1) and basic user (2-32) auxiliary storage pools and any auxiliary storage pool devices.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: Omit Libraries from the Recovering Your Entire System Report</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
STRRCYBRM OPTION(*SYSTEM) OMITLIB(*DELETE QSC*)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command produces a report to assist you in recovering the entire system which includes the system (1) and basic user (2-32) auxiliary storage pools and any auxiliary storage pool devices. However, deleted libraries and libraries beginning with the generic name QSC* are omitted from the report.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 3: Customize STEP 002 of the Recovering Your Entire System Report</b>
|
||
|
|
</p>
|
||
|
|
<p>Enter the following command to work with the user recovery information file.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
WRKMBRPDM FILE(QUSRBRM/QO1AUSRRCY) MBR(STEP002)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>Edit the member using option 2=Edit on member STEP002. Enter the detailed user recovery information you want added to the report. When finished, exit the Edit display and indicate on the Exit display to save the edit session changes.
|
||
|
|
</p>
|
||
|
|
<p>Run the following command to print the report and validate the user recovery information in STEP 002. Use the same command to generate all future reports using the user recovery information.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
STRRCYBRM OPTION(*SYSTEM) USRRCYINF(*ADD)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>The above steps show how to customized STEP 002 in the Recovering Your Entire System Report by adding your own user recovery information. You might do this to provide your system operators with special detailed guidance unique to your recovery. You can do this with any or all steps in the report.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 4: Print the Recovering Your Entire System Report for the Base System</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
STRRCYBRM OPTION(*SYSBAS)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command produces a report to assist you in restoring the base system which includes the system (1) and basic user (2-32) auxiliary storage pools, excluding any auxiliary storage pool devices.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 5: Print the Recovering Your Entire System Report for Auxiliary Storage Pool 2</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
STRRCYBRM OPTION(*ASP) ASP(2)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command produces a report to assist you in restoring saved items to basic user auxiliary storage pool 2.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 6: Restore Auxiliary Storage Pool Device MYASP</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
STRRCYBRM OPTION(*ASP) ACTION(*RESTORE) ASP(MYASP)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command present the <b>Select Recovery Items</b> display containing a list of storing objects saved items from auxiliary storage pool device MYASP.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 7: Entire System Recovery Report with a Switched Auxiliary Storage Pool Device</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
STRRCYBRM ACTION(*REPORT) OPTION(*SYSTEM)
|
||
|
|
ASPDEV(SYSTEM_B PAYROLL)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command produces a report to assist you in restoring the current system including auxiliary storage pool device PAYROLL saved on SYSTEM_B. SYSTEM_B is a system in the BRMS network and is networking media information about its saves to the current system.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 8: Applying Journal Changes </b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
STRRCYBRM OPTION(*APYJRNCHG) JRN(*JRNLST)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command prompts the BRMS <b>Work with Journals using BRMS </b>display. The display will be populated with the names of journals which have been saved using BRMS. Use <b>Option 1=Apply changes</b> to show the associated journals receivers on the <b>Apply Journal Changes using BRMS </b>display, then use <b>F16=Apply changes</b> to apply journal changes.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRCYBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="STRRCYBRM.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>BRM4040</b></dt>
|
||
|
|
<dd>Access denied for user &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>BRM40A2</b></dt>
|
||
|
|
<dd>BRMS product initialization required.
|
||
|
|
</dd>
|
||
|
|
<dt><b>BRM61FF</b></dt>
|
||
|
|
<dd>Recovery completed with errors.
|
||
|
|
</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="#STRRCYBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|