Version 8.1.2

Installation Prerequisites


Operating Systems

Adabas Transaction Manager Version 8.1.2 is compatible with the following operating systems:

Top of page

Software Prerequisites

Adabas

Adabas Transaction Manager Version 8.1.2 can be used with databases running under any supported level of Adabas Version 7.4 or above.

Note:
If you are using Adabas Version 8.1.1, ensure that the following Adabas fixes are applied: AO811002, AN811021, AN811023, AN811024.

Adabas Load Library Considerations

Using Adabas Version 8.1

Using Adabas Transaction Manager Version 8.1 with Adabas Version 8.1 could not be more simple. Use the ADA81x load library along with the ATM81x and COR81x libraries.

Using Adabas Version 7.4 in z/OS Systems

Using Adabas Transaction Manager Version 8.1 with Adabas Version 7.4 in z/OS systems requires an additional library (currently, Adabas 7.4 LX08) in some cases, to enable various DTP capabilities within the product. The table below clarifies the use of libraries for the various components:

  DTP=TM (Transaction Manager) DTP=RM (Resource Manager) DTP=NO (Non-RM Database)
Classic Adabas

ATM81x
LX
ADA74x

ATM81x
ADA74x

ATM81x
ADA74x

Adabas Cluster Services Not permitted

ATM81x
LX
ADA74x

ATM81x
ADA74x

Adabas Parallel Services Not permitted

ATM81x
LX
ADA74x

ATM81x
ADA74x

In the above table, “LX” indicates that you should concatenate the LX08 library ahead of the ADA74x library in the STEPLIB of the job’s JCL.

When a component is converted from Adabas 7.4 to Adabas 8.1 you must stop using the LX library for it.

Before you use the LX library for the first time with a Cluster Services or Parallel Services database, you should run the ADACNV utility which is supplied in the LX library, specifying the following as DDKARTE input:

ADACNV    CONVERT  TOVERS=75

If you subsequently revert to using the standard Adabas 7.4 library, either because the cluster is now to be run with DTP=NO, or because the database is no longer to execute as part of a cluster, you should convert the database back to standard version 7.4 format by running ADACNV, as supplied in the LX library, with the following DDKARTE input:

ADACNV    CONVERT  TOVERS=74    

Caution:
Failure to follow the above instructions can result in various problems relating to the PPT area of the Associator dataset.

Using Adabas Version 7.4 in z/VSE and BS2000 Systems

The Transaction Manager (DTP=TM) may not be run under Adabas Version 7.4; it must be run under Adabas Version 8.1.

DTP=RM databases may run under Adabas Version 7.4.

Adabas Parallel Services databases running under Version 7.4 must run with DTP=NO. If you want an Adabas Parallel Services database to run with DTP=RM, it must run under Version 8.1.

Adabas Required Data Sets

This section provides an overview of the required Adabas data sets when using Adabas Transaction Manager.

ATM Transaction Manager JCL Requirements

The following table shows the dataset definitions that are essential for correct execution of the ATM transaction manager. Other datasets, such as command log, may be specified. For details of these, refer to the Adabas documentation.

Dataset Link Name More Information
Load library  

ADA74x library or ADA81x library; COR81x library, ATM81x library

Note:
Check the Release Notes for details of any special dependencies.

Associator DDASSORn  
Data Storage DDDATARn  
Work DDWORKR1  
ATM log ATMLOG1/2 Optional, depending on TMLOG parameter value.
ADARUN parameters SYSDTA/ DDCARD DTP=TM, and other operational parameters.
ADARUN messages SYSOUT/ DDPRINT  

Database JCL Requirements

The following table shows the dataset definitions that are essential for correct execution of a single database or cluster that is to execute as a resource manager, under the transactional control of ATM. Other datasets, such as command log, may be specified. For details of these, refer to the Adabas documentation.

Dataset Link Name More Information
Load library  

ADA74x library or ADA81x library; COR81x library, ATM81x library

Note:
Check the Release Notes for details of any special dependencies.

Associator DDASSORn  
Data Storage DDDATARn  
Work DDWORKR1  
Work part 4 DDWORKR4

Recoverable information about global transactions.

Note:
Check the Release Notes for details of any special dependencies.

ADARUN parameters SYSDTA/ DDCARD DTP=RM, and other operational parameters
ADARUN messages SYSOUT/ DDPRINT  

Adabas System Coordinator

Adabas Transaction Manager Version 8.1.2 requires that you first install the Adabas System Coordinator Version 8.1. Refer to the Adabas System Coordinator documentation for more information.

Entire Net-Work

A supported version of Entire Net-Work is required for communication between Adabas Transaction Manager instances in different system images. Refer to the Entire Net-Work documentation for more information.

Natural

Natural is required by the Online Services application SYSATM.

Any supported level of Natural Version 4.1 or above can be used. Refer to the Natural documentation for more information.

Using Com-plete, RRMS and CICS Syncpoint Manager

The Adabas Transaction Manager client proxy currently supports only one Adabas SVC per client session under Com-plete.

For cross-vendor coordination of distributed transactions, Adabas Transaction Manager supports the following IBM asynchronous exit drivers: RRMS and CICS Syncpoint Manager.

Top of page