Mit dem JMSOutput-Knoten werden Nachrichten an JMS-Zieladressen gesendet.
Dieses Thema enthält folgende Abschnitte:
Der JMSOutput-Knoten agiert als JMS-Nachrichtenproduzent und kann alle sechs Nachrichtentypen veröffentlichen, die in der Java Message Service Specification, Version 1.1 definiert sind. Nachrichten werden mit Hilfe von Methodenaufrufen veröffentlicht, die in der JMS-Spezifikation beschrieben sind.
Der JMSOutput-Knoten befindet sich im Ablagefach JMS der Palette und wird in der Workbench durch folgendes Symbol dargestellt:
Nachrichtenflüsse, die Nachrichten handhaben, die von Verbindungen mit JMS-Providern empfangen werden, müssen immer mit einem JMSInput-Knoten beginnen. Wenn Sie den JMSOutput-Knoten in einen Nachrichtenfluss aufnehmen, müssen Sie keinen JMSInput-Knoten einschließen. Wenn Sie jedoch keinen JMSInput-Knoten aufnehmen, müssen Sie den MQJMSTransform-Knoten einschließen, um die Nachricht in das Format umzuwandeln, das vom JMSOutput-Knoten erwartet wird.
Wenn Sie JMS-Nachrichten weitergeben und einen Nachrichtenfluss so erstellen, dass er einen untergeordneten Nachrichtenfluss verwendet, setzen Sie eine Instanz des JMSOutput-Knotens als letzten Knoten ein, um ein Ausgangsterminal für den untergeordneten Nachrichtenfluss zu erstellen.
Konfigurierbare Services sind für eine Reihe von JMS-Providern definiert. Sie können einen der vordefinierten Services auswählen oder einen neuen Service für einen neuen Provider oder einen vorhandenen Provider erstellen. Die vordefinierten Services sind unter Konfigurierbare Services aufgeführt.
Mit dem Befehl mqsireportproperties können Sie die Providereigenschaften anzeigen. Mit dem Befehl mqsichangeproperties können Sie die Eigenschaften festlegen oder modifizieren.
SET OutputRoot.JMSTransport.Transport_Folders.Message_MetaData.PayloadType=Nutzlastwert
Weitere Informationen zur JMS-Nachrichtenbaumstruktur und zu Nutzlastwerten finden Sie im Abschnitt Darstellung von Nachricht über das JMS-Transportprotokoll.
CREATE PROCEDURE CreateJMSDestinationList() BEGIN SET OutputLocalEnvironment.Destination.JMSDestinationList.DestinationData[1] = 'jndi://TestDestQueue1'; SET OutputLocalEnvironment.Destination.JMSDestinationList.DestinationData[2] = 'jndi://TestDestQueue2'; SET OutputLocalEnvironment.Destination.JMSDestinationList.DestinationData[3] = 'jndi://TestDestQueue3'; END;
Der Sender einer Nachricht erwartet möglicherweise eine Antwort vom Empfänger der Nachricht. In diesem Fall kann die JMSOutput-Nachricht die ausgehende Nachricht als Antwort behandeln und gemäß dem Wert, der aus der Eigenschaft 'JMSReplyTo' aus der Anforderungsnachricht abgerufen wird, weiterleiten. Sie können den Wert der Eigenschaft JMSReplyTo in MbMessage z. B. mit Hilfe eines Compute-Knotens oder eines JavaCompute-Knotens ändern. Dies ermöglicht das dynamische Routing von Nachrichten vom JMSOutput-Knoten aus. Der Knoten sendet die Nachricht an den JMS-Bestimmungsnamen, der im Feld 'JMSReplyTo' der MbMessage-Baumstruktur festgelegt wurde.
queue://QM_mn2/meineJMSWarteschlange4In diesem Fall handelt es sich bei dem Wert um die JMS-Provider-spezifische Darstellung der JMS-Zieladresse beim JMS-Provider für die WebSphere MQ-Serie.
jndi:\\jmsQ4Dabei steht jmsQ4 für den Namen des JNDI-verwalteten Objekts.
Bei Verwendung dieser Methode können leichte Leistungseinbußen auftreten, weil der Name des verwalteten Objekts erst in JNDI nachgeschlagen werden muss.
Wenn der JMSOutput-Knoten die Eigenschaft 'JMSReplyTo' in der ausgehenden Nachricht dynamisch festlegen soll, lassen Sie das Feld Zieladresse für Antworten auf der Registerkarte Grundeinstellungen leer, und legen Sie den Wert für 'JMSReplyTo' in MbMessage mit Hilfe eines Compute-Knotens oder eines JavaCompute-Knotens fest.
Der Knoten löst den Namen des JNDI-verwalteten Objekts auf, der entweder im Veröffentlichungsthema oder in der Zielwarteschlange bereitgestellt wurde, und sendet die Nachricht an diese JMS-Zieladresse.
Nachdem Sie eine Instanz des JMSOutput-Knotens in einen Nachrichtenfluss eingereiht haben, können Sie ihn konfigurieren; siehe Nachrichtenflussknoten konfigurieren. Die Knoteneigenschaften werden in der Eigenschaftenansicht angezeigt.
Alle verbindlichen Eigenschaften, für die kein Standardwert definiert ist, sind mit einem Stern markiert.
Konfigurieren Sie den JMSOutput-Knoten folgendermaßen:
Standardmäßig ist kein Wert angegeben. In diesem Fall kann die JMS-Ausgabenachricht als Datagramm betrachtet werden. Wenn dieses Feld leer gelassen wird, erwartet der JMSOutput-Knoten keine Antwort vom empfangenden JMS-Client.
Wenn Sie einen Wert für 'Position der JNDI-Bindungen' eingeben, müssen Sie dabei folgende Anweisungen einhalten:
Informationen zum Erstellen der JMS-Bindungsdatei für verwaltete JNDI-Objekte finden Sie in der mit dem JMS-Provider zur Verfügung gestellten Dokumentation.
Verbinden Sie das Eingangsterminal des JMSOutput-Knotens mit dem Knoten, von dem ausgehende Nachrichten weitergeleitet werden.
Verbinden Sie das Ausgangsterminal des JMSOutput-Knotens mit einem anderen Knoten im Nachrichtenfluss, um die Nachricht weiterzuverarbeiten, Fehler zu verarbeiten oder die Nachricht an eine weitere Zieladresse zu senden.
Wenn Sie einen JMSOutput-Knoten in einen Nachrichtenfluss einschließen, definiert der Wert, den Sie für den Transaktionsmodus festgelegt haben, ob die Nachrichten unter Synchronisationspunktsteuerung gesendet werden.
Unter Windows: Installationsverzeichnis/bin/ JMSSwitch.dll XAOpenString=Ausgangskontext, JNDI-Position, Optionale Parameter ThreadOfControl=THREAD
Fügen Sie auf Linux- und
UNIX-Systemen für jeden JMS-Provider eine Zeilengruppe zur
.ini-Datei des WS-Managers hinzu. XAResourceManager: Name=Name_des_JMS-Providers SwitchFile=/Installationsverzeichnis/bin/ JMSSwitch.so XAOpenString=Ausgangskontext, JNDI-Position, Optionale Parameter ThreadOfControl=THREADDabei ist
Die optionalen Parameter werden durch Kommas getrennt und sind positionsgebunden. Aus diesem Grund müssen fehlende Parameter durch ein Komma dargestellt werden.
Installationsverzeichnis/classes/xarecovery.jar
Installationsverzeichnis/bin
Weitere Informationen finden Sie im Abschnitt WebSphere MQ System Administration Guide im WebSphere MQ Version 6 Information Center online
Um denselben WS-Manager sowohl für den Broker als auch den JMS-Provider zu verwenden, müssen Sie sicherstellen, dass Ihre WebSphere MQ-Installation mindestens auf folgendem Stand ist: Version 6.0 Fixpack 1. WebSphere MQ Version 6.0 Fixpack 1 oder höher ist für XA erforderlich, um denselben WS-Manager für den Broker und den Provider zu verwenden.
Unter z/OS wird als externer Synchronisationspunktmanager
RRS (Resource Recovery Services) verwendet. Unter z/OS wird
als JMS-Provider lediglich WebSphere MQ JMS unterstützt.
Die
Bindungsoption ist die einzige Transportoption, die für WebSphere MQ
JMS unter z/OS unterstützt wird. Die Synchronisationspunktsteuerung für den JMS-Provider wird mit der RRS-Synchronisationspunkt-Koordination des Broker-WS-Managers verwaltet. Die Datei .ini muss nicht geändert werden.
| Terminal | Beschreibung |
|---|---|
| Eingangsterminal | Das Eingabeterminal, das eine Nachricht zur Verarbeitung durch einen Knoten annimmt. |
| Fehlerterminal | Das Ausgabeterminal, an das die Nachricht weitergeleitet wird, wenn ein Fehler auftritt. Selbst wenn die Eigenschaft 'Auswerten' festgelegt wird, werden Nachrichten, die an dieses Terminal weitergegeben werden, nicht ausgewertet. |
| Ausgabeterminal | Das Ausgabeterminal, an das die Nachricht weitergeleitet wird, wenn sie erfolgreich von der WebSphere MQ-Warteschlange abgerufen wird. |
| Abfangterminal | Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn nachgeschaltet eine Ausnahmebedingung ausgegeben und von diesem Knoten abgefangen wurde. |
In den folgenden Tabellen werden die Knoteneigenschaften beschrieben. Die Spalte M zeigt an, ob die Eigenschaft 'obligatorisch' ist (markiert mit einem Sternchen, wenn ein Wert eingegeben werden muss, weil kein Standardwert definiert ist). Die Spalte C zeigt an, ob die Eigenschaft 'konfigurierbar' ist (Wert kann geändert werden, wenn der Nachrichtenfluss zur BAR-Datei hinzugefügt wird, um ihn einzusetzen).
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| Knotenname | Nein | Nein | Knotentyp | Der Name des Knotens. |
| Kurzbeschreibung | Nein | Nein | Kurze Beschreibung des Knotens | |
| Ausführliche Beschreibung | Nein | Nein | Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt. |
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| Zielwarteschlange | Nein | Ja | Der Name der Warteschlange, in der der Knoten ausgehende Nachrichten veröffentlicht. | |
| Veröffentlichungsthema | Nein | Ja | Der Name des Themas, zu dem der Knoten veröffentlichte Nachrichten empfängt. | |
| Zieladresse für Antworten | Nein | Ja | Der Name der JMS-Zieladresse, an die die empfangende Anwendung eine Antwortnachricht senden muss. Der JMS-Bestimmungsname muss der Domäne des vom empfangenden Client verwendeten JMS-Providers bekannt sein, damit eine Antwortnachricht an diese JMS-Zieladresse zurückgegeben werden kann. | |
| An Zieladressenliste in lokaler Umgebung senden | Nein | Ja | Gelöscht | Wenn Sie in der lokalen Umgebung eine Liste von JMS-Zieladressen erstellt haben, aktivieren Sie dieses Kontrollkästchen, um die Zieladressenliste zu verwenden. Wenn Sie dieses Kontrollkästchen nicht aktivieren, verwendet der Knoten die konfigurierte JMS-Zieladresse. Wenn Sie dieses Kontrollkästchen aktivieren, aber keine Liste mit JMS-Zieladressen in der lokalen Umgebung erstellt haben, verwendet der Knoten die konfigurierte JMS-Zieladresse. |
| Nachrichtentyp | Nein | Ja | Ermitteln Sie den Typ der Ausgabenachricht aus der JMS-Nachrichtenbaumstruktur | Wählen Sie in der Liste einen Wert aus, um den Typ der JMS-Nachricht zu konfigurieren, der vom
JMSOutput-Knoten erstellt wird.
Wenn Sie keinen Wert für diese Eigenschaft festlegen, wählt der Knoten den Ausgabetyp aus dem Metadatenfeld 'PayLoadType' in der JMS-Nachrichtenbaumstruktur aus, wie durch den Standardwert Ausgabenachrichtentyp aus der JMS-Nachrichtenbaumstruktur bestimmen angezeigt wird. Gültige Werte sind:
|
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| Name des JMS-Provider | Ja | Nein | WebSphere MQ | Wählen Sie in der Liste den Namen eines JMS-Anbieters aus, oder geben Sie einen Namen ein. Wenn Sie einen Namen aus der Liste auswählen, wird die Eigenschaft Ausgangskontext-Factory automatisch durch die relevante Java-Klasse aktualisiert. Wenn Sie einen eigenen JMS-Providernamen eingeben, müssen Sie auch einen Wert für die Eigenschaft Ausgangskontext-Factory eingeben. Der Standardwert ist WebSphere MQ. |
| Ausgangskontext-Factory | Ja | Ja | com.sun.jndi.fscontext. RefFSContextFactory | Diese Eigenschaft gibt dem Ausgangspunkt für einen JNDI-Namespace an. Eine JMS-Anwendung verwendet den Ausgangskontext, um die Verbindungsfactory sowie Warteschlangen oder Themenobjekte für den JMS-Provider abzurufen und zu suchen. Wenn Sie in der Liste unter Name des JMS-Providers den Namen eines JMS-Providers auswählen, wird die Eigenschaft Ausgangskontext-Factory automatisch mit der entsprechenden Java-Klasse aktualisiert. Wenn Sie einen eigenen JMS-Providernamen eingeben, müssen Sie auch einen Wert für die Eigenschaft Ausgangskontext-Factory eingeben. |
| Position der JNDI-Bindungen | Nein | Ja | Der Systempfad oder die LDAP-Position für die Bindungsdatei. | |
| Name der Verbindungsfactory | Nein | Ja | Der Name der Verbindungsfactory, der vom JMSOutput-Knoten für die Erstellung einer Verbindung zum JMS-Provider verwendet wird. |
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| Neue Korrelations-ID | Nein | Ja | Diese Eigenschaft ist ausgewählt, wenn eine neue Korrelations-ID erforderlich ist. | |
| Transaktionsmodus | Ja | Nein | Keines | Durch diese Eigenschaft wird gesteuert, ob die eingehende Nachricht unter Synchronisationspunktsteuerung empfangen wird. Gültige Werte sind Keine, Lokal und Global. |
| Zustellmodus | Nein | Ja | Nicht permanent | Durch diese Eigenschaft wird der Permanenzmodus gesteuert, den ein
JMS-Provider für eine Nachricht verwendet. Gültige Werte sind:
|
| Verfall der Nachricht (ms) | Nein | Ja | 0 | Diese Eigenschaft gibt die Zeitdauer an, für die der JMS-Provider die JMS-Ausgabenachricht aufbewahrt. Die Werte werden in Millisekunden angegeben, und der Standardwert 0 zeigt an, dass die Nachricht nicht ablaufen darf. |
| Nachrichtenpriorität | Nein | Ja | 4 | Diese Eigenschaft weist der Nachricht eine relative Bedeutung zu und kann von einer empfangenden JMS-Clientanwendung oder einem JMSOutput-Knoten zur Nachrichtenauswahl verwendet werden. |
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| Auswerten | Nein | Ja | Übernehmen | Durch diese Eigenschaft wird gesteuert, ob eine Auswertung stattfindet. Gültige Werte sind Keine, Inhalt, Inhalt und Wert und Übernehmen. |
| Aktion bei Fehler | Nein | Nein | Ausnahme | Durch diese Eigenschaft wird gesteuert, was beim Fehlschlagen der Auswertung geschieht. Sie können diese Eigenschaft nur angeben, wenn Sie Auswerten auf Inhalt oder Inhalt und Wert gesetzt haben. Gültige Werte sind Benutzertrace, Lokales Fehlerprotokoll, Ausnahmebedingung und Ausnahmeliste. |