Administratorhandbuch > Installation > Neu-Installation > Connect für WebSphere MQ (Windows) - Details

Connect für WebSphere MQ (Windows)

Hier finden Sie die Installation und Konfiguration des Connect für WebSphere MQ auf einer Windows Plattform.

	1. Warteschlangen für die AE mit WebSphere MQ Queue Manager Server einrichten

Host
Das Einrichten und Konfigurieren der Komponenten von WebSphere MQ (Queue Manager, Queues, Channels) erfolgt entweder mit dem WebSphere MQ Explorer oder mit den Kommandoprogrammen.
Queue Manager mit dem Namen "queue.manager1" einrichten.

crtmqm -q queue.manager1

strmqm queue.manager1

Kommandoprozessor für WebSphere MQ-Befehle starten. Hinweis: Es wird kein Prompt angezeigt.

runmqsc

Anforderungswarteschlange für die AE mit maximal 4096 Byte Nachrichtenlänge einrichten.

define qlocal ('UC4CInputQueue') maxmsgl (4096)

define qlocal ('UC4CReplyQueue')

	2. AE-Connector mit SETUP.EXE von der Auslieferungs-CD auf dem System installieren

Host
Starten des Programms SETUP.EXE im Verzeichnis IMAGE:FRAMEWORK\MQSERIES\WINDOWS\Wi3_INTL. Eventuell Laufwerk ändern. Als Ziel ist das BIN-Verzeichnis der Installation von WebSphere MQ Queue Manager Server anzugeben. Installation mit dem großen Button (Computer, Verpackung und Diskette) starten.
Der AE-Connector wird in die angegebene AE-Programmgruppe eingetragen. Ist die Programmgruppe nicht vorhanden, so wird sie neu angelegt.

	3. INI-Datei des AE-Connectors anpassen

Host
Die INI-Datei des AE-Connectors muss entsprechend des Systemumfeldes von WebSphere MQ Queue Manager und der Automation Engine angepasst werden.

	4. AE-Connector starten

Host
Der AE-Connector wird nun zum Testen gestartet. Dazu kann der AE-Connector aus der AE-Programmgruppe heraus aufgerufen oder direkt als Programm im Installationsverzeichnis gestartet werden. Wurde der Dateiname der verwendeten INI-Datei geändert, muss der Startaufruf des AE-Connectors 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, über das Windows-Startmenü Start - Ausführen... das Kommando direkt einzugeben. Dabei ist es aber erforderlich, den absoluten Dateinamen der EXE- und der INI-Datei (mit vollständigem Verzeichnispfad) anzugeben.
Log-Datei des AE-Connectors überprüfen. Es dürfen keine Fehlermeldungen enthalten sein.
Kann der AE-Connector nicht gestartet werden, muss die Log-Datei und die gegebenenfalls vorhandene Trace-Datei geprüft werden. Für eine intensive Fehlersuche können zusätzlich Traceflags in der INI-Datei des AE-Connectors gesetzt werden. Die dadurch erzeugten ausführlicheren Informationen in der Trace-Datei lassen möglicherweise einen Rückschluss auf die Fehlerursache zu.

	5. Anforderung an AE mit WebSphere MQ Queue Manager testen

Host
Eine Anforderung an die AE kann nun in die Anforderungswarteschlange geschrieben werden. Dies geschieht mit den Mitteln von WebSphere MQ oder durch eine dafür vorgesehene Anwendung.
Entspricht die Anforderung einem gültigen AE-Aufruf, so nimmt der AE-Connector Verbindung zum Automation Engine-Server auf und leitet diese Anforderung weiter.
Die Durchführung der Anforderung wird in der Log-Datei und gegebenenfalls ausführlicher in der Trace-Datei des AE-Connectors protokolliert. Sie kann dort kontrolliert werden.
Sind Fehler im Ablauf aufgetreten, sind diese zu klären.
Verliefen die Tests erfolgreich, kann der AE-Connector wieder beendet werden.

	6. AE-Connector im ServiceManager eintragen

Host
Ist es erforderlich, dass der AE-Connector beim Systemstart automatisch aktiviert wird, sollte dieser im ServiceManager eingetragen werden.
Ist noch kein ServiceManager auf dem System vorhanden, so ist dieser zuvor zu installieren.
Die einfachste Art, den AE-Connector im ServiceManager einzutragen, ist, einen bestehenden Dienst zu duplizieren und dessen Eigenschaften anzupassen. Dafür ist eine spezielle Berechtigung erforderlich. Es ist auch möglich, den AE-Connector in die SMD-Datei des ServiceManagers einzutragen und anschließend den Dienst des ServiceManagers zu starten bzw. neu zu starten.
Die Startreihenfolge der Dienste beim Hochfahren des Windows-Systems kann nicht beeinflusst werden. Aus diesem Grund sollte im Feld "Seconds delayed" der Eigenschaften des AE-Connectors in jedem Fall eine ausreichende Zeit eingetragen werden. Die festgelegte Verzögerung muss sicherstellen, dass der WebSphere MQ Queue Manager nach dem Neustart des Systems bereits aktiv ist, wenn der AE-Connector vom ServiceManager gestartet wird.

Siehe auch: