JMSReply-Knoten

Mit dem JMSReply-Knoten werden Nachrichten an JMS-Zieladressen gesendet.

Dieses Thema enthält folgende Abschnitte:

Zweck

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:

Symbol für JMSReply-Knoten

JMSReply-Knoten in einem Nachrichtenfluss verwenden

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.

JMSReply-Knoten konfigurieren

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.

  1. Optional: Geben Sie auf der Registerkarte Beschreibung eine Kurzbeschreibung, eine ausführliche Beschreibung oder beides ein. Sie können den Knoten dort auch umbenennen.
  2. Wählen Sie auf der Registerkarte Grundeinstellung die Option An Zieladressenliste in lokaler Umgebung senden aus, falls Sie in der lokalen Umgebung eine Liste von JMS-Zieladressen erstellt haben. Sie können nun die Zieladressenliste 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.
  3. Legen Sie auf der Registerkarte JMS-Verbindung folgende Eigenschaften fest.
    • Wählen Sie in der Dropdown-Liste einen JMS-Anbieter aus, oder geben Sie einen Namen ein. Der Standardwert lautet WebSphere MQ.
    • Wenn Sie in der Liste den Namen eines JMS-Anbieters 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. Eine JMS-Anwendung verwendet den Ausgangskontext, um die verwalteten JNDI-Attribute für den JMS-Provider abzurufen und zu suchen. Der Standardwert lautet com.sun.jndi.fscontext.RefFSContextFactory. Mit diesem Wert wird die dateibasierte Ausgangskontext-Factory für den JMS-Provider von WebSphere MQ definiert.
    • Geben Sie einen Wert für die Position der JNDI-Bindungen ein. Dieser Wert gibt entweder den Dateisystempfad oder die LDAP-Adresse für die Bindungsdatei an. Die Bindungsdatei enthält Definitionen für die verwalteten JNDI-Objekte, die vom JMSReply-Knoten verwendet werden.

      Wenn Sie einen Wert für 'Position der JNDI-Bindungen' eingeben, müssen Sie dabei folgende Anweisungen einhalten:

      • Erstellen Sie die Bindungsdatei vor der Implementierung eines Nachrichtenflusses, der einen JMSReply-Knoten enthält.
      • Geben Sie in diesem Feld nicht den Dateinamen der Bindungsdatei ein.
      • Wenn Sie eine LDAP-Adresse angegeben haben, für die eine Authentifizierung erforderlich ist, konfigurieren Sie sowohl den LDAP-Principal (Benutzer-ID) als auch die LDAP-Berechtigungsnachweise (Kennwort) separat. Diese Werte werden auf Brokerebene konfiguriert. Die Beschreibungen der Befehle mqsicreatebroker und mqsichangebroker enthalten Informationen zum Konfigurieren dieser Werte.
      • Der Zeichenfolgewert muss eines der folgenden Schlüsselwörter enthalten:
        • file:/
        • iiop:/
        • ldap:/

      Weitere Informationen zur Erstellung der Bindungsdatei für verwaltete JNDI-Objekte finden Sie in der Dokumentation, die mit dem JMS-Provider bereitgestellt wird.

    • Geben Sie den Namen der Verbindungsfactory ein. Der Name der Verbindungsfactory wird vom JMSReply-Knoten für die Erstellung einer Verbindung zum JMS-Provider verwendet. Dieser Name muss in der Bindungsdatei bereits vorhanden sein.
  4. Legen Sie auf der Registerkarte Erweitert folgende Eigenschaften fest.
    • Aktivieren Sie das Kontrollkästchen, wenn der JMSReply-Knoten benötigt wird, um eine neue Korrelations-ID für die Nachricht zu generieren. Das Kontrollkästchen ist standardmäßig inaktiviert. Wenn Sie es nicht aktivieren, wird die Korrelations-ID der Ausgabenachricht aus dem Feld 'JMSCorrelationID' im Abschnitt 'JMSTransport_Header_Values' der Nachrichtenbaumstruktur übernommen.
    • Wählen Sie den Transaktionsmodus aus, um die transaktionalen Merkmale für die Handhabung dieser Nachricht zu definieren.
      • Wählen Sie Keine aus, wenn die abgehende Nachricht als nicht persistent behandelt werden soll. Wenn Sie diesen Wert auswählen, wird die Nachricht über eine JMS-Sitzung ohne Transaktionsunterstützung gesendet, die mit Hilfe des Attributs Session.AUTO_ACKNOWLEDGE erstellt wird.
      • Wählen Sie Lokal aus, wenn der Empfangsknoten, der die Nachricht erhalten hat, die Festschreibung oder Rücksetzung der vom JMSReply-Knoten gesendeten JMS-Nachrichten zusammen mit anderen Ressourcen, z. B. DB2 oder WebSphere MQ, die Arbeiten im Nachrichtenfluss ausführen, koordinieren soll. Wenn Sie diesen Wert auswählen, verwendet der Knoten eine JMS-Sitzung mit Transaktionsunterstützung.
      • Wählen Sie Global aus, wenn der JMSReply-Knoten an einer globalen Nachrichtenflusstransaktion teilnehmen soll, die vom externen Synchronisationspunkt-Koordinator des Brokers verwaltet wird. Beim Synchronisationspunkt-Koordinator handelt es sich auf verteilten Systemen um den Warteschlangenmanager des Brokers und unter z/OS um RRS (Resource Recovery Services). Wenn Sie diesen Wert auswählen, werden alle Nachrichten, die vom Knoten empfangen werden, mit Hilfe einer XA-JMS-Sitzung global koordiniert.
    • Sie können die Permanenz der abgehenden JMS-Nachricht mit Hilfe der Eigenschaft Zustellmodus festlegen. Wählen Sie eine Option aus der Dropdown-Liste aus:
      • Nicht permanent - Zeigt dem JMS-Provider an, dass die Nachricht als nicht permanent behandelt werden soll.
      • Permanent - Markiert Nachrichten für den JMS-Provider als permanent und stellt sicher, dass die Nachrichten beibehalten werden, bis sie erfolgreich an eine empfangende JMS-Clientanwendung übermittelt werden.
    • Geben Sie fr den Nachrichtenablauf einen Wert in Millisekunden ein, um anzufordern, dass der JMS-Provider die JMS-Ausgabenachricht für eine bestimmte Zeit aufbewahrt. Mit dem Standardwert 0 wird angegeben, dass die Nachricht nicht ablaufen soll.
    • Wenn Sie der Nachricht eine relative Bedeutung zuweisen möchten, wählen Sie aus der Dropdown-Liste Nachrichtenpriorität eine Option aus. Dieser Wert kann von einer empfangenden JMS-Clientanwendung oder einem JMSReply-Knoten für die Nachrichtenauswahl verwendet werden. Die gültigen Werte für die Nachrichtenpriorität liegen zwischen 0 (niedrigste Priorität) und 9 (höchste Priorität). Der Standardwert lautet 4, was eine mittlere Priorität bedeutet. Die Prioritäten im Bereich 0 bis 4 sind einer normalen Zustellung zugeordnet. Die Prioritäten im Bereich 5 bis 9 sind Abstufungen einer Eilzustellung zugeordnet.
    • Wählen Sie einen Nachrichtentyp aus der Dropdown-Liste aus. Über die Eigenschaft Nachrichtentyp wird der Typ der JMS-Ausgabenachricht gesteuert. Der Standardwert lautet TextMessage (Textnachricht). Wenn Sie keinen Wert für diese Eigenschaft angeben, übernimmt der Knoten den Ausgabetyp aus dem Metadatenfeld 'PayLoadType' in der JMS-Nachrichtenbaumstruktur.
  5. Legen Sie auf der Registerkarte Auswertung wie unter Auswertungseigenschaften beschrieben die Eigenschaften für die Auswertung der Ausgabenachricht fest: Hinweis: Wenn eine Nachricht an das Fehlerterminal des Knotens übergeben wird, wird sie nicht ausgewertet.

    Weitere Informationen finden Sie unter Nachrichten überprüfen.

Terminals und Eigenschaften

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).

In der folgenden Tabelle werden die Eigenschaften für die Beschreibung des JMSReply-Knotens beschrieben.
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.
In der folgenden Tabelle werden die Basiseigenschaften des JMSReply-Knotens beschrieben.
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.
In der folgenden Tabelle werden die JMS-Verbindungseigenschaften des JMSReply-Knotens beschrieben.
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.
In der folgenden Tabelle werden die erweiterten Eigenschaften des JMSReply-Knotens beschrieben.
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:
  • Automatisch: Der Modus wird aus der Eingabenachricht übernommen.
  • Permanent: Die Nachricht bleibt erhalten, wenn beim JMS-Provider ein Systemausfall auftritt.
  • Nicht permanent: Die Nachricht geht verloren, wenn beim JMS-Provider ein Systemausfall auftritt.
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:
  • TextMessage (Textnachricht)
  • BytesMessage (Bytenachricht)
  • MapMessage (Zuordnungsnachricht)
  • StreamMessage (Datenstromnachricht)
  • ObjectMessage (Objektnachricht)
  • JMS-Basisnachricht ohne Nutzdaten
Wenn Sie keinen Wert für diese Eigenschaft angeben, übernimmt der Knoten den Ausgabetyp aus dem Metadatenfeld 'PayLoadType' in der JMS-Nachrichtenbaumstruktur.
In der folgenden Tabelle werden die Eigenschaften für die Validierung des JMSReply-Knotens beschrieben. Der Abschnitt Auswertungseigenschaften enthält eine ausführliche Beschreibung dieser Eigenschaften.
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.
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
ac37130_