Interface with BMC Software products for IMS

Requirements

The suspend-and-resume interface with BMC Software products for IMS has the following requirements:

• A license for AR/CTL for IMS is required.
• The other BMC Software product CPU authorization password must be available to the BCSS.
• In the MVS systems you use to execute the BMC Software product, the BCSS must be active and the AR/CTL IMS component of the BCSS must be initialized. In the MVS system you use to execute the BMPs, the BCSS must be active and the AR/CTL IMS component of the BCSS must be initialized. If the BMC Software product and BMPs execute on different MVS systems, both of these BCSSs must share the same REGISET.
• BMPs must use AR/CTL checkpoint or restart services.
• AR/CTL execution load modules must be available to the other BMC Software product job step. For the HPC function, the AR/CTL execution load modules must be available to the Recovery Manager started task or job.
• A BMP cannot use the Ignore Job Name processing option of AR/CTL.

CONCURRENT REORG interface processing

The suspend-and-resume interface with CONCURRENT REORG for IMS works as follows for a database reorganization process (The process for the Snapshot function of the Image Copy utility is similar).

• BMP job steps execute under the control of AR/CTL. Each BMP starts (or restarts) as usual.
• CONCURRENT REORG for IMS initializes and determines which BMPs are accessing the database to be reorganized.
• CONCURRENT REORG for IMS notifies AR/CTL to suspend processing for these BMPs.
• AR/CTL performs suspend processing as described in AR/CTL suspend processing.
• CONCURRENT REORG for IMS issues a /DBR request and waits until the request is successful. If it is not, CONCURRENT REORG for IMS issues a message to the operator.
• When all databases have been stopped, CONCURRENT REORG for IMS enables the capture of updates for the database and issues /STA requests to start the database, BMP programs, and BMP transactions. Then CONCURRENT REORG for IMS notifies AR/CTL to resume processing on the suspended BMPs.
• The BMP resumes processing at the checkpoint that was completed before the BMP was suspended.
• CONCURRENT REORG for IMS begins reorganization and captures all updates that are made to the original database during the reorganization process.
• When the database reorganization is done and CONCURRENT REORG for IMS is ready to swap the reorganized shadow database data sets with the original data sets, it performs the following actions:
  • Determines which BMPs are accessing the database being reorganized
  • Notifies AR/CTL to suspend these BMPs
  • Issues a /DBR request to close and deallocate the database and unauthorize it from DBRC
  • Swaps data set names
  • Issues DBRC commands
  • Stops recording
  • Issues /STA requests to start the database, BMP programs, and BMP transactions
  • Notifies AR/CTL to resume BMP processing
• CONCURRENT REORG for IMS performs its final processing; the entire reorganization process is complete.

HPC interface processing

The following shows how the suspend-and-resume interface for the Hold Point of Consistency (HPC) function works:

1. BMP job steps execute under the control of the AR/CTL application supervisor and AR/CTL. Each BMP starts (or restarts) as usual.
2. The HPC function initializes and determines which BMPs are accessing the databases to be quiesced.
3. The HPC function notifies AR/CTL to suspend processing for these BMPs. AR/CTL performs suspend processing as described in AR/CTL suspend processing.
4. The HPC function waits until the BMPs are suspended or until the 'stop BMPs' timeout value has been exceeded. The HPC function issues a task message for each suspended BMP.
5. The HPC function issues a /DBR or /DBD request and waits until the request is successful. If it is not, the HPC function issues a task message indicating that the database could not be quiesced.
6. When all databases have been stopped or the HPC timeout value has been exceeded, the HPC function issues /STA requests to start the databases, BMP programs, and BMP transactions. Then the HPC function notifies AR/CTL to resume processing on the suspended BMPs.
7. AR/CTL performs resume processing as described in AR/CTL resume processing.
8. The HPC function performs its final processing; the entire HPC process is complete.

Implementing the interface

To implement the suspend-and-resume interface with BMC Software products for IMS, perform the following steps:

1. Install and configure AR/CTL as described in the Installation System and Customizing-after-installation.

2. Install and configure the other BMC Software products for IMS as described for those products.
3. Make the CPU authorization password for the other BMC Software product available to the BCSS. You can include the library that contains the password module in the AESPAUTH DD statement concatenation in the BCSS startup procedure, or you can copy the password module to a library that is already in the AESPAUTH DD concatenation.
4. Set up the other BMC Software product batch job step as described in the documentation for that product. Make the AR/CTL execution load module library available to the job step. For the HPC function, set up the Recovery Manager started task or job as described , and make the AR/CTL execution load module library available to the started task or job. You can add this library to the STEPLIB, JOBLIB, or LNKLST concatenation.
5. In each BMP that you want AR/CTL to control, implement AR/CTL checkpoint or restart services as described in Getting-started-with-AR-CTL-implementation.
6. Execute the job step or function.