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 | APF-authorize the ATM transaction manager job. |
| 4 | Link the RRMS interface modules to the Adabas Transaction Manager kernel (job ATMI070). |
| 5 | Define client runtime controls for the jobs, Com-plete systems, and IMS systems whose transactions will be controlled by RRS. |
| 6 | Verify the system logger and RRS operation. |
| 7 | 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.
RRMS requires that resource managers execute as APF-authorized
programs. The ATM transaction manager must run authorized if its RRMS interface
is to be used. However, databases that run with DTP=RM
do not need to be authorized.
Ensure that every library in the STEPLIB concatenation of the ATM transaction manager's JCL procedure is APF-authorized.
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 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
TransactionControl
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:
Specify TMSYNCMGR=RRMS in the ATM transaction
manager ADARUN parameters.
Ensure that the Adabas System Coordinator daemon is running.
Start the ATM transaction manager.
