Customizing the procedures and JCL members

Depending on which IMS Database Recovery Facility tasks you are doing, you must customize the applicable procedures and JCLs.

Review the IMS Recovery Solution Pack sample library, which is named your.hlq.SFRXSAMP. This sample library contains all of the relevant procedures and JCL that is required to set up and run IMS Database Recovery Facility with utilities on your system, including DEDB Pointer Checker, IMS HP Pointer Checker, IMS Index Builder, and IMS High Performance Image Copy.

To customize the members, follow the instructions that are provided in each sample member.

The following lists the sample members that are used in this scenarios document.
FRXDRFZZ
This configuration file is required for IMS Database Recovery Facility.

Make a copy of your.hlq.SFRXSAMP(FRXDRFZZ) and customize it for your environment.

FRXBPECF
This configuration file is required for BPE.

Make a copy of your.hlq.SFRXSAMP(FRXBPECF) and customize it for your environment.

FRXFOI
This configuration file is required for TOSI.

Make a copy of your.hlq.SFRXSAMP(FRXFOI) and customize it for your environment.

FRXITKB
This configuration file is required for copying compatible IMS Database Recovery Facility and utility reports to ITKB.

Make a copy of your.hlq.SFRXSAMP(FRXITKB) and customize it for your environment.

DRFMAS procedure
This generic procedure is used to allocate the IMS Database Recovery Facility MAS.

Make a copy of your.hlq.SFRXSAMP(FRXMAS).

All of the variables in this procedure are controlled by the SET statements in the execution JCL that are called by your.hlq.SFRXSAMP(FRXDRF).

If you are using a consolidated IMS Tools load library, copy your.hlq.SFRXSAMP(FRXMASC) and customize the SET statements in your.hlq.SFRXSAMP(FRXDRFC).
DRFIAX procedure
This IMS Database Recovery Facility UAS/IAX procedure is used to allocate the IB, IC, and DFSPREC0 address spaces.

Make a copy of your.hlq.SFRXSAMP(FRXIAX) and customize it by adding the name of your IMS Database Recovery Facility load library or consolidated IMS Tools load library.

Tip: If you have multiple levels of maintenance for the IMS Tools, customize the FRXIAX procedure and rename to FRXIAXxx, where xx is the maintenance level used for each load library. For example, you can create FRXIAXT1 for IMS SSID IMT1 of your test environment and FRXIAXP1 for your IMS SSID IMP1 of your production environment.
DRFPROC procedure
This procedure is used to allocate the IMS Database Recovery Facility subordinate address spaces.

Make a copy of your.hlq.SFRXSAMP(FRXRSS) and customize it by adding the name of your IMS Database Recovery Facility load library or consolidated IMS Tools load library.

Tip: If you have multiple levels of maintenance for the IMS Tools, customize the FRXRSS procedure and rename to FRXRSSxx, where xx is the maintenance level used for each load library. For example, you can create FRXRSST1 for IMS SSID IMT1 of your test environment and FRXRSSP1 for your IMS SSID IMP1 of your production environment.
FRXPATH0 and FRXPATHZ procedures
These procedures are required to run IMS High Performance Pointer Checker for a full function database or DEDB Pointer Checker for a fast path database.

Make a copy of your.hlq.SFRXSAMP(FRXPATH0) and your.hlq.SFRXSAMP(FRXPATHZ) in a system PROCLIB that is concatenated in the JES system PROCLIB, and customize them for your environment.

IMS Database Recovery Facility batch job
This sample batch job runs IMS Database Recovery Facility.

Make a copy of your.hlq.SFRXSAMP(FRXDRF) and customize it for your environment.