Administration Guide > Installation > New Installation > Installing the CallAPI for z/OS

Installing the CallAPI for z/OS

This document guides you through the new installation of a CallAPI for z/OS.

A CallAPI for z/OS is supplied with AE. It enables calls in AE from your own programs that were written in a particular programming language (C, for example). Additionally, the utility UCXBM25C is available. It can be used to call the CallAPI from a job, for example.

You can specify the CodeTable that is to be used in the INI file of the z/OS CallAPI. Enter the name of the CodeTable object in the section [GLOBAL] of the parameter codetable=. The IBM standard code table is used if nothing is specified in this parameter.

Supplied Files

The CallAPI utility is found in the supplied loadlib for the z/OS agent. The loadlib is stored in the subdirectory IMAGE:AGENTS\MVS:

UCXJM25-IBM.BIN (bound with the standard IBM TCP/IP Library)

Procedure

The load library can be transferred with any file transfer (such as IND$FILE without ASCII/EBCDIC conversion or CR/LF conversion). Create the load library using the utility TSO RECEIVE. The delivery directory contains a sample sucI file (UCXBM25C.INI), which can be used for any text file transfer to z/OS. Be sure to adjust it to your installation (Automation Engine data, for example).

You can keep your existing INI file even if there is a new Automation Engine version. It might be required to adjust it. More detailed information is provided in the Release Notes, a collection of which is found in the manual Release Notes.