Administratorhandbuch > Installation > Neu-Installation > CallAPI für BS2000 installieren

CallAPI für BS2000 installieren

Hier finden Sie eine Anleitung für die Neuinstallation eines CallAPI für BS2000.

Mit AE wird ein CallAPI für BS2000 ausgeliefert. Es ermöglicht zum einen Aufrufe in der AE aus eigenen Programmen heraus. Eigene Programme können in Programmiersprachen wie C, COBOL, Assembler usw. geschrieben sein. Zum anderen steht mit UCXBB2?C ein Dienstprogramm zur Verfügung, welches beispielsweise per Aufruf in einer Prozedur oder einem Enter-Job genutzt werden kann.

Für jede unterstützte BS2000-Variante wurde ein einstelliges Kürzel vergeben. Dieses kommt in einigen Dateinamen des CallAPI vor und ist in "Terminologie" beschrieben. In diesem Dokument wird das relevante Kürzel durch die Zeichen "?" ersetzt.

In der INI-Datei des BS2000-CallAPIs können Sie bestimmen, welche CodeTabelle verwendet werden soll. Tragen Sie im Parameter codetable= in der Sektion [GLOBAL] den Namen des CodeTabellen-Objektes ein.

Ausgelieferte Dateien

Die Dateien, welche zum CallAPI gehören, sind in TAR-Files gepackt. Sie finden das jeweilige TAR-File im zur BS2000-Variante passenden Unterverzeichnis von IMAGE:AGENTS\BS2000:

IMAGE:AGENTS\BS2000\SIEMENS\UCXJB24.TAR für BS2000 mit Sockets Version 1.3
IMAGE:AGENTS\BS2000\SIEMENS\UCXJB25.TAR für BS2000 mit Sockets Version 2.1
IMAGE:AGENTS\BS2000\SIEMENS\UCXJB26.TAR für BS2000 mit Sockets Version 2.3

Das benötigte TAR-File ist durch einen beliebigen Text-FileTransfer in das BS2000-System zu übertragen. Dort kann es mit dem Dienstprogramm BS2-TAR oder den BS2-TOOLS ab der Version 2.00W (beides Automic Softwareprodukte) extrahiert werden.

Die folgenden Dateien gehören zur BS2000-Auslieferung und bilden den Inhalt der TAR-Datei. Im Namen der Dateien ist die aktuelle Automation Engine-Version enthalten. Diese wird in der Tabelle durch die Zeichen "x.xxx" ersetzt.

Dateiname	Beschreibung
x.xxx.UCXBB2?C.INI	ini-Datei für das Dienstprogramm
x.xxx.UCXBB2?C.LIB	LMS-Plambibliothek

Die LMS-Plambibliothek enthält alle Elemente, welche zur Programmierung nötig sind.

Elementname	Beschreibung
UCXBB2?C Typ L	Dienstprogramm zum Aufruf des CallAPI
UCCALL3 Typ L	Großmodul, das zum verwendeten Programm des CallAPIs dazugebunden bzw. dynamisch nachgeladen werden muss.
UCCALL3 Typ M	Assembler-Makro für die Schnittstellenbeschreibung
UCCALL3.H Typ S	C-Headerdatei für die Schnittstellenbeschreibung
UCCALL3.CPY Typ S	COBOL-Copy für die Schnittstellenbeschreibung
SAMPLE.COBOL Typ D	Beispielsource für die Verwendung der CallAPI aus einem COBOL-Programm

Ablauf

	1.	Einrichten des Systemumfeldes

Für die Verwendung des CallAPIs ist keine Installation erforderlich. Die Dateien sind im Agenten enthalten und werden mit diesem installiert.
Passen Sie die INI-Datei x.xxx.UCXBB2?C.INI an die Systemumgebung an.

Es ist nicht nötig, die INI-Datei bei jeder neuen Automation Engine-Version zu übernehmen. Achten Sie lediglich darauf, ob in der INI-Datei etwas geändert werden muss. Informationen dazu finden Sie in den ReleaseNotes, die sich gesammelt im Handbuch Änderungshistorie befinden.

Siehe auch:

CallAPI für BS2000

Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support