The installation of Adabas for zIIP is basically the same as for Adabas Version
8.4 SP2. All ADARUN parameters that are available with Adabas Version 8.4 SP2
are valid except for those mentioned in Current Limitations
in the Adabas for zIIP documentation. The only additional
parameter provided for the support of Adabas for zIIP is the
ZIIP
parameter.
This document is organized as follows:
Prerequisite for Adabas for zIIP is a z13 mainframe with one or more zIIP engines, running z/OS 2.1 or above. Adabas for zIIP needs one zIIP engine to perform effectively.
To run with zIIP support enabled (e.g., ADARUN parameter ZIIP=YES), the Adabas nucleus and utilities must be APF-authorized.
The support of Adabas for zIIP is being provided as a service pack to Adabas Version 8.4. It is separate from, but aside from the zIIP support, offers the same functionality as Adabas Version 8.4. The following libraries are provided for the install:
AZP843.EC00
AZP843.ERRN
AZP843.INPL
AZP843.JOBS
AZP843.LOAD
AZP843.SRCE
AZP843.TZ00
Furthermore, test data is provided in the AZP843.EMPL, AZP843.MISC, AZP843.PERC and AZP843.VEHI datasets.
The AZP843.LOAD library replaces the ADA842.LOAD library for Adabas. It contains all modules from the ADA842 library and includes several zaps, a number of reassembled modules and two new modules for the support of zIIP. This library also has all official ADA842 zaps applied.
For the Adabas Caching Facility, Adabas Delta Save Facility, and the Adabas Online System, the following libraries are provided:
ACF843.LOAD (Caching Facility)
ADE843.LOAD (Delta Save Facility)
AOS843.LOAD (Online System)
No new libraries are provided for the other selectable units of Adabas 8.4.
For the Adabas for zIIP license check (see License below), use the Mainframe License Check Version 1.3.3 from the following library:
MLC133.LOAD
For UES-enabled databases, if you use the alternative code page conversion system ICS, which is the new default (see Alternative Code Page Conversion System ICS in the Release Notes), use ICS Version 2.2.1 from the following library:
ICS221.Lxxx (use the latest fix library available from Empower)
Otherwise, if you elect to continue using the previous code page conversion system ECS, apply special zap AY843164 to the AZP843.LOAD library. This zap can be found in member ZAPOPT of the AZP843.SRCE library.
An Adabas nucleus or utility that is to run with the Adabas for zIIP add-on
product requires an associated license file (AZPAD) in addition to the Adabas
license file. If the AZPAD license is not provided or erroneous, the nucleus or
utility will run with Adabas for zIIP deactivated (ZIIP=NO).
The AZPAD license can be transferred to the mainframe in the same way as the Adabas license. The license can be made available to the nucleus or utility as a load module with the name AZPADLIC. This is similar to the handling of the Adabas license load module ADALIC described in Step 5: Customize and Start the Adabas Nucleus and Test Adabas Communications.
Alternatively, the license file can be referred to by a ‘DDLAZPAD’ DD statement in the nucleus or utility job/started task. This is a fallback in case the AZPADLIC module cannot be loaded.
Use the following libraries and maintenance for running selectable units with Adabas for zIIP:
Adabas Caching Facility
Use the ACF843.LOAD library provided with Adabas for zIIP Version 8.4
SP3.
Adabas Delta Save Facility
Use the ADE843.LOAD library provided with Adabas for zIIP Version 8.4
SP3.
Adabas Online System
Use the AOS843.LOAD library provided with Adabas for zIIP Version 8.4
SP3.
All others
Use the same load libraries as with ADA842.
For all libraries, apply the latest available maintenance.
If Adabas Vista, Adabas Fastpath, Adabas Transaction Manager, or Adabas SAF Security is being used, please refer to Using COR-based Add-ons in the Release Notes for installation instructions.
Perform the following steps to install Adabas for zIIP
Set up one or more load libraries for your Adabas nuclei and utilities that are to be run with Adabas for zIIP (see also Selectable Units and Using the Adabas System Coordinator-based Add-ons above).
Set up the required license modules or datasets (see License above).
Install the Adabas SVC from the AZP843.LOAD library.
Specify ADARUN parameter ZIIP=YES.
Start the Adabas nucleus.
The following Adabas utilities support offloading of work to a zIIP:
ADACHK
ADACMP
ADAINV
ADALOD
ADAORD
ADAREP
ADARES
ADASAV
ADAULD
To run any of these utilities with zIIP support, specify ADARUN parameter ZIIP=YES. All other utilities require ZIIP=NO (or not specified).