Installing Adabas Online Services for z/OSMF Utility Server

This document provides information on the Adabas Online Services for z/OSMF Utility Server with product code AOZ, which was first introduced with Adabas 8.5 SP4 in conjunction with Adabas Manager 9.2 SP0.

AOZ is a RESTful server that leverages z/OSMF framework of IBM to provide APIs for Adabas Manager (AMN) to enable Adabas utility job submission and job output display.

The following section describes only how to install the AOZ server. Refer to the Adabas Manager documentation for information on the administration features that require the installation of the AOZ server.

Note
The AOZ server is distributed with Adabas Online Services.


AOZ Server Licensing Requirements

For correct operation of the AOZ server, the Adabas Online Services license file must be available in the target Adabas servers, which are administered by Adabas Manager.

AOZ Server Installation Steps

The following table describes the steps needed to successfully install the AOZ server.

Step Description
1
Create a UNIX System Services installation directory

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
Copy the AOZ package to the installation directory

Copy the AOZ distribution package to the /opt/softwareag installation directory.

cp "//'hlq.AOZvrs.TAR'" /opt/softwareag/AOZvrs.tar.Z
3
Extract the AOZ package into the installation directory

Extract the contents of the AOZ package in the UNIX System Services installation directory.

$ cd /opt/softwareag
$ uncompress < AOZvrs.tar.Z | tar -oxf -

The following components are extracted into /opt/softwareag/aoz:

  • aoz-server-<version>.jar – AOZ server .jar file

  • AOZSTC – Sample JCL to run the AOZ server as a started task

4
Copy the sample JCL to the z/OS procedure library

Copy the sample JCL for the AOZ server started procedure to the z/OS procedure library.

$ cd /opt/softwareag/aoz
$ cp AOZSTC "//'hlq.PROCLIB(AOZSTC)'"
5
Tailor the sample JCL for starting the AOZ server

Modify the following variables in the JCL for the started procedure:

  • ZOSMF – URL of z/OSMF

  • JAVA – Java installation directory

  • AOZDIR – Full path to the AOZ installation directory

  • AOZVER – Version number of the AOZ server .jar file

  • AOZPORT – Port number for the AOZ server to listen