Starting object recovery for single objects

OAM contains a Single Object Recovery utility for recovering a single object from an optical or tape volume. The system uses a backup copy of the object (either on optical or tape), if any exist. The backup copy that is used for the recovery can reside either on tape or optical media. If more than one backup copy of the object exists, you can select whether to use the first or second backup copy of the object for the recovery by specifying BACKUP1 or BACKUP2 on the F OAM,START,OBJRECV command. A new primary copy of the object is written to the same Object storage group and same media type (optical, tape, or disk) as the original object. The following are examples of how single object recovery works:

If the primary object resides on optical disk, the backup copy that is selected for the recovery (on either optical disk or tape) creates a new optical primary copy.
If the primary object resides on tape, the backup copy that is selected for the recovery (on either optical disk or tape) creates a new tape primary copy.
If the primary object resides on the DB2 sublevel, the backup copy (on either tape or optical disk) creates a new primary copy on the DB2 sublevel.
If the primary object resides on the file system sublevel, the backup copy (on either tape or optical disk) creates a new primary copy on the file system sublevel.

Note: Starting too many single object recoveries at once may result in ABEND878.

To recover a single object:

Enter the following command:
```
F OAM,START,OBJRECV,collection-name,object-name,BACKUP1|BACKUP2
```
_______________________________________________________
The system issues the following message:
```
CBR1000I OAM START command execution scheduled.
```
_______________________________________________________
If the backup volume is an optical volume and does not reside in an optical library, the system issues the following message:
```
CBR4400A Mount volume volser on drive drive-name. Shelf location is shelfloc.
```
_______________________________________________________
If the backup volume is a tape volume, the system issues the following message:
```
IEC501A M drive-Addr,volser,label,,,,data_set_name.
```
_______________________________________________________
Mount the optical volume or tape volume that is identified by volser.
_______________________________________________________
When recovery is complete, the system issues the following message:
```
CBR9830I Single Object Recovery complete for collection collection-name,
         object object-name.
```
_______________________________________________________

The following is a sample of the F OAM,START,OBJRECV command:

F OAM,START,OBJRECV,GROUP22,GROUP22.IDVT.H11,BACKUP2

CBR1000I OAM START command execution scheduled.     
CBR4401I Volume WG688A mounted on drive P9D1.   
CBR4401I Volume WG360A mounted on drive P9D2.   
CBR9830I Single Object Recovery complete for 
collection GROUP22, object  GROUP22.IDVT.H11.

If any errors occur during the single object recovery process, additional messages might be issued identifying the errors.

For descriptions of these messages, see MVS System Messages.