WebSphere MQ Connector

Verwendung

Der WebSphere MQ Connector verbindet die IBM WebSphere MQSeries Software mit der INUBIT Process Engine.

Konnektortypen

Abhängig von seiner Konfiguration sendet oder empfängt der Konnektor Nachrichten:

  • Input Connectors

    Holt Nachrichten von einer Message Queue.

  • Input Listener Connector

    Empfängt eine Nachricht von der WebSphere MQ Software, sobald neue Nachrichten in der Queue stehen, holt diese Nachrichten ab und startet den Workflow.

  • Output Connector

    Schreibt Nachrichten in die Message Queue.

Voraussetzungen

Sie müssen der INUBIT-Software die Dateien com.ibm.mq.jar und com.ibm.mq.allclient.jar zugänglich machen.

So gehen Sie vor

  1. Schließen Sie die INUBIT Workbench.

  2. Stoppen Sie die INUBIT Process Engine.

  3. Kopieren Sie die Dateien com.ibm.mq.jar und com.ibm.mq.allclient.jar in das Verzeichnis <inubit-installdir>/inubit/client/lib/ext. Die Dateien sind Teil der IBM WebSphere MQ Software (<mq-installdir>/java/lib).

  4. Kopieren Sie die Dateien zusätzlich in das folgende Verzeichnis: <inubit-installdir>/inubit/server/process_engine/webapps/ibis/WEB-INF/lib

  5. Starten Sie die INUBIT Process Engine und die INUBIT Workbench neu.

Dialog WebSphere Message Queue Connector

In diesem Dialog haben Sie folgende Optionen:

Grundkonfiguration

  • Managername

    Name des Queue Managers, zu dem die Verbindung aufgebaut werden soll.

  • Servername

    Name des Servers, auf dem der WebSphere Application Server läuft.

  • Port

    Nummer des Ports, über den die Kommunikation zum WebSphere Application Server stattfindet. Standardportnummer ist 1414. Der Button Standard setzt jederzeit den Port wieder auf 1414 zurück.

  • Channel

    Name des Channels ein, für den Sie die Verbindung konfigurieren wollen. Der MQ Series Queue Manager kann mehrere Channel haben. Jeder Channel muss einen eigenen Namen haben.

Queue-Konfiguration

  • Queuename

    Name der Queue, über die Sie Nachrichten empfangen möchten. In einem Channel können mehrere Queues verwaltet werden.

  • Methode

    Methode zur Nachrichtenbehandlung. Wenn Nachrichten von einer Queue geholt werden, sind sie dort nach der FIFO-Methode gelistet. Die erste Nachricht, die empfangen wurde, wird als erste geholt.

    • Input Connector

      • GET: Holt die erste Nachricht von der Queue und löscht diese aus der Queue.

      • BROWSE: Holt eine Kopie der ersten Nachricht aus der Queue. Die Originalnachricht bleibt in der Message Queue erhalten.

      • INQUIRE: Fragt die Anzahl der Nachrichten in der Queue ab. Das Ergebnis wird als ganze Zahl in einer XML-formatierten Nachricht ausgegeben.

    • Output Connector

      • PUT: Schreibt die Nachricht in die angegebene Message Queue.

Sicherheit

  • UserID

    Benutzerkennung zur Authentifizierung beim WebSphere MQ-Server

  • Passwort

    Zur angegebenen Benutzerkennung gehöriges Passwort

Nachrichtenkonfiguration

  • Priorität

    Standard ist MQPRI_PRIORITY_AS_Q_DEF. Dieser Wert wird aus dem Attribut DefPriority übernommen. Dieses Attribut ist Teil der Queue Manager-Konfiguration.

    Alternativ kann die Priorität mit ganzzahligen Werten zwischen 0 (geringste Priorität) und 9 (höchste Priorität) belegt werden.

    Übernehmen Sie den Standardwert MQPRI_PRIORITY_AS_Q_DEF.

  • Format

    Beschreibt, in welchem Format die eingehende Nachricht vorliegt. Der überwiegende Teil der Anwendungen, die Nachrichten über WebSphere MQ austauschen, benutzt eines der Formate MQFMT_STRING und MQFMT_NONE.

    • MQFMT_STRING: Zum Abholen von Nachrichten, die nur aus Zeichen besteht, also TextMessage, StreamMessage oder MapMessage.

    • MQFMT_NONE: Für ObjectMessage, BytesMessage und Nachrichten ohne Body.

    • MQFMT_PCF: (programmable command format) Für benutzerdefinierte Datenstrukturen.

  • Warteintervall

    Wählen Sie beim Input Connector ein Warteintervall von 5 Millisekunden. Alternativ setzen Sie eine unbegrenzte Wartezeit (MQWI_UNLIMITED).

    Übernehmen Sie immer den Standard 5!

    Beim Output Connector hat diese Option keine Auswirkung.

  • Nur Nachrichten-Header lesen

    (Nur beim Input Connector)

    • Option Zeilenweise empfangen ist nicht aktiviert:

      Die Ausgangsnachricht des MQ Connectors enthält die erste Nachricht der Message Queue. Zusätzlich werden die Header-Informationen dieser Nachricht als Modulvariablen ausgegeben.

  • Option Zeilenweise empfangen ist aktiviert:

    Der MQ Connector liest zeilenweise aus der Message Queue bis zu einer Zeile mit dem String mqsende. Die Ausgangsnachricht besteht aus allen Zeilen bis zu diesem String. Die Header-Informationen werden der Nachricht mit dem String mqsende entnommen.

    Wenn keine der Nachrichten diesen String enthält, dann werden alle Zeilen aller Nachrichten aus der Queue gelesen. Die Header-Informationen stammen dann aus der letzten Nachricht und die Ausgangsnachricht enthält alle Zeilen aller Nachrichten aus der Message Queue.

  • Zeilenweise empfangen/versenden:

    Überträgt die Nachricht zeilenweise, dabei wird jede Zeile einer Nachricht als eigene Nachricht behandelt und übertragen. Beim Versenden von Nachrichten in diesem Modus ist es wichtig, dass die letzte Zeile in der Nachricht der String mqsende ist. Dieser String gewährleistet beim Zeilenweise-Empfangen, dass nur die erste Nachricht in der Queue bis zum Ende gelesen wird. Wenn der String mqsende nicht enthalten ist, werden alle Nachrichten der Queue zeilenweise bis zum Ende der Queue gelesen.

    Der MQ Connector fügt den String mqsende nicht ein. Sie müssen manuell sicherstellen, dass dieser String als letzte Zeile enthalten ist.

  • Nachricht zu XML konvertieren:

    Markieren Sie diese Option nur, wenn sichergestellt ist, dass jede Zeile, die vom MQ Connector gelesen wird, eine syntaktisch korrekte XML-Nachricht ist. Die XML-Nachricht wird durch einen internen Parser geprüft, bei einer fehlerhaften Nachricht wird ein Fehler erzeugt.

    Erstellt Nachrichten, die alle gelesenen Zeilen enthalten. Jede Zeile ist eine XML-Nachricht mit dem Aufbau

    <MQGET>Eine syntaktisch korrekte XML-Nachricht</MQGET>.

  • Commit-Methode: Das Commit stellt sicher, dass sich die Message Queue in einem konsistenten Zustand befindet.

    • nach jeder Nachricht: Das Commit wird nach jeder Nachricht durchgeführt. Diese Methode stellt sicher, dass nach jedem Abholen einer Nachricht der Queue Manager in konsistentem Zustand ist. Diese Option kann die Performance beeinträchtigen.

  • beim Verbindungsabbau: Erst wenn alle Nachrichten eines Auftrags von der Queue geholt wurden, wird ein Commit durchgeführt. Diese Methode ist performanter.

Verbindungstest

  • Verbindung testen

    Zum Testen, ob die Verbindung mit Ihren Angaben erfolgreich aufgebaut werden kann.