SVTSUTIL Batch Commands › SVTSUTIL Batch Commands › RECOVER=GLOBAL

RECOVER=GLOBAL

This command is used when running the SVTSUTIL program to recover a damaged Global VCAT from the BSDS. The BSDS only contains information pertaining to Virtual Volumes. If the Global VCAT being recovered was using Dynamic Cache Management, nothing else needs to be done to the Global VCAT after the recovery is complete. If the Global VCAT being recovered was using Static Cache Management, only the static cache LDSs allocated to a Virtual Volume will be automatically added back into the Global VCAT. After the recovery is complete, start a CA Vtape Subsystem and execute the LDS_ADD SVTSUTIL command to add the remaining static cache LDSs back into the Global VCAT.

This command is intended for recovery situations, such as an off-site disaster recovery, a Global VCAT volume failure, or a DASD buffer volume failure.

Syntax

RECOVER=GLOBAL,PREFIX=prefix [,NOINIT] [,SCRATCH] [,DROP_INELIGIBLE]

You can use the optional NOINIT parameter when recovery is being done into an existing Global VCAT. This parameter improves the performance of the recovery and can reduce the elapsed time needed to recover a Global VCAT. Do not use the NOINIT parameter when recovering into a newly allocated, noninitialized Global VCAT, as the recovery will fail. Use of this parameter is limited to those times when the Global VCAT was previously initialized.

The optional SCRATCH parameter causes Virtual Volumes being recovered in the Global VCAT to be automatically scratched if they do not reside in their assigned LDSs. This parameter would normally be used when recovery is being done at a disaster recovery site or after a DASD buffer volume failure. Without the parameter, the Virtual Volume entry is returned to the Global VCAT as is for manual resolution. An error message is issued for Virtual Volumes that cannot be recovered.

The optional DROP_INELIGIBLE parameter provides a method for deleting static cache LDSs that were defined, but are no longer required. The LDSs must be unavailable, uncataloged, or fail open during the recover process. If this occurs, the LDS will be deleted from any virtual assignment and will not show in List=Cache reports. If an associated nonscratch virtual is referenced, a new LDS will be assigned, and Recall will proceed normally at first reference.

If a Virtual Volume Entry is found during the recovery that does not have a group number and subgroup number assigned to it, the Virtual Volume is assigned to group 01 subgroup Long.

Sample JCL can be found in HLQ.CCUUJCL (RECGLVC).