Administration Guide > Installation > New Installation > Installing the CallAPI for BS2000

Installing the CallAPI for BS2000

This document guides you through the new installation of a CallAPI for BS2000.

A CallAPI for BS2000 is supplied with AE. This interface enables calls in AE from your own programs, which can be written in programming languages such as C, COBOL, or Assembler. UCXBB2?C serves as a utility that can be called from a procedure or enter job, for example.

A one-character code has been assigned for each supported BS2000 variant. This code is used in some CallAPI file names. Details are described in "terminology". In this document, the specific code is replaced by "?."

You can specify the CodeTable that should be used in the INI file of the BS2000 CallAPI. Enter the name of the CodeTable object in the section [GLOBAL] of the parameter codetable=.

Supplied Files

The CallAPI files are packed as TAR files. The relevant TAR file is found in the sub-directory of the appropriate BS2000 variant in IMAGE:AGENTS\BS2000:

IMAGE:AGENTS\BS2000\SIEMENS\UCXJB24.TAR for BS2000 Sockets Version 1.3
IMAGE:AGENTS\BS2000\SIEMENS\UCXJB25.TAR for BS2000 Sockets Version 2.1
IMAGE:AGENTS\BS2000\SIEMENS\UCXJB26.TAR for BS2000 Sockets Version 2.3

Transfer the required TAR file to the BS2000 system using any text file transfer. It can then be extracted using the utility BS2-TAR or the BS2-TOOLS version 2.00W or later (both are products of Automic software).

The LMS Plamlibrary contains all elements that are required for programming.

Procedure

	1.	Setting up the system environment

The CallAPI can be used with no installation required. Its files are included in the agent and installed when the agent is installed.
Adjust the INI file x.xxx.UCXBB2?C.INI to your system environment.

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.