RSTLIBBRM (Restore Library Using BRM)

Note: To use this command, have the 5722-BR1 (Backup Recovery and Media Services for iSeries) licensed program installed. For detailed information on the parameters of this command, see the online help.

RSTLIBBRM Command syntax diagram

 

Purpose

The Restore Library using BRM (RSTLIBBRM) command restores 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.

 

Restrictions

• You must have authority to the RSTOBJ command to use this command.
• You must have *USE authority to any auxiliary storage pool device specified for the RSTASP parameter.>

 

Notes

1. Do not precede an entry with an asterisk unless that entry is a "special value" that is shown (on the display itself or in the help information) with an asterisk.
   
   
2. Use 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 COPY 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.
3. 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 protocol, or *NET, which supports the TCP/IP protocol.

Note: This command should not be used by control group *EXIT item processing as results will be unpredictable.

Example for RSTLIBBRM

Example 1: Restoring a Library using BRMS

RSTLIBBRM SAVLIB(MBALIB) DEV(*MEDCLS)
COPY(2) RSTASP(3)

This command allows you to select and restore libraries or BRMS media information that were saved using a control group or a BRMS save command. In the example, the restore operation is for a library called MBALIB. Any device that supports the media class assigned to the media containing MBALIB can be used in the restore operation. The second copy of the library in the media information is restored to auxiliary storage pool number 3.

Error messages for RSTLIBBRM

None