Mit dem JMSReply-Knoten werden Nachrichten an JMS-Zieladressen gesendet.
Dieses Thema enthält folgende Abschnitte:
Dieser JMSReply hat eine ähnliche Funktion wie der JMSOutput-Knoten, jedoch sendet der JMSReply-Knoten JMS-Nachrichten nur an die Antwortzieladresse, die im Headerfeld 'JMSReplyTo' der JMS-Nachrichtenbaumstruktur angegeben wurde. FVerwenden Sie den JMSReply-Knoten, wenn Sie eine JMS-Nachricht, die von einem Nachrichtenfluss gesendet wird, als Antwort auf eine JMS-Eingabenachricht behandeln möchten und keine weiteren Anforderungen bezüglich des Routings bestehen.
Der JMSReply-Knoten befindet sich im Ablagefach JMS der Palette und wird in der Workbench durch folgendes Symbol dargestellt:
Angenommen, Sie erstellen einen Nachrichtenfluss, in dem ein JMSInput-Knoten Punkt-zu-Punkt-Nachrichten von einer JMS-Zieladresse namens 'MyJMSInputQueue' empfängt. Der Nachrichtenfluss aktualisiert eine Tabelle mit dem Inhalt der Nachricht, antwortet anschließend einer JMS-Zieladresse namens 'MyJMSReplyQueue', die von der generierenden Anwendung im Header 'JMSReplyTo' der Eingabenachricht festgelegt wird.
In einem ähnlichen Szenario für das Publish/Subscribe-Nachrichtenmodell subskribiert ein JMSInput-Knoten TopicA, und der JMSReply-Knoten veröffentlicht an Zieladresse TopicB, die aus dem Header 'JMSReplyTo' der Eingabenachricht abgerufen wurde.
Nachdem Sie eine Instanz des JMSReply-Knotens in einen Nachrichtenfluss eingereiht haben, können Sie den Knoten 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 JMSReply-Knoten.
Wenn Sie einen Wert für 'Position der JNDI-Bindungen' eingeben, müssen Sie dabei folgende Anweisungen einhalten:
Weitere Informationen zur Erstellung der Bindungsdatei für verwaltete JNDI-Objekte finden Sie in der Dokumentation, die mit dem JMS-Provider bereitgestellt wird.
Weitere Informationen finden Sie unter Nachrichten überprüfen.
In der folgenden Tabelle werden die Terminals des JMSReply-Knotens beschrieben.
| Terminal | Beschreibung |
|---|---|
| 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. |
| Ausgang | Das Ausgabeterminal, an das die Nachricht weitergeleitet wird, wenn sie erfolgreich von der WebSphere MQ-Warteschlange abgerufen wird. |
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 |
|---|---|---|---|---|
| An Zieladressenliste in lokaler Umgebung senden | Nein | Ja | Nicht ausgewählt | 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. |
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| JMS-Anbieter | Ja | Nein | WebSphere MQ | Wählen Sie in der Dropdown-Liste einen JMS-Anbieter aus, oder geben Sie einen Namen ein. Wenn Sie in der Liste einen Namen auswählen, wird die Eigenschaft Ausgangskontext-Factory automatisch mit der entsprechenden
Java-Klasse aktualisiert. Wenn Sie den JMS-Provider selbst eingeben, müssen Sie auch einen Wert für Ausgangskontext-Factory eingeben. Der Standardwert lautet WebSphere MQ. |
| Anfängliche Kontext-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 den JMS-Provider selbst eingeben, müssen Sie auch einen Wert für Ausgangskontext-Factory eingeben. |
| Position der JNDI-Bindungen | Ja | Ja | Der Systempfad oder die LDAP-Position für die Bindungsdatei. | |
| Name der Verbindungsfactory | Ja | Ja | Der Name der Verbindungsfactory, der vom JMSReply-Knoten für die Erstellung einer Verbindung zum JMS-Provider verwendet wird. |
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| Neue Korrelations-ID | Nein | Ja | Nicht ausgewählt | Wählen Sie diese Eigenschaft aus, wenn eine neue Korrelations-ID erforderlich ist. |
| Transaktionsmodus | Nein | Nein | Keines | Durch diese Eigenschaft wird gesteuert, ob die ankommende Nachricht unter Synchronisationspunktsteuerung empfangen wird. Gültige Werte sind Keine, Lokal und Global. |
| Zustellmodus | Nein | Ja | Automatisch | Durch diese Eigenschaft wird der Permanenzmodus gesteuert, den ein
JMS-Provider für eine Nachricht verwendet. Gültige Werte sind:
|
| Verfall der Nachricht (ms) | Ja | 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 Werte von 0 bis 9 und der Standardwert 0 zeigen an, dass die Nachricht nicht verfallen darf. |
| Nachrichtenpriorität | Nein | Ja | 4 | Diese Eigenschaft weist der Nachricht eine relative Bedeutung zu und kann von einer empfangenden JMS-Clientanwendung oder einem JMSReply-Knoten zur Nachrichtenauswahl verwendet werden. |
| Nachrichtentyp | Nein | Ja | TextMessage (Textnachricht) | Über diese Eigenschaft wird die Klasse der JMS-Ausgabenachricht gesteuert.
Der Standardwert lautet TextMessage (Textnachricht).
Gültige Werte sind:
|
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| Auswertung | 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. |