RSTOBJBRM (Restore Object 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.

RSTOBJBRM Command syntax diagram

 

Purpose

The Restore Object using BRM (RSTOBJBRM) command restores an object or several objects from the BRMS media content information. Any object that was saved by the Save Object using BRM (SAVOBJBRM) command or was saved as part of a control group can be restored by the RSTOBJBRM command. The types of objects that can be restored by this command are listed on the OBJTYPE parameter. They can be saved either as separate objects or as part of the library save operation. The RSTOBJBRM command restores the object description and contents of each object specified in the command.

 

Restrictions

• If the user domain object user space (*USRSPC), user index (*USRIDX), or user queue (*USRQ) is restored to a library that is not permitted in the system value QALWUSRDMN (allow user objects in library), the object is converted to the system domain.
• 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 SAVLVL parameter allows you to restore selected copies of an object from the BRMS media content information. For instance, a recovery request for copy 1 of an object will restore the next to the most recent copy of the object on the BRMS media content information (current copy is the most recent copy).
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 RSTOBJBRM

Example 1: Restoring an Object using BRMS

RSTOBJBRM OBJ(AP1000) SAVLIB(APLIB)
DEV(*MEDCLS) OBJTYPE(*FILE)

In the example the restore operation is for an object called AP1000, which is library APLIB. Any device that supports the media class assigned to the media containing AP1000 can be used in the restore operation. AP1000 is a file object type.

Error messages for RSTOBJBRM

None