Installation von CallAPI für WebSphere MQ (Windows)

Die Automation Engine stellt eine CallAPI für den WebSphere MQ Queue Manager von IBM bereit (früher als WebSphere MQ in MQSeries bezeichnet). Die CallAPI ermöglicht die Ausführung von AE-Scripts direkt aus dem WebSphere MQ Queue Manager über die API-Schnittstelle.

In Automic Automation Kubernetes Edition stellen CallAPIs eine Verbindung zu einem TCP-Load Balancer her. Die Adresse des Load Balancers muss auf beiden Seiten definiert sein: Automation Engine und CallAPI. Die einzigen Ausnahmen sind die CallAPIs für Java und SAP, die aktualisiert werden müssen, um TLS/SSL für die Verbindung mit der Automation Engine verwenden zu können. Diese beiden CallAPIs stellen eine Verbindung mit dem Java-Kommunikationsprozess (JCP) über einen Ingress/HTTPS-Load Balancer her.

Weitere Informationen:

• Container-basierte Installation - Automic Automation Kubernetes Edition

• Eine Verbindung zum AAKE-Cluster herstellen

Voraussetzungen

• WebSphere MQ Queue Manager-Server zur Erstellung von Queues für das Call Interface
• WebSphere MQ Queue Manager-Server für die API-Calls
• WebSphere MQ Queue Manager für MS Windows, Version 5.2.1 oder höher
• License Connect for WebSphere MQ

Für die Installation rufen Sie das Installationsprogramms SETUP.EXE aus dem Verzeichnis der bereitgestellten Dateien auf. Wenn die CallAPI bei jedem Systemstart automatisch aktiviert werden soll, verwenden Sie den. ServiceManager. Automation Engine Connector für WebSphere MQ Queue Manager kann als Dienst im ServiceManager gestartet und beendet werden.

Technische Implementierung

Diese Anwendungen stellen ihre Aktivierungsanforderungen für ein AE-Script in die AE-Queue des WebSphere MQ Queue Managers. Connect überprüft regelmäßig den Inhalt dieser Queue. Wenn sich eine Eingabeaufforderung in der Queue befindet, wird sie an die Automation Engine weitergeleitet. Die Automation Engine verarbeitet das Script und meldet das Ergebnis an Connect for WebSphere MQ. Connect for WebSphere MQ konvertiert dieses Ergebnis und leitet es an den Message Queue Manager weiter, der dann die entsprechende Eingabeaufforderung aktualisiert und Status und Ergebnis an die Anwendung meldet.

Die CallAPI installieren

Connect for WebSphere MQ muss auf einem System installiert sein, auf dem ein WebSphere MQ Queue Manager-Server läuft. Ein WebSphere MQ Queue Manager-Server muss verfügbar sein, um die CallAPI-Queue einzurichten und zu konfigurieren.

1. Einrichten von Queues für die AE mit dem WebSphere MQ Queue Manager Server.

   Die Einrichtung und Konfiguration der Komponenten von WebSphere MQ (Queue Manager, Queues, Channels) erfolgt entweder mit dem WebSphere MQ Explorer oder über Befehlsprogramme.

   1. Richten Sie den Queue Manager mit dem Namen queue.manager1: crtmqm -q queue.manager1 ein

   2. Starten Sie den Queue Manager: strmqm queue.manager1

   3. Starten Sie den Befehlsprozessor für WebSphere MQ-Befehle: runmqsc

      Hinweis: Es wird keine Eingabeaufforderung angezeigt.

   4. Richten Sie die Anforderungs-Queue für die AE mit einer maximalen Meldungslänge von 4096 Byte ein: Definieren Sie qlocal (UC4CInputQueue) maxmsgl (4096).

   5. Richten Sie die Antwort-Queue für Anwendungen ein: Definieren Sie qlocal (UC4CReplyQueue).

2. Installieren Sie den AE-Connector unter Verwendung von SETUP.EXE aus dem Auslieferungsverzeichnis.

   1. Starten Sie das Programm SETUP.EXE im Verzeichnis IMAGE:FRAMEWORK\MQSERIES\WINDOWS\Wi3_INTL. Das Laufwerk kann bei Bedarf gewechselt werden.

   2. Geben Sie das BIN-Verzeichnis für die Installation vom WebSphere MQ Queue Manager Server ein.

   3. Starten Sie die Installation.

      Der AE-Connector wird in die AE-Programmgruppe eingetragen. Wenn keine Programmgruppe vorhanden ist, wird eine neue angewandt.

3. Passen Sie die INI-Datei (UCXBMQSC.in) von Connect for Websphere MQ entsprechend dem WebSphere MQ Queue Manager und der Automation Engine-Systemumgebung an. Weitere Informationen finden Sie unter Connect for Websphere MQ

4. Starten Sie den AE-Connector zum Testen.

   • Der AE-Connector kann aus der AE-Programmgruppe aufgerufen oder direkt als Programm im Installationsverzeichnis gestartet werden. Wenn der Name der INI-Datei geändert wurde, muss der AE-Connector-Startup-Aufruf in der AE-Programmgruppe um den Dateinamen der aktuellen INI-Datei als Parameter (-I <INI-Datei>) erweitert werden.

   • Eine weitere Möglichkeit, den AE-Connector zu starten, besteht darin, den Befehl direkt in das Windows-Startmenü einzugeben, nachdem Sie auf Start und dann auf Ausführen geklickt haben. Damit diese Methoden ordnungsgemäß funktionieren, ist es erforderlich, die absoluten Dateinamen der EXE- und INI-Dateien (mit vollständiger Verzeichnispfadangabe) einzugeben.

   • Überprüfen Sie die AE -Connector-Protokolldatei. Sie sollte keine Fehlermeldungen enthalten.

   • Wenn der AE-Connector nicht gestartet werden kann, überprüfen Sie die Logdatei und ggf. die Trace-Datei. Um eine umfangreiche Fehlersuche durchzuführen, setzen Sie zusätzliche Trace-Flags in der INI-Datei des AE-Connectors. Detaillierte Informationen in der Trace-Datei können Ihnen helfen, einen Fehler auf seine Ursache zurückzuführen.

5. Testen Sie eine Anforderung an die AE über WebSphere MQ Queue Manager, indem Sie entweder Ressourcen in WebSphere MQ oder eine für diesen Zweck vorgesehene Anwendung verwenden.

   Wenn diese Eingabeaufforderung einem gültigen AE-Aufruf entspricht, verbindet sich der AE-Connector mit der Automation Engine und leitet die Eingabeaufforderung weiter. Die Ausführung der Anforderung wird in der Logdatei und bei Bedarf detaillierter in der Trace-Datei des AE-Connectors protokolliert, wo sie überwacht werden kann.

   Fehler, die während der Verarbeitung auftreten, sollten behoben werden. Wenn die Tests erfolgreich waren, kann der AE-Connector geschlossen werden.

6. Wenn Sie möchten, dass der AE Connector beim Systemstart automatisch aktiviert wird, fügen Sie ihn dem ServiceManager hinzu. Weitere Informationen finden Sie unter ServiceManager.

   Der einfachste Weg, den AE-Connector im ServiceManager einzugeben, besteht darin, einen bestehenden Service zu duplizieren und seine Einstellungen zu ändern. Hierfür benötigen Sie eine spezielle Berechtigung. Es ist auch möglich, den AE-Connector in die SMD-Datei des ServiceManagers einzutragen und dann den ServiceManager-Service zu starten oder neu zu starten.

   Da die Reihenfolge, in der die Services während des Windows-Boot-Prozesses starten, nicht geändert werden kann, müssen Sie in den AE-Connector-Einstellungen in das Feld Sekunden verzögert genügend Zeit eingeben, um sicherzustellen, dass der WebSphere MQ Queue Manager aktiv ist, bevor der AE-Connector startet.

Siehe auch:

CallAPI – Übersicht