Adabas Service for Java 1.2.1 | Getting Started with Adabas Service for Java | Install Adabas Service for Java
 
Install Adabas Service for Java
To install Adabas Service for Java:
1. Create a directory in the UNIX System Services file system to use as your installation directory. For the purposes of these installation instructions, the chosen installation directory is /opt/softwareag.
$ mkdir -p /opt/softwareag
2. Use an FTP connection in binary mode to transfer the supplied AJZ-version.tar.Z package to the /opt/softwareag installation directory.
3. Extract the contents of the Adabas Service for Java package in the UNIX System Services installation directory using the following commands:
$ cd /opt/softwareag
$ uncompress < AJZ-version.tar.Z | tar -oxf -
The following components are extracted to /opt/softwareag/AdabasClient:
Subdirectory
Component
Description
jar
ajz-<version>.jar
AJZ Java API
lib
libadajni.so
AJZ JNI (Java Native Interface)
libadalnkx.so
Adabas Client Library (ADALNKX)
libsagovo5.so
Internal component (OVO)
libsagsmp2.so
Internal component (SMP)
zos/jobs
AJZI010
Sample job to link the supplied ADAAJZ6 module with ADALNKR (for multi-threaded environments only)
AJZI020
Sample JCL to run a Java application in a multi-threaded environment using the JZOS batch launcher and Adabas Service for Java
AJZI030
Sample JCL to run a Java application in a single threaded environment using the JZOS batch launcher and Adabas Service for Java
AJZJVMP
Sample alternative to the mainframe IBM JZOS batch launcher procedure (JVMPRCnn)
zos/load
ADAAJZ6
Main load module
ADAAJZF
Front-end load module
ADAAJZS
zIIP enclave load module
4. In z/OS, allocate a PDSE load library for the extracted load modules currently in the zos/load folder of the installation directory. Create the library with the following attributes:
DCB=(DSORG=PO,RECFM=U),DSNTYPE=LIBRARY
Note:
The supplied sample jobs use AJZvrs.LOAD to refer to this PDSE load library.
5. In Unix System Services, copy the Adabas Service for Java load modules from the zos/load folder of the installation directory into the z/OS PDSE load library:
$ cd /opt/softwareag
$ cd AdabasClient/zos/load
$ cp * "//'AJZvrs.LOAD'"
6. In z/OS, allocate a jobs library for the extracted sample jobs currently in the zos/jobs folder of the installation directory. Create the library with the following attributes:
DCB=(DSORG=PO,RECFM=FB,LRECL=80)
Note:
The supplied sample jobs use AJZvrs.JOBS to refer to this PDSE load library.
7. In Unix System Services, copy the Adabas Service for Java sample jobs from the zos/jobs folder of the installation directory into the z/OS jobs library:
$ cd /opt/softwareag
$ cd AdabasClient/zos/jobs
$ cp * "//'AJZvrs.JOBS'"
8. Depending on the operational mode, make the AZPADLIC license load module available to the job or, alternatively, update the following DSN in the AJZJVMP sample procedure in the z/OS jobs library:
//DDLAZPAD DD DISP=SHR,DSN=AZPAD.LICENSE
Note:
The MLC load library must be available to the job if you are using a license.
9. For jobs to be able to use the sample procedure, copy AJZvrs.JOBS(AJZJVMP) into the appropriate procedure library of your site.
10. In a multi-threaded environment like Adabas Client for Java or Entire Net-Work Light, the re-entrant Adabas link module (ADALNKR) must be linked to the supplied ADAAJZ6 load module. In a single threaded environment such as standard batch jobs, this step can be omitted because the standard Adabas link module (ADALNK) is loaded dynamically. If appropriate for your environment, follow these steps:
*Allocate an Adabas Service for Java user load library on z/OS with the following attributes:
DCB=(DSORG=PO,RECFM=U),DSNTYPE=LIBRARY
Note:
The supplied sample jobs uses USER.LOAD to refer to this user load library.
*Tailor the supplied sample job AJZI010 by updating the following DSNs:
//ADALIB DD DSN=ADAvrs.LOAD,DISP=SHR
//AJZLIB DD DSN=AJZvrs.LOAD,DISP=SHR
//SYSLMOD DD DSN=USER.LOAD,DISP=SHR
*Submit the tailored job.
11. Depending on the operational mode, the STEPLIB runtime load libraries must be APF-authorized. APF-authorize each load library in the STEPLIB or, alternatively, merge all load libraries into a single APF-authorized one.
12. Sample jobs are provided to demonstrate the JCL required to run a Java application in both a single-threaded environment (AJZI030) and a multi-threaded environment (AJZI020).
*For a single-threaded environment
Take a copy of sample job AJZI030 and tailor it by making the following changes:
Change
Explanation
DSNs for the STEPLIB load libraries
Update the following DSNs accordingly:
//STEPLIB DD DSN=AJZvrs.LOAD,DISP=SHR
// DD DSN=ADAvrs.LOAD,DISP=SHR
// DD DSN=MLCvrs.LOAD,DISP=SHR
SAG environment variable in STDENV
Update the variable according to your installation directory created in Step1:
SAG=/opt/softwareag
STEPLIB environment variable in STDENV
Update the variable to identify the load library where ADAAJZ6 resides:
STEPLIB=AJZvrs.LOAD
JAVA_HOME environment variable in STDENV
Update the variable where Java may be found:
JAVA_HOME=/usr/lpp/java/J8.0_64
Java application main class and arguments
Provide the details for the Java application to be run:
//MAINARGS DD *
<class> <args>
/*
Tailor the DDCARD input parameters
For correct operation, a DDCARD DD statement must be provided and ADARUN PROG=USER is mandatory either explicitly or implicitly by default.
ADARUN parameters DBID=, SVC=, PREFETCH= are honored. If PREFETCH=YES, see section Using the Adabas Prefetch Feature.
If this is a Java application built from a Cobol program (for example using Java Optimized Applications for z/OS), simply include the same DDCARD input parameters as specified in the original Cobol job.
*For a multi-threaded environment
Take a copy of sample job AJZI020 and tailor it by making the following changes:
Change
Explanation
DSNs for the STEPLIB load libraries
Update the following DSNs accordingly:
//STEPLIB DD DSN=USER.LOAD,DISP=SHR
// DD DSN=AJZvrs.LOAD,DISP=SHR
// DD DSN=ADAvrs.LOAD,DISP=SHR
// DD DSN=MLCvrs.LOAD,DISP=SHR
SAG environment variable in STDENV
Update the variable according to your installation directory created in Step1:
SAG=/opt/softwareag
STEPLIB environment variable in STDENV
Update the variable to identify the load library where the linked ADAAJZ6 from Step10 is located:
STEPLIB=USER.LOAD
JAVA_HOME environment variable in STDENV
Update the variable where Java may be found:
JAVA_HOME=/usr/lpp/java/J8.0_64
Java application main class and arguments
Provide the details for the Java application to be run:
//MAINARGS DD *
<class> <args>
/*