If you intend to use Adabas Transaction Manager in conjunction with the Recoverable Resource Management Services (RRMS), use the following installation procedure.
The steps needed for a successful installation are as follows:
| Step | Description |
|---|---|
| 1 | Perform standard installation procedure for Adabas Transaction Manager, and verify the installation. |
| 2 | Copy the Adabas Transaction Manager RRMS exits into an LPA library. |
| 3 | Link the RRMS interface modules to the Adabas Transaction Manager kernel (job ATMI070). |
| 4 | Define client runtime controls for the jobs, Com-plete systems, and IMS systems whose transactions will be controlled by RRS. |
| 5 | Verify the system logger and RRS operation. |
| 6 | Activate the Adabas Transaction Manager RRMS interface. |
The following is the general procedure for installing the Adabas Transaction Manager RRMS interface. All steps are required for a successful installation.
The actual installation depends on your particular requirements and the specific contents of the release package provided by Software AG for your site. Information in the release package is intended for your system. If that information differs from the information in this section, use the release package information or contact Software AG technical support for assistance.
It is strongly recommended that you first install and verify the execution of the ATM transaction manager and client proxy without activating the RRMS interface.
The Adabas Transaction Manager RRMS exits are contained in the single module ATMRRSEX, which is supplied in the Adabas Transaction Manager load library.
This module must be made available in the LPA of your z/OS system. You can use various third-party tools to place ATMRRSEX in the LPA temporarily. For permanent installation, you should copy the module into a library that appears in the system LPALST concatenation, then IPL the system specifying the CLPA option.
If ATMRRSEX is not available in the LPA when Adabas Transaction Manager attempts to initialize its RRMS interface, system ABEND 052 occurs.
In order for an application’s transactions to be coordinated by RRMS, some additional interface modules from IBM must be linked into the Adabas Transaction Manager kernel.
Job ATMI070 can be adapted for this purpose. Unresolved external references can be ignored, provided that the named RRMS modules are included successfully.
Use Adabas Transaction Manager Online Services to define the required client runtime controls.
The required client runtime controls are described in section Parameters. Some special considerations are necessary when running with the RRMS interface active. Define a set of client runtime controls for those batch jobs, Com-plete systems, and IMS TM systems that require the transactional control of RRS, and pay particular attention to the Transaction control by other vendors client control.
Ensure that the system logger is active in your z/OS system and that RRS has been started. Refer to the IBM z/OS documentation for details.
To activate the RRMS Interface:
Ensure the TM control Open distributed transaction (system) is set to YES.
Ensure that the Adabas System Coordinator daemon is running with
PRODUCT=ATM.
