Recovering a fast replication backup

You can use the FRRECOV command to recover copy pools, volumes and data sets from the fast replication backup versions on DASD or tape. Prior to the recovery of a copy pool, DFSMShsm will unallocate the specified catalogs. If DFSMShsm cannot unallocate any of the catalogs, the FRRECOV operation might fail. Catalog reallocates the catalogs when used.

Examples

You can use the following command to recover all of the volumes from a copy pool:
```
FRRECOV COPYPOOL(cpname)
```
The COPYPOOL(cpname) keyword indicates that all volumes associated with the named copy pool are to be recovered. You can specify the VERIFY keyword to verify that none of the volumes are in an unexpected FlashCopy® relationship before starting the recovery. When the copy pool is defined allowing fast reverse restore, VERIFY(Y) indicates DFSMShsm is to verify that the state of the FlashCopy relationships meet the fast reverse restore requirements. Otherwise, regular FlashCopy can be used for the copy pool or the FRRECOV command will be failed. VERIFY(N) indicates that the user has verified that the recovery can proceed successfully. VERIFY(N) cannot be specified when the copy pool is defined allowing fast reverse restore unless a previous FRRECOV COPYPOOL operation has determined the copy pool backup version is no longer eligible to use fast reverse restore. Regular fast replication recovery can be used instead. If one or more volumes fail, the FRRECOV command ends with a nonzero return code. If the copy pool was recovered without using fast reverse restore, volumes that fail recovery can be tried again using the TOVOLUME keyword. If the copy pool was recovered using fast reverse restore and the recovery was incomplete, volumes that were not recovered can be tried again by issuing the FRRECOV COPYPOOL command again. The RESUME(YES) keyword can also be used to retry recovery of volumes that previously failed to recover.
You can use the following command to recover individual volumes:
```
FRRECOV TOVOLUME(volser)
```
The TOVOLUME keyword indicates that only 1 volume should be recovered from the copy pool. If the source volume specified by volume serial number is contained within a storage group that is defined within multiple copy pools, you must also specify the optional parameter FROMCOPYPOOL(cpname).
FRRECOV recovers the most recent DASD version available if it is not given a more specific source. If GENERATION(0) exists on both DASD and tape, the DASD copy is recovered. If the keyword FROMDUMP is used without any further specification of which dump to recover from, recovery of GENERATION(0) is attempted. If GENERATION(0) does not have a dump, then the command fails.
You can use the following command to retrieve the most recent copy of GENERATION(0) (DASD or DUMP) for the volume in the specified copy pool:
```
FRRECOV TOVOLUME(volser) FROMCOPYPOOL(cpname)
```
You can use the following command to recover the GEN(0) dump version of volume volser:
```
FRRECOV TOVOLUME(volser) FROMCOPYPOOL(cpname) FROMDUMP
```
You can specify the FROMDASD keyword to only consider DASD copies.

You can specify the FROMDUMP keyword to consider dump copies only. If two or more dump classes are used for the dump, you can use the DUMPCLASS(dclass) keyword to only consider dumps from dclass. Specify the DUMPVOLUME(dvol) keyword to use tape volser as the source.
Note: DUMPCLASS and DUMPVOLUME are mutually exclusive.

If a version other than the most recent must be recovered, you can specify the GENERATION, VERSION, DATE, or TOKEN keyword. Select the appropriate generation or version from the available versions that are returned by the DFSMShsm LIST command or ARCXTRCT macro.

If DATE is specified, and more than one version exists for that date, then the most recent version from that date is recovered.

Use the TOKEN keyword to recover the unique version that corresponds to that token. If a token of less than 40 characters is passed in, then the token is left justified and padded with binary zeros before a backup version with a matching token is searched for. A hexadecimal token can be specified by using the X'...' Syntax. For example, TOKEN(12345) is equivalent to TOKEN(X'F1F2F3F4F5'). If the token is not unique, the most recent version that corresponds to the token is recovered. If no version exists with the specified token, the recover operation fails.
Results sent back to the user depend on whether the WAIT parameter is specified, and the success or failure of one or more volumes:
- If WAIT is specified by the user and all volumes are successfully processed, a successful return code of zero is returned.
- If WAIT is specified by the user and one or more volumes failed, a non-zero return code, and associated messages, are returned to the caller.
- If WAIT is not specified by the user, control is returned to the caller after the command has been accepted and verified. All messages continue to be issued, but the user is not notified when the command completes.

There is no keyword to perform a recovery at the storage group level.

Recovering a fast replication backup

Examples

Related reading