Using the ACB repository

You can refer to the sample library (SAMPLIB) members BSY#ACBI and BSY#ACBU for more information on the utilities discussed in this topic.

Procedure

  1. Using the BSYACBRI utility, define the repository with IDCAMS.

    The SHAREOPTIONS (3 3), RECORDSIZE (4096 4096), and KEYS (26 0) settings in DEFINE CLUSTER control statement may not be changed.

  2. Using the BSYACBRU utility, load the ACB repository from the active ACBLIB.

    The active ACBLIB is specified by the SSID parameter in the JCL. This causes the active ACBLIB to be dynamically discovered. In order to load the repository from a specific ACBLIB, dynamic discovery may be overridden using the ACBLIB parameter and ACBLIB DD statement.

  3. In the BSYV220 CLIST, define the variable RBRACBRE to point to the ACB repository loaded by the BSYACBRU utility.

    To stop using the ACB repository, define the variable as BSYACBRE().

  4. Run an IMS Recovery Expert function.

Results

The TSO User ID or batch JOB log will report the following message if the ACB repository is successfully used for the IMS Recovery Expert function:

BSYI999I ACB Repository is being used for IMSID P5AI BSY#RACB

If the performance of the IMS Recovery Expert function is not improved as it should be, it may be the case that the function has continued without the use of the ACB repository. This may occur due to a failed ENQ (see the following topic). Check the JOB log for an indication of whether this has occurred, as seen in the following messages:

BSYI999I ACB Repository shared ENQ failed for IMSID IDA2 BSY#AREP 
BSYI999I ACB Repository is not being used for function BSY#RACB

If it is found that an ACB member from ACBLIB is missing from the ACB repository, the following messages are issued in the JOB log the first time the missing member is encountered. The IMS Recovery Expert function will read relevant members from the ACBLIB instead of the ACB repository, however for performance improvement it is recommended that the BSYACBRU utility be run to add the member to the ACB repository.

BSYI999I ACB Repository is being used for IMSID P5AI BSY#RACB         
BSYI999I IMS ACB Repository member DBDAEG1 missing BSY#RACB          
BSYI999I ACB Repository Utility would need to be run BSY#RACB

If it is found that an ACB member in the ACB repository has a different date+time value from its ACBLIB counterpart, the following messages are issued in the JOB log the first time the discrepancy is encountered. The IMS Recovery Expert function will read relevant members from the ACBLIB instead of the ACB repository, however for performance improvement it is recommended that the BSYACBRU utility be run to update the member in the ACB repository.

BSYI999I ACB Repository is being used for IMSID IEA BSY#RACB        
BSYI999I ACB Repository does not match ACBLIB Directory BSY#RACB     
BSYI999I ACB Repository Utility would need to be run BSY#RACB