CL Command Reference - STRRCYBRM
CL Command List > STRRCYBRM Reference
Description:
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.
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.
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 Volume location (LOC) parameter. If you want to select recovery items from duplicated media information, then specify *YES on the Use duplicate media (USEDUPMED) parameter.
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.
Note: 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.
Note: 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.
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.
To use this command, you must have the Backup Recovery and Media Services for iSeries, 5722-BR1, licensed program installed.
Restrictions:
1. You must have authority to the following restore commands:
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)
and must have the object authorities required by those commands as outlined in Appendix D of the iSeries Security Reference.
2. To restore libraries and objects:
. You must have *ADD and *READ authority to the QSYS library to restore libraries which do not exist.
. You must have *OBJEXIST authority to restore over objects contained in a library.
3. To restore documents and folders:
. You must be enrolled in the system distribution directory.
. You must have *CHANGE authority to the parent folder and *ALL authority to the document if it already exists on the system.
. You must have *EXECUTE authority to the document library.
4. To restore directories and files:
. You must have *W and *OBJEXIST authority to file if it already exists on the system.
. You must have *WX authority to the parent directory.
. You must have *ADD authority to the owning user profile of the directory into which the parent directories are created.
. You must have *ALLOBJ special authority to create parent directories with a user profile other than your own.
5. You must have *USE authority to any auxiliary storage pool device when recovering objects to auxiliary storage pool devices.
6. These additional restrictions apply when *APYJRNCHG is specified for the Option (OPTION) parameter:
. You must have authority to the APYJRNCHG command.
. You must have *EXECUTE authority to the libraries containing the files, journals and journal receivers.
. You must have *OBJEXIST authority to restore any files that already exist on the system.
. You must have *CHANGE and *OBJMGT authority to apply journal changes to journaled files.
. You must have *USE authority to any journal or journal receiver used to apply journal changes.
7. This command should not be used by control group *EXIT item processing as results will be unpredictable.
Examples:
Example 1: Print the Recovering Your Entire System Report
STRRCYBRM OPTION(*SYSTEM)
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.
Example 2: Omit Libraries from the Recovering Your Entire System Report
STRRCYBRM OPTION(*SYSTEM) OMITLIB(*DELETE QSC*)
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.
Example 3: Customize STEP 002 of the Recovering Your Entire System Report
Enter the following command to work with the user recovery information file.
WRKMBRPDM FILE(QUSRBRM/QO1AUSRRCY) MBR(STEP002)
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.
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.
STRRCYBRM OPTION(*SYSTEM) USRRCYINF(*ADD)
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.
Example 4: Print the Recovering Your Entire System Report for the Base System
STRRCYBRM OPTION(*SYSBAS)
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.
Example 5: Print the Recovering Your Entire System Report for Auxiliary Storage Pool 2
STRRCYBRM OPTION(*ASP) ASP(2)
This command produces a report to assist you in restoring saved items to basic user auxiliary storage pool 2.
Example 6: Restore Auxiliary Storage Pool Device
MYASP STRRCYBRM OPTION(*ASP) ACTION(*RESTORE) ASP(MYASP)
This command present the Select Recovery Items display containing a list of storing objects saved items from auxiliary storage pool device MYASP.
Example 7: Entire System Recovery Report with a Switched Auxiliary Storage Pool Device
STRRCYBRM ACTION(*REPORT) OPTION(*SYSTEM) ASPDEV(SYSTEM_B PAYROLL)
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.
Example 8: Applying Journal Changes
STRRCYBRM OPTION(*APYJRNCHG) JRN(*JRNLST)
This command prompts the BRMS Work with Journals using BRMS display. The display will be populated with the names of journals which have been saved using BRMS. Use Option 1=Apply changes to show the associated journals receivers on the Apply Journal Changes using BRMS display, then use F16=Apply changes to apply journal changes.