In diesem Abschnitt wird beschrieben, wie Komponenten zum Senden und Empfangen von Dokumenten zwischen WebSphere Business Integration Connect 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 Business Integration Connect 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 Business Integration Connect, Message Broker und WebSphere MQ zusammenarbeiten, um Dokumente über das JMS-Transportprotokoll auszutauschen.
Beim Senden eines Dokuments von Business Integration Connect an Message Broker über das JMS-Transportprotokoll verwenden Sie die JMS-Warteschlangen. Business Integration Connect sendet ein Dokument an die vorgesehene JMS-Ausgabewarteschlange, von der aus es an die JMS-Eingabewarteschlange übertragen wird, über die Message Broker empfangsbereit ist. Wenn Message Broker ein Dokument empfängt, 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. Abbildung 23 veranschaulicht, wie Business Integration Connect Dokumente über das JMS-Transportprotokoll an Message Broker sendet.
Die folgenden Schritte beschreiben, wie Business Integration Connect ein Dokument an einen Nachrichtenfluss innerhalb von Message Broker über das JMS-Transportprotokoll sendet:
Wenn der Pakettyp des Dokuments 'Back-End-Integrationspaket' ist, wurden von Business Integration Connect 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 in 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 Business Integration Connect über das JMS-Transportprotokoll verwenden Sie JMS-Warteschlangen. Message Broker sendet ein Dokument an die vorgesehene JMS-Ausgabewarteschlange, von der aus es an die JMS-Eingabewarteschlange übertragen wird, über die Business Integration Connect empfangsbereit ist. Wenn Business Integration Connect ein Dokument empfängt, ruft Business Integration Connect 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. Abbildung 24 veranschaulicht, wie Dokumente von Message Broker an Business Integration Connect gesendet werden.
Die folgenden Schritte beschreiben, wie Business Integration Connect ein Dokument von einem Nachrichtenfluss innerhalb von Message Broker über das JMS-Transportprotokoll 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 in Für eingehende Dokumente über das JMS-Transportprotokoll konfigurieren. Informationen zur Einrichtung dieser Warteschlange finden Sie in 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 Business Integration Connect zur Verwendung mit Message Broker über JMS finden Sie in Business Integration Connect für 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. Daher können Sie den JMS-Transportprotokollmechanismus mit den in Anhang A, JMS-Protokoll mit WebSphere MQ konfigurieren beschriebenen Schritten einrichten.
Wenn Sie Ihre JMS-Warteschlangen für die Verwendung zwischen Business Integration Connect 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 89 aufgeführten Warteschlangen erstellen, könnten Sie diese Warteschlangen so umbenennen, dass sie die Richtung in Bezug auf Message Broker wie in der Spalte Richtungsbezogener Warteschlangenname von Tabelle 89 gezeigt angeben.
Tabelle 89. Benennen von JMS-Warteschlangen mit Richtungsangabe für Message Broker
Originalwarteschlangenname | Richtungsbezogener Warteschlangenname |
---|---|
inQ | MB2WBIC |
outQ | WBIC2MB |
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:
Tabelle 90. Knoten zum Senden von Dokumenten an Message Broker über JMS
Knotentyp | Zweck | Anmerkungen und Einschränkungen |
---|---|---|
MQInput | Empfängt das Dokument von Business Integration Connect. | 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 Business Integration Connect empfängt. Weitere Informationen finden Sie in Für ausgehende Dokumente ü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. |
Tabelle 91. Knoten zum Empfangen von Dokumenten von Message Broker
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 (Compute-Knoten) und sendet es an Business Integration Connect. | 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 Business Integration Connect sendet. Weitere Informationen finden Sie in Für ausgehende Dokumente über das HTTP-Transportprotokoll konfigurieren. |
Weitere detaillierte Informationen zur Erstellung und Konfiguration von Nachrichtenflussknoten finden Sie in der Dokumentation zu WebSphere Business Integration Message Broker.