In diesem Abschnitt wird beschrieben, wie Komponenten zum Senden und Empfangen von Dokumenten zwischen WebSphere Partner Gateway und WebSphere Business Integration Message Broker unter Verwendung des JMS-Transportprotokolls konfiguriert werden. Es enthält die folgenden Informationen zum Senden und Empfangen von Dokumenten:
Zum Senden oder Empfangen eines Dokuments zwischen WebSphere Partner Gateway und Message Broker Version 5.0 mit Hilfe des JMS-Transportprotokolls ist WebSphere MQ als JMS-Provider erforderlich. In den folgenden Abschnitten wird beschrieben, wie WebSphere Partner Gateway, Message Broker und WebSphere MQ zusammenarbeiten, um Dokumente über das JMS-Transportprotokoll auszutauschen.
Beim Senden eines Dokuments von WebSphere Partner Gateway an Message Broker über das JMS-Transportprotokoll verwenden Sie die JMS-Warteschlangen. WebSphere Partner Gateway sendet ein Dokument an die vorgesehene JMS-Ausgabewarteschlange, von der aus es an die JMS-Eingabewarteschlange übertragen wird, über die Message Broker empfangsbereit ist. Beim Empfangen eines Dokuments ruft Message Broker es aus seiner Eingabewarteschlange ab. Der Nachrichtenfluss von Message Broker enthält spezielle (JMS-)Transportknoten für WebSphere MQ, die den Zugriff auf die JMS-Warteschlangen ausführen. In Abb. 25 ist zusammengefasst, wie WebSphere Partner Gateway über das JMS-Transportprotokoll Dokumente an Message Broker sendet.
Die folgenden Schritte beschreiben, wie WebSphere Partner Gateway über das JMS-Transportprotokoll ein Dokument an einen Nachrichtenfluss in Message Broker sendet:
Wenn der Pakettyp des Dokuments 'Back-End-Integrationspaket' ist, wurden von WebSphere Partner Gateway angepasste Eigenschaften in dieser Nachricht bereitgestellt. Der JMS-Nachrichtenheader 'JMSType' wird mit dem Inhaltstyp (content-type) der Nutzinformationen (payload) definiert.
Informationen zur Konfiguration dieser Warteschlange finden Sie im Abschnitt Umgebung für den JMS-Transport einrichten.
Wenn die Geschäftslogik abgeschlossen ist, sendet der Nachrichtenfluss das resultierende Dokument an den MQOutput-Knoten.
Zum Empfangen eines Dokuments von Message Broker durch WebSphere Partner Gateway über das JMS-Transportprotokoll verwenden Sie JMS-Warteschlangen. Message Broker sendet ein Dokument an die vorgesehene JMS-Ausgabewarte- schlange, von der aus es an die JMS-Eingabewarteschlange übertragen wird, über die WebSphere Partner Gateway empfangsbereit ist. Wenn WebSphere Partner Gateway ein Dokument empfängt, ruft es es aus seiner Eingabewarteschlange ab. Der Nachrichtenfluss von Message Broker enthält spezielle (JMS-)Transportknoten für WebSphere MQ, die den Zugriff auf die JMS-Warteschlangen ausführen. Abb. 26 veranschaulicht, wie Dokumente von Message Broker an WebSphere Partner Gateway gesendet werden.
Die folgenden Schritte beschreiben, wie WebSphere Partner Gateway über das JMS-Transportprotokoll ein Dokument von einem Nachrichtenfluss in Message Broker empfängt:
Der Nachrichtenfluss empfängt die eingehende Nachricht aus einer JMS-Eingabewarteschlange.
Wenn die Geschäftslogik abgeschlossen ist, sendet der Nachrichtenfluss das resultierende Dokument an den MQOutput-Knoten.
Weitere Informationen zum Ziel finden Sie im Abschnitt Dokumenteneingang über das JMS-Transportprotokoll konfigurieren. Informationen zur Einrichtung dieser Warteschlange finden Sie im Abschnitt Umgebung für den JMS-Transport einrichten.
Für das Senden und Empfangen von Dokumenten mit Message Broker sind (ferne und lokale) JMS-Warteschlangen erforderlich. Informationen zur Konfiguration von WebSphere Partner Gateway zur Verwendung mit Message Broker über JMS finden Sie im Abschnitt WebSphere Partner Gateway für die Verwendung mit Message Broker konfigurieren. Zur Verwendung des JMS-Transportprotokolls mit Message Broker können Sie das von WebSphere MQ zur Verfügung gestellte JMS-System einrichten. Version 5.0 von Message Broker arbeitet mit Version 5.3 von WebSphere MQ als JMS-Provider. Zum Konfigurieren des Mechanismus für das JMS-Transportprotokoll können die Anweisungen im Handbuch Hub-Konfiguration verwendet werden.
Wenn Sie Ihre JMS-Warteschlangen für die Verwendung zwischen WebSphere Partner Gateway und Message Broker erstellen, beachten Sie folgende Punkte:
Mit dem folgenden Befehl können Sie diesen Warteschlangenmanager sowie eine Reihe benannter Warteschlangen erstellen:
mqsicreatebroker
Da Message Broker eine Reihe vorbestimmter Warteschlangennamen verwendet, ist pro Broker ein separater WebSphere MQ-Warteschlangenmanager erforderlich. Message Broker kann diesen Warteschlangenmanager gemeinsam benutzen, der entweder zusammen mit dem Konfigurationsmanager (Configuration Manager) oder dem optionalen Benutzernamensserver (User Name Server) oder beiden betrieben wird.
Weitere Informationen finden Sie im Handbuch WebSphere Business Integration Message Broker Installation and Configuration Guide.
Wenn Sie zum Beispiel die in der Spalte Originalwarteschlangenname von Tabelle 54 aufgeführten Warteschlangen erstellen, könnten Sie diese Warteschlangen so umbenennen, dass sie die Flussrichtung wie in der Spalte Richtungsbezogener Warteschlangenname von Tabelle 70 gezeigt angeben.
Originalwarteschlangenname | Richtungsbezogener Warteschlangenname |
---|---|
inQ | MB2HUB |
outQ | HUB2MB |
Ein Message Broker-Nachrichtenfluss verwendet zur Verarbeitung von Dokumenten über das JMS-Transportprotokoll die folgenden Transportknoten:
Die Verwendungsreihenfolge dieser Transportknoten hängt wie folgt von der Kommunikationsrichtung ab:
Knotentyp | Zweck | Anmerkungen und Einschränkungen |
---|---|---|
MQInput | Empfängt das Dokument von WebSphere Partner Gateway. | Der Wert im Feld für den Warteschlangennamen (Queue Name) in den Basiseigenschaften (Basic Properties) dieses Transportknotens ist die Eingabewarteschlange des Nachrichtenflusses. WebSphere MQ muss so eingerichtet werden, dass diese JMS-Warteschlange Dokumente aus der Ausgabewarteschlange von WebSphere Partner Gateway empfängt. Weitere Informationen finden Sie im Abschnitt Dokumentenempfang über das JMS-Transportprotokoll konfigurieren. |
Compute | Führt die Operationen der Geschäftslogik aus, z. B. das Entfernen von Headerinformationen. | Keine. |
MQOutput | Empfängt das Dokument vom Berechnungsknoten (Compute-Knoten) und sendet es als Ausgabe des Nachrichtenflusses. | Dieser Transportknoten sendet das resultierende Dokument an eine JMS-Ausgabewarteschlange, die sie an das nächste Ziel weiterleitet. |
Knotentyp | Zweck | Anmerkungen und Einschränkungen |
---|---|---|
MQInput | Empfängt das Dokument im Nachrichtenfluss. | Dieser Transportknoten empfängt das eingehende Dokument aus einer JMS-Eingabewarteschlange. |
Compute | Führt die Operationen der Geschäftslogik aus, z. B. die Aktualisierung von Headerinformationen. | Keine. |
MQOutput | Empfängt das Dokument vom Berechnungsknoten und sendet es an WebSphere Partner Gateway. | Der Wert im Feld für den Warteschlangennamen (Queue Name) in den Basiseigenschaften (Basic Properties) dieses Transportknotens ist die Ausgabewarteschlange des Nachrichtenflusses. WebSphere MQ muss so eingerichtet werden, dass diese JMS-Warteschlange Dokumente an die Eingabewarteschlange von WebSphere Partner Gateway sendet. Weitere Informationen finden Sie im Abschnitt Dokumenteneingang über das JMS-Transportprotokoll konfigurieren. |
Weitere detaillierte Informationen zur Erstellung und Konfiguration von Nachrichtenflussknoten finden Sie in der Dokumentation zu WebSphere Business Integration Message Broker.