CL Command Reference - RCLDBXREF

CL Command List > RCLDBXREF Reference

Description:

The Reclaim Database Cross-Reference (RCLDBXREF) command recovers the database cross-reference catalog data for a specific library. This command provides a subset of the function provided by the Reclaim Storage (RCLSTG) command to reclaim the database cross-reference catalog data for the system by specifying SELECT(*DBXREF). The difference is that this command does not require the system to be in restricted state, and it supports a reclaim of a specific library, rather than all libraries on the system.

Additionally this command provides an interface for the user to determine which catalogs have inconsistencies, and which libraries are affected.

If an auxiliary storage pool (ASP) group has been set for the current thread, this command will take affect for the independent ASPs in that ASP group and also for the system and basic user ASPs (ASP numbers 1-32).

This command should only be used when problems with the database cross-reference catalogs occur, and RCLSTG SELECT(*DBXREF) is not an option due to critical business requirements.

Because this command does not need to run in restricted state, it may not always be able to recover cross-reference information. In such cases, running RCLSTG SELECT(*DBXREF) will be required.

When the command is used to recover cross-reference information, the user must not allow applications to use or modify objects in a library that is being reclaimed. Failure to do this could cause unpredictable results.

If RCLDBXREF does not correct the problem, the library being reclaimed may have more inconsistencies than existed before using this command. If this happens, running RCLSTG SELECT(*DBXREF) will be required.

Restrictions:
. You must have all object (*ALLOBJ) special authority to use this command.


Examples:

Example 1: Check for Cross-Reference Problems

RCLDBXREF OPTION(*CHECK)

This command checks the cross-reference catalogs for errors.



Example 2: Recover the Cross-Reference Catalogs

RCLDBXREF OPTION(*FIX) LIB(*ERR)

This command recovers the cross-reference information for all libraries known to be in error.



Example 3: Recover the Cross-Reference Catalog Data for One Library

RCLDBXREF OPTION(*FIX) LIB(ABCD)

This command recovers the cross-reference information for library ABCD.