This document lists the Adabas for zIIP 8.4 SP3 enhancements.
| Category | Enhancements |
|---|---|
| Adabas for zIIP 8.4 SP3 Enhancements | Adabas 8.4 ADARUN Parameter Enhancements |
| Adabas 8.4 Operator Command Enhancements | |
| zIIP-Related Session Statistics | |
| Alternative Code Page Conversion System ICS | |
| zIIP-Related Enhancements Since Adabas for zIIP 8.3 SP5 | |
| Documentation Enhancements |
This section describes the ADARUN Parameter enhancements made with Adabas for zIIP Version 8.4 SP3.
For more information about any ADARUN parameter, read Adabas Initialization (ADARUN Statement).
This release introduces a new ADARUN parameter called ZIIP. This parameter controls whether or not Adabas activates the selectable unit Adabas for zIIP (AZPAD). Valid values are YES or NO; NO is the default. Set ZIIP=YES to let Adabas offload part of its workload to zIIPs.
The ZIIP parameter is valid for z/OS operating environments only. It can be specified for the Adabas nucleus (PROGRAM=ADANUC) and for the following Adabas utilities (PROGRAM parameter):
ADACHK
ADACMP
ADAINV
ADALOD
ADAORD
ADAREP
ADARES
ADASAV
ADAULD
For complete information about the ZIIP parameter, read ZIIP Parameter: Activate Usage of Adabas for zIIP.
This section describes the operator command enhancements made in Adabas for zIIP Version 8.4 SP3 (operator commands for the Adabas nucleus).
With Adabas for zIIP version 8.4 SP3, the DPARM operator command displays the current value of the ZIIP parameter, as do the ADADBS OPERCOM DPARM function and AOS menu Display Parameters.
Adabas for zIIP Version 8.4 SP3 introduces the DZSTAT operator command. This command can be given to an Adabas nucleus that has been started with ZIIP=YES. Use the DZSTAT command to display statistics about the execution of Adabas in SRB mode and TCB mode and about the CPU time consumed on System z Integrated Information Processors (zIIP) and general processors (GP).
In response to operator command DZSTAT, Adabas displays basic zIIP-related statistics. If, additionally, the parameter ALL is specified (DZSTAT,ALL), Adabas displays basic and extended zIIP-related statistics.
For more information, refer to DZSTAT Command.
The DZSTAT command is also available via the ADADBS OPERCOM DZSTAT function and via AOS menu Display session utilization / zIIP Statistics.
Adabas for zIIP Version 8.4 SP3 introduces the ZIIP operator command. Use this command to turn on or off the use of System z Integrated Information Processors (zIIP) in the Adabas nucleus.
Issuing ZIIP=YES will tell the Adabas nucleus to run in SRB mode whenever possible, enabling the use of zIIPs. Issuing ZIIP=NO will tell the Adabas nucleus to always run in TCB mode, using only general processors.
The ZIIP operator command may only be used in an Adabas nucleus that was started with ADARUN parameter ZIIP=YES.
For more information, refer to ZIIP Command.
The ZIIP command is also available via the ADADBS OPERCOM ZIIP function and via AOS menu Modify Parameters.
Adabas for zIIP prints extensive statistics about its execution in SRB mode and TCB mode and about the CPU time consumed on System z Integrated Information Processors (zIIP) and general processors (GP), both at session termination and before refreshing the statistics in the course of an ADADBS REFRESHSTATS function (subject to the REFSTPRT parameter).
Also, selected zIIP-related statistics are stored in the SYNS-60 Nucleus statistic checkpoints that Adabas creates at regular intervals (see ADARUN parameter INTNAS) and in the SYNS-5B session end / session interval statistics checkpoints. They are displayed by the ADAREP CPEXLIST function.
For details on the zIIP-related statistics, see the section Monitoring zIIP Usage in the Adabas for zIIP documentation.
The Universal Encoding Support (UES) in Adabas for zIIP 8.4 SP3 has been changed to use ICS by default. ICS is a new, alternative code page conversion subsystem. Its use with Adabas was introduced as an option in Adabas 8.4 SP2. ICS is based on International Components for Unicode (ICU V58.2), an open source project initiated by IBM (http://site.icu-project.org). ICU is already being used with other Software AG products like Natural for Mainframes and Adabas on Linux, UNIX and Windows.
The code page modules of ICS are provided in the separate ICS221.Lxxx load library. If ICS is to be used, this library must be concatenated to the AZP843.LOAD library in the Adabas nucleus/utility job or job step.
For the time being, it remains possible to use UES with Software AG’s Entire Conversion Services (ECS) code page conversion subsystem. Special zap AY843164 must be applied to use ECS instead of ICS. This zap can be found in member ZAPOPT of the AZP843.SRCE library.
ICS does not require the SMARTS runtime system (APS). It supports the same code pages as ECS. When used with Adabas for zIIP, ICS is more efficient than ECS in converting text between code pages.
Adabas for zIIP 8.4 SP3 provides the following zIIP-related changes and enhancements since the initial release of Adabas for zIIP with version 8.3 SP5:
Message texts and this documentation now use the term "general processor" or "GP" to refer to the standard, general purpose processors that execute the traditional mainframe workloads without constraints. Previously, the term "general central processor" or "GCP" was used.
Additional zIIP-related statistics now report on the CPU time consumed on zIIPs and GPs by all programs executing in the Adabas nucleus address space. Previously, only the zIIP-related statistics for code executing as part of the enclave created by Adabas were reported. The new statistics include CPU time consumed by code executing as part of other enclaves (created, for instance, by Stored Procedures and Triggers running with Natural zIIP, Adabas Review or the Event Replicator for Adabas) as well as CPU time consumed by code running outside any enclave. The new zIIP-related statistics for the entire Adabas nucleus address space offer a fuller picture as to how much of the Adabas processing is actually offloaded to zIIPs. See the section Understanding the zIIP-Related Statistics in the Adabas for zIIP documentation for further details.
The layout of the basic and extended zIIP-related statistics has been slightly changed and reorganized.
Selected, often used Adabas utilities - ADACHK, ADACMP, ADAINV, ADALOD, ADAORD, ADAREP, ADARES, ADASAV, and ADAULD - have been enhanced to support offloading part of their processing to zIIPs.
Additional products in the Adabas realm support offloading part of their workload to zIIPs:
Adabas Review Version 5.1 SP1
Entire Net-Work Version 6.4 SP1
Event Replicator for Adabas Version 3.7 SP1
Their zIIP support is described in the respective documentation sets
Information on the basic concepts around zIIP processing can be found in the new Adabas for zIIP documentation.