This document provides information for installing Adabas Caching.
Adabas Caching is supported by the Adabas release tape options described in the following table. For each option, information is provided about the types of cache space supported.
| Operating System |
Cache Type: |
Cache Type: |
Cache Type: |
Cache Type: |
|---|---|---|---|---|
| OS/390 | Yes | Yes | Yes | No |
| z/OS 1 | Yes | Yes | Yes | Yes |
| VSE/ESA | Yes | Yes | No 2 | No |
| VM/ESA | No | Yes | No 2 | No |
| BS2000 3 | Yes | Yes 4 | No 2 | No |
Notes:
For information about setting up data spaces (or hiperspace if supported in your environment), refer to the documentation for the operating system. Specifically for 64-bit address space, refer to the IBM documentation SA22-7614-00, MVS Programming: Extended Addressability Guide, second edition October 2001, which applies to z/OS 1.2 and above.
Adabas Online System (AOS), either the demo version delivered with Adabas or full version available as a selectable unit, is a prerequisite for using Adabas Caching Online Services (Natural application SYSACF). SYSACF is the online, menu-driven application used to monitor the Adabas Caching environment. It is included as part of Adabas version 7.4. Natural version 3.1 or above is a prerequisite for AOS.
Adabas Caching requires storage for the RABN indexes to be acquired above
the 16MB line (AMODE=31). This may require an adjustment
to the REGION size (machine size for VM/ESA users).
Determine the maximum available storage from your systems programming staff:
for extended memory usage (BS2000 and all ESA environments)
for data space (BS2000 - except RISC machines - and all ESA environments)
for hiperspace (OS/390 or z/OS environments only)
for virtual 64 storage (z/OS environments only)
The cache type and sizes specified for Adabas Caching may have an effect on overall computer performance.
The installation tape for Adabas Caching contains the following dataset for OS/390 or z/OS:
| Dataset | Description of Contents |
|---|---|
| ACFvrs.LOAD | A load library containing the load modules ADACSH, ADACS1, ADACS6. |
The installation tape for Adabas Caching contains the following dataset for VSE/ESA:
| Dataset | Description of Contents |
|---|---|
| ACFvrs.LIBR | A load library that includes the phases ADACSH and ADACS1. |
The Adabas Caching download for VM/ESA users contains one member: ACFVvvv TXTLIB. This txtlib needs to be added to the file SETTXTLB EXEC used to set the GLOBAL TXTLIB statement for nucleus startup. In addition, Caching ADARUN parameter cards need to be added to the control file used for nucleus startup.
The installation tape for Adabas Caching contains the following dataset for BS2000:
| Dataset | Description of Contents |
|---|---|
| ACFvrs.MOD | A load library containing the modules ADACSH and ADACS1. |
The ACFvrs.LOAD library must be added to the STEPLIB concatenation chain of the database start-up JCL.
The Adabas Caching load library must appear as the first STEPLIB DD statement if there are any concatenated load libraries.
The ADARUN parameter CACHE=YES must be included
in the Adabas nucleus start-up job to activate Adabas Caching. Other Adabas
Caching parameter settings are described in the section
Adabas Caching
Parameters.
After Adabas version 7.4 has been installed, start Adabas Caching
Online Services as follows:
Log on to the application SYSAOS.
Select Caching Facility from the main menu.
For more information on the usage of Online Services, see section Adabas Caching Online Services.
