Anwendungsintegration > CallAPI > CallAPI und eigenes Programm > Cobol

Cobol

Das CallAPI bietet Ihnen die Möglichkeit, aus Ihren eigenen Java-Programmen heraus Scripts im Automation Engine System auszuführen.

In der Auslieferung sind auch Programmbeispiele enthalten, die Ihnen zeigen, wie eine Script-Aktivierung implementiert werden kann.

Allgemeines

Der Ablauf zur Script-Aktivierung läuft immer in folgenden Schritten:

Anmeldung am Automation Engine System
Übergabe des Scriptes an das Automation Engine System
Abmeldung vom Automation Engine System

Natürlich können sie sich gleichzeitig an verschiedene Automation Engine Systeme anmelden und mehrere Scripts ausführen. Für jede einzelne Verbindung wird eine Dialog-Lizenz verwendet.

Call

Rufen Sie das CallAPI mit dem Befehl CALL UCCALL3 auf. Als Rückgabewert liefert der Aufruf entweder 0, wenn die Aktion erfolgreich war, oder eine Meldungsnummer im Fehlerfall.

Beschreibung	Call
Anmelden am Automation Engine System	CALL UCCALL3 USING Struktur, Anmeldedaten, Verbindung Format für die Anmeldedaten: Mandant, Benutzer, [Abteilung, [Passwort]] Format für die Verbindungsdaten zum Kommunikationsprozess: DNS-Name:Portnummer bzw. TCP/IP-Adresse:Portnummer
Aktivieren eines Scriptes	CALL UCCALL3 USINGStruktur, Script
Abmelden vom Automation Engine System	CALL UCCALL3 USING Struktur

Beschreibung

Call

Anmelden am Automation Engine System

CALL UCCALL3 USING Struktur, Anmeldedaten, Verbindung

Format für die Anmeldedaten:
Mandant, Benutzer, [Abteilung, [Passwort]]

Format für die Verbindungsdaten zum Kommunikationsprozess:
DNS-Name:Portnummer
bzw.
TCP/IP-Adresse:Portnummer

Aktivieren eines Scriptes

CALL UCCALL3 USINGStruktur, Script

Abmelden vom Automation Engine System

CALL UCCALL3 USING Struktur

Variablen

Im ausgelieferten Beispielprogramm sehen Sie den Aufbau der Struktur AE-RECORD. Sie enthält folgende Variablen:

Variable	Datentyp	Beschreibung
UC-OPERATION	PIC X(4)	Operationscode Diese Variable muss bei der Verwendung der universellen Funktion gesetzt werden. Erlaubte Werte: "OPC_LOGON" - Anmelden am Automation Engine System "OPC_LOGOFF " - Abmelden vom Automation Engine System "OPC_ACTIVATE_SCRIPT" - Aktivieren eines Scriptes
UC-ERROR-CODE	PIC X	Der Fehlercode in cErrorCode wird automatisch gesetzt und kann einen der folgenden Werte enthalten: " " - Es ist kein Fehler aufgetreten. "P" - Ungültige(r) Parameter "O" - Ungültiger Opcode "I" - Initialisierung ist fehlgeschlagen "Q" - Anmeldung ist fehlgeschlagen "R" - Speicheranforderung ist fehlgeschlagen "L" - Speicherfreigabe ist fehlgeschlagen "S" - Socketfehler "T" - Timeout "U" - Fehlermeldung vom Automation Engine System
UC-INTERFACE-NR	PIC X(3)	Die Interfacenummer muss immer den Wert 3 enthalten.
UC-SYSTEM-NAME	PIC X(8)	Name des Automation Engine Systems, zu dem die Verbindung aufgebaut werden soll
UC-TIMEOUT	PIC 9(4) COMP-4	Zeitdauer in Sekunden, die das CallAPI auf eine Quittung vom Automation Engine System wartet
UC-LANGUAGE	PIC X	Sprache, in der die Meldungen ausgegeben werden
FILLER	PIC X(2)	nicht in Verwendung
UC-FLAG1	PIC X	Dieses Kennzeichen bewirkt je nach gesetztem Wert eine der folgenden Verarbeitungsoptionen: "CALL_FLAG1_INI_SERVER" - Die Verbindung zum Kommunikationsprozess wird aus der INI-Datei ermittelt. "CALL_FLAG1_INI_LOGIN" - Die Anmeldedaten werden aus der INI-Datei ermittelt. "CALL_FLAG1_INI_USEMSL" - Wandelt die variablen Meldungsteile auf eine ganzen Meldungstext um. "CALL_FLAG1_INI_USEALL" - Die Einstellungen der Sektion [GLOBAL] in der INI-Datei werden verwendet. "CALL_FLAG1_TRC_HANDLE" - nur für die interne CallAPI-Verarbeitung "CALL_FLAG1_LOG_HANDLE" - nur für die interne CallAPI-Verarbeitung "CALL_FLAG1_INI_FILE" - Name für die INI-Datei "CALL_FLAG1_TRC_OUTPUT" - nur für die interne CallAPI-Verarbeitung
FILLER	PIC X(2)	nicht in Verwendung
UC-OUTPUT-LEN	PIC 9(8) COMP-4	nicht in Verwendung
UC-RUNNR	PIC 9(8) COMP-4	RunID des Scriptes
UC-RETURN-CODE	PIC 9(8) COMP-4	Rückgabewert der Scriptausführung
UC-MESSAGE-TEXT	PIC X(256)	Variabler Teil der Meldung, der den Hintergrund des Rückgabewertes erläutert
UC-PRT-INI	PIC S9(8)	nur für die interne CallAPI-Verarbeitung
UC-HND-LOG	PIC S9(8)	nur für die interne CallAPI-Verarbeitung
UC-HND-TRC	PIC S9(8)	nur für die interne CallAPI-Verarbeitung
UC-HND-HLP	PIC S9(8)	nur für die interne CallAPI-Verarbeitung
UC-POINTER	PIC S9(8)	nur für die interne CallAPI-Verarbeitung
FILLER	PIC X(12)	nicht in Verwendung
UC-INIFILE	PIC X(45)	Pfad und Name der INI-Datei

Siehe auch:

Allgemeines zum CallAPI

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