Previous Topic: MASSRECALLNext Topic: RECOVER=BACKSTORE


RECLAIM

This command is used when running the SVTSUTIL program to correct improperly chained or lost static cache LDSs in the Global VCAT, to recover Ineligible LDSs, and to rebuild the static cache totals.

RECLAIM rebuilds the LDS tables and puts all LDSs without proper Virtual Volume ownership in the free cell pool. RECLAIM tries to open and check LDSs marked ineligible. If the check is successful, the LDSs are also added to the free cell pool.

During some recovery operations or when a proper Virtual Volume dismount cannot be accomplished, LDSs can be left in the allocated queue without true Virtual Volume ownership. These LDSs are unused DASD buffer space that cannot be used because they were not returned to the free cell pool.

You should schedule RECLAIM to run periodically, once a day or once a week, to return orphaned LDSs to the free cell pool to maximize available DASD buffer space. CA Vtape does not need to be shutdown to execute RECLAIM.

The optional NOCHECK_INELIGIBLE parameter is used to stop RECLAIM from resetting the ineligible flag of cache LDSs'. An ineligible LDS is one that CA Vtape attempted to reuse, but could not find its catalog entry or found its catalog entry and the subsequent open failed. This typically occurs because a DASD cache volume is off-line or cache LDSs were deleted from DASD, but not from the Global VCAT. Coding NOCHECK_INELIGIBLE will stop RECLAIM from performing the catalog locate and open of each ineligible LDS, which will allow the job to run faster, and eliminate the error messages issued by CA Vtape when the now eligible LDS is reused and marked ineligible again.

Syntax
RECLAIM [,NOCHECK_INELIGIBLE]

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