Overview of batch IMS Database Repair Facility for OSAM

An important feature of the batch version of IMS Database Repair Facility is that you can use it to modify IMS data sets.

The OSAM batch version of IMS Database Repair Facility operates in a similar manner as the VSAM batch program.

You can specify the data to change by supplying the following information to IMS Database Repair Facility:

  • Relative byte address (RBA)
  • Block number

The SYSIN data set contains the control statements, and messages and output are sent to the SYSTSPRT data set.

Functions

The batch version of IMS Database Repair Facility supports the following three functions:

Verify function
Compares data before changing the data.

The Verify function compares the data at a specific location in an OSAM data set to data that you supply.

Recommendation: To eliminate the possibility of changing good data, consider performing a Verify operation before a Replace operation.
Replace function
Changes data.

The Replace function changes the data at a specific location in an OSAM data set with data that you supply.

Recommendation: To eliminate the possibility of changing good data, always perform a Verify operation before a Replace operation. If data does not match during a Verify operation, the Replace is canceled. However, you can do a Replace without a preceding Verify.
Dump function
Prints the record.

The Dump function prints a dump of the OSAM data set block to the SYSTSPRT output report.

A Dump is executed for the block that is specified immediately before the Dump command. When a Dump is performed after a Replace, the Dump reflects the changes that are made by the Replace.

Any error causes the job to end.

Typical uses

The batch version of IMS Database Repair Facility is used as follows:

  • To perform Verify, Replace, and Dump operations in all types of OSAM data sets
  • To perform multiple Verify operations
  • To perform multiple Replace operations
  • To retrieve any number of blocks with one run

Program structure

The batch version of IMS Database Repair Facility operates as a batch program in the MVS™ region. The utility is independent of IMS releases.