Version 8.1.4

Adabas Caching Installation

This document provides information for installing Adabas Caching.


Supported Environments

Adabas Caching supports the following types of cache space.

Adabas Caching Version 8.1.4

Operating System

Cache Type:
Extended Memory

Cache Type:
Data Spaces

Cache Type:
Hiperspace

Cache Type:
64-bit Virtual

Cache Type:
64-bit Virtual Backed by Large Page Support

z/OS Yes Yes Yes Yes Yes
VSE/ESA Yes Yes No No No
VM/ESA No Yes No No No
BS2000 Yes Yes No No No

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.

Top of page

Prerequisites

Prerequisites for Adabas Caching Version 8.1.4

The following prerequisites apply for Adabas Caching Version 8.1.4 only:

Adabas Online System (AOS)

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 8.1 and above. Natural Version 3.1 or above is a prerequisite for AOS.

Adabas Caching Storage Requirement

Adabas Caching requires storage for the RABN indexes to be acquired above the 16MB line (AMODE=31). When using Virtual 64 or Virtual 64 storage backed by large pages, the RABN indexes will be acquired in Virtual 64 storage. 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:

The cache type and sizes specified for Adabas Caching may have an effect on overall computer performance.

Top of page

Installation Datasets

z/OS

The installation tape for Adabas Caching contains the following dataset for z/OS:

Dataset Description of Contents
ACFvrs.LOAD A load library containing the load modules ADACSH, ADACS1, ADACS6.
AOSvrs.INPL Natural objects used for Adabas Caching Online Services.

VSE/ESA

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.

VM/ESA

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.

BS2000

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.

Top of page

Installation Steps

Step 1: Load ACF Objects into Natural System File

Use the INPL utility to load the objects required by ACF into the Natural system file. The objects are in the dataset AOSvrs.INPL. Refer to the Natural Administration documentation for further information about usage of this utility and its parameters. Please check the reports produced to ensure that no errors have occurred.

Step 2: Add ACF Load Library to STEPLIB

The ACFvrs.LOAD library must be added to the STEPLIB concatenation chain of the database start-up JCL.

Step 3: Start Adabas Caching Online Services

Start of instruction setto verify successful ACF installation, start Adabas Caching Online Services as follows:

  1. Log on to the application SYSAOS.

  2. Select Caching Facility from the main menu.

For more information on the usage of Online Services, see section Adabas Caching Online Services.

Top of page