Make sure your system meets the requirements described in the previous section System Requirements with respect to z/OS prerequisites, hardware prerequisites, and compatible Adabas versions.
To install Adabas Encryption, complete the steps below:
Install the Adabas Encryption load modules by concatenating the delivered AEZ load library first in the sequence of libraries used for running the Adabas nucleus and utilities. Alternatively, if a combined load library is to be used, ensure that the combined library contains all modules from the delivered AEZ load library. The Adabas Encryption load modules can be found in AEZvrs.LOAD.
Apply any necessary zaps, as described in the $README member in the AEZvrs.MVSZAPS library and in any subsequent AEZvrs.MVSZnnn datasets (if they have been provided).
Note:
The AEZvrs.LOAD library contains
replacement ADAIOR and ADAIOS modules with encryption support. Zap IDs for
these replacement modules have the prefix AE (for example, AE851001, AE851002
and others). These AE prefixed zaps are not applicable to the ADAIOR/ADAIOS
modules from the standard ADA/AZP load libraries. Likewise, standard ADA/AZP
zaps (with prefix AI or AO) are not applicable to the ADAIOR/ADAIOS from the
AEZ load library.
You must install a valid license file on all mainframe platforms in which your Software AG mainframe product is installed. The license file is provided as an XML document (encoding is US-ASCII) and must remain in that format, even on the mainframe. It must not be modified. Any modification of the license file will invalidate the digital signature and the license check will fail. In the event of a check failure, please contact your Software AG technical support representative.
For a full product list of license file names, load modules and DD/Link names, refer to the Adabas installation documentation.
Note:
Thirty days before the license expires, license check failure
messages are produced. Your software product will still function, but these
messages warn you that it is time to obtain a new license.
In the following steps, you will prepare the license file and then install it:
The product license file is supplied on the individual customer installation tape or separately via an e-mail attachment. Before you can install the license, you must transfer it from e-mail or the installation tape and store it on a z/OS system. This section describes how to do this for a license distributed either by e-mail or on the installation tape.
To prepare the license file from an e-mail attachment, complete
the following steps:
Transfer the license to z/OS, as described in the Adabas documentation Software AG Mainframe Product Licensing > Transferring a License File from PC to a z/OS Host Using FTP.
Verify that the transferred license file is stored in an Adabas source library (with RECFM=F or FB and LRECL=80), taking care to preserve its format as ASCII.
To prepare the license file from the installation tape,
complete the following step:
Verify that the license file is stored from the tape into an Adabas source library (with RECFM=F or FB and LRECL=80), taking care to preserve its format as ASCII.
Once the license file has been prepared, you can install it in one of two ways:
You can convert the license to a load module (AEZLIC) that is then loaded by the Adabas nucleus/utility job.
You can reference the license file in the Adabas nucleus/utility job by DD statement.
This section describes both methods.
To convert the license file to a load module, complete the
following steps:
Review and modify sample job ASMLICAM in the AEZvrs.JOBS library, as follows:
Set the variable MLCLOAD to point to the license load library (MLCvrs.LOAD).
Set the variable USRLOAD to point to an appropriate user load library.
Note:
This user load library must also be included in the
STEPLIB concatenation for Adabas nuclei and utilities.
Set the LICFILE parameter to point to the dataset containing the Adabas Encryption license file you transferred to z/OS earlier.
Set the LMOD parameter to the load module name AEZLIC.
Submit sample job ASMLICAM. This job runs the MAKE function of the LICUTIL utility to convert the license text file to an assembler source module. ASMLICAM then links and assembles the assembler source to generate a load module called AEZLIC, which is stored in the specified user load library (USRLOAD). For more information about the LICUTIL utility, refer to the Adabas documentation's Software AG Mainframe Product Licensing > Using the License Utility: LICUTIL.
Update your Adabas nuclei and utility jobs to reference the user load library so AEZLIC will be loaded by the Adabas nuclei and utilities.
To reference the license file in Adabas nuclei and utility
jobs, complete the following steps:
Make sure any previously created AEZLIC load module is inaccessible to your nuclei and utility jobs. The nucleus or utility first tries to load AEZLIC and, if unsuccessful, it reads from a dataset defined to the DD statement DDLAEZ.
Update your Adabas nuclei and utility jobs to reference the license.
In the Adabas Online System, the Display Installed Products screen shows whether the selected Adabas nucleus supports encryption (ADARUN parameter ENCRYPTION=YES).
To display the Installed Products screen:
Select option A (Session Monitoring) from the main menu
Select option I (Display Installed Products) from the Session Monitoring menu
This is supported at the following Adabas Online Services fix levels:
| AOS Version | Fix level |
|---|---|
| Version 8.5 SP3 | AOS853I001 |
| Version 8.5 SP2 | AOS852I001 |
| Version 8.5 SP1 | AOS851I002 |
| Version 8.4 SP3 | AOS843I004 |
| Version 8.4 SP2 | AOS842I005 |