Mit dem JMSSendeknoten werden Nachrichten an JMS-Zieladressen gesendet. Der JMSSendeknoten 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 JMSSendeknoten 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 JMSEmpfangsknoten beginnen. Wenn Sie den JMSSendeknoten in einen Nachrichtenfluss aufnehmen, müssen Sie keinen JMSEmpfangsknoten aufnehmen. Wenn Sie jedoch keinen JMSEmpfangsknoten aufnehmen, müssen Sie den MQJMSUmsetzungsknoten aufnehmen, um die Nachricht in das Format umzuwandeln, das vom JMSSendeknoten erwartet wird.
Wenn Sie JMS-Nachrichten weitergeben und einen Nachrichtenfluss entsprechend erstellen, dass er einen untergeordneten Fluss verwendet, müssen Sie eine Instanz des JMSSendeknotens als letzten Knoten nehmen, um ein Ausgangsterminal für den untergeordneten Fluss zu erstellen.
Kopieren Sie auf verteilten Systemen die .jar-Dateien in Java und alle nativen Bibliotheken für den Client des JMS-Providers in das Brokerverzeichnis 'shared-classes'. Beispiel unter Windows: C:\Dokumente und Einstellungen\All Users\Anwendungsdaten\IBM\MQSI\shared-classes. Dadurch wird sichergestellt, dass der Pfad der Java-Klasse für die JMS-Knoten richtig festgelegt ist.
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 WMQ-Serie.
jndi:\\jmsQ4, wobei jmsQ4 für den Namen des JNDI-verwalteten Objekts steht.
Bei dieser Methode kommt es zu einer leichten Leistungseinbuße, weil der Name des verwalteten Objekts erst in JNDI nachgeschlagen werden muss.
Wenn der JMSSendeknoten die Eigenschaft JMSReplyTo in der abgehenden Nachricht dynamisch festlegen soll, lassen Sie das Attribut Reply To Destination (Antwort an Zieladresse) leer, und definieren Sie den Wert für JMSReplyTo in MbMessage mit Hilfe eines Rechenknotens oder Java-Rechenknotens.
Der Knoten löst denjenigen Namen eines JNDI-verwalteten Objekts auf, der entweder im Veröffentlichungsthema oder in der Zielwarteschlange bereitgestellt wurde, und sendet die Nachricht an diese JMS-Zieladresse.
Wenn Sie eine Instanz des JMSSendeknotens in einen Nachrichtenfluss eingereiht haben, können Sie diese konfigurieren, indem Sie in der Editoransicht mit der rechten Maustaste auf den Knoten klicken und anschließend auf Eigenschaften klicken. Daraufhin werden die grundlegenden Eigenschaften des Knotens im Eigenschaftendialogfeld angezeigt.
Alle verbindlichen Eigenschaften, für die kein Standardwert definiert ist, sind im Dialogfenster für die Eigenschaften mit einem Stern markiert.
Konfigurieren Sie den JMSSendeknoten wie folgt:
com.sun.jndi.fscontext.RefFSContextFactory; damit wird die dateibasierte Ausgangskontextfactory für den JMS-Provider von WebSphere MQ definiert.
Die Dokumentation des JMS-Providers enthält Informationen zum Namen der Ausgangskontext-Factory.
Wenn Sie einen Wert für die Position der JNDI-Bindungen eingeben, müssen Sie sicherstellen, dass er mit den folgenden Anweisungen kompatibel ist:
Weitere Informationen zur Erstellung der Bindungsdatei für verwaltete JNDI-Objekte finden Sie in der Dokumentation, die mit dem JMS-Provider bereitgestellt wird.
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 JMSSendeknoten keine Antwort vom empfangenden JMS-Client.
Geben Sie einen Wert in Millisekunden ein, um anzugeben, wie lange die Nachricht vom JMS-Provider aufbewahrt werden soll. Mit dem Standardwert 0 wird angegeben, dass die Nachricht nicht ablaufen soll.
Geben Sie einen Wert ein, wobei die gültigen Werte für die Nachrichtenpriorität zwischen 0 (niedrigste Priorität) und 9 (höchste Priorität) liegen. 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.
Sie finden detailliertere Informationen hierzu unter Nachrichten überprüfen und Eigenschaften der Gültigkeitsprüfung für Nachrichten in der MRM-Domäne.
Klicken Sie auf Abbrechen, um den Dialog zu schließen und alle Änderungen zu verwerfen, die Sie an den Eigenschaften vorgenommen haben.
Verbinden Sie das Eingangsterminal des JMSSendeknotens mit dem Knoten, von dem abgehende Nachrichten weitergeleitet werden.
Verbinden Sie das Ausgangsterminal des JMSSendeknotens mit einem anderen Knoten im Nachrichtenfluss, wenn Sie die Nachricht weiterverarbeiten, Fehler verarbeiten oder die Nachricht an eine zusätzliche Zieladresse senden möchten.
Wenn Sie einen JMSSendeknoten in einen Nachrichtenfluss einschließen, definiert der Wert, den Sie für den Transaktionsmodus festgelegt haben, ob die Nachrichten unter Synchronisationspunktsteuerung gesendet werden.
Der JMS-Provider kann zusätzliche JAR-Dateien bereitstellen, die zur Transaktionsunterstützung erforderlich sind. Lesen Sie hierzu die Dokumentation des JMS-Providers. Auf verteilten Systemen stellt der JMS-Provider von WebSphere MQ eine zusätzliche JAR-Datei, com.ibm,mqetclient.jar, zur Verfügung, die ebenfalls zum Brokerverzeichnis 'shared_classes' hinzugefügt werden muss. Weitere Informationen finden Sie in diesem Abschnitt unter Client des JMS-Providers für JMS-Knoten verfügbar machen.
Installationsverzeichnis/bin/ JMSSwitch.dll XAOpenString=Ausgangskontext, JNDI-Position, Optionale Parameter ThreadOfControl=THREAD
XAResourceManager: Name=Name_des_JMS-Providers SwitchFile=/Installationsverzeichnis/bin/ JMSSwitch.so XAOpenString=Ausgangskontext, JNDI-Position, Optionale Parameter ThreadOfControl=THREADDabei gilt:
Der Name_des_JMS-Providers ist ein bei der Installation definierter Name, der einen Ressourcenmanager des JMS-Providers identifiziert.
SwitchFile ist der Dateisystempfad zur JMSSwitch-Bibliothek, der im Brokerverzeichnis bin angegeben wird.
Die optionalen Parameter werden durch Kommas getrennt und sind positionsgebunden. Aus diesem Grund müssen fehlende Parameter durch ein Komma dargestellt werden.
<Brokerinstallationspfad>/classes/xarecovery.jar
<Brokerinstallationspfad>/bin
XA kann bis WebSphere MQ Version 5.3, CSD12 und WebSphere MQ Version 6.0 Fixpack 1 nicht den gleichen WS-Manager für den Broker und den Provider verwenden.
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.
In der nachfolgenden Tabelle werden die Terminals des JMSSendeknotens beschrieben.
Terminal | Beschreibung |
---|---|
Fehlerterminal | Das Ausgabeterminal, an das die Nachricht weitergeleitet wird, wenn ein Fehler auftritt. Auch wenn die Eigenschaft 'Auswertung' angegeben ist, werden an dieses Terminal weitergegebene Nachrichten nicht ausgewertet. |
Out | 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 der nachfolgenden Tabelle werden die Knoteneigenschaften beschrieben. Die Spalte M zeigt an, ob die Eigenschaft obligatorisch ist (markiert mit einem Sternchen im Eigenschaftendialog, ob Sie einen Wert eingeben müssen, wenn kein Standardwert definiert ist). Die Spalte C zeigt an, ob die Eigenschaft konfigurierbar ist (Sie können den Wert ändern, wenn Sie der BAR-Datei den Nachrichtenfluss hinzufügen, um ihn einzusetzen).
In der nachfolgenden Tabelle werden die Basiseigenschaften des JMSSendeknotens beschrieben.
Eigenschaft | M | C | Standardwert | Beschreibung |
---|---|---|---|---|
Ausgangskontext-Factory | Ja | com.sun.jndi.fscontext.RefFSContextFactory | Dies ist der Ausgangspunkt für einen JNDI-Namensbereich. Eine JMS-Anwendung verwendet den Ausgangskontext, um die Verbindungsfactory sowie Warteschlangen oder Themenobjekte für den JMS-Provider abzurufen und zu suchen. Der Standardwert entspricht dem Wert, der verwendet wird, wenn WebSphere MQ Java als JMS-Provider eingesetzt wird. |
|
Position der JNDI-Bindungen | Nein | Der Systempfad oder die LDAP-Position für die Bindungsdatei. | ||
Name der Verbindungsfactory | Nein | Der Name der Verbindungsfactory, der vom JMSSendeknoten für die Erstellung einer Verbindung zum JMS-Provider verwendet wird. |
In der nachfolgenden Tabelle werden die Publish/Subscribe-Eigenschaften des JMSSendeknotens beschrieben.
Eigenschaft | M | C | Standardwert | Beschreibung |
---|---|---|---|---|
Publisher-Thema | Nein | Der Name des Themas, zu dem der Knoten veröffentlichte Nachrichten empfängt. |
In der nachfolgenden Tabelle werden die Punkt-zu-Punkt-Eigenschaften des JMSSendeknotens beschrieben.
Eigenschaft | M | C | Standardwert | Beschreibung |
---|---|---|---|---|
Zielwarteschlange | Nein | Der Name der Warteschlange, in der der Knoten abgehende Nachrichten veröffentlicht. |
In der nachfolgenden Tabelle werden die Anforderungseigenschaften des JMSSendeknotens beschrieben.
Eigenschaft | M | C | Standardwert | Beschreibung |
---|---|---|---|---|
Zielmodus | Nein | Bestimmungsname | Diese Eigenschaft gibt an, ob die Nachricht als Anforderung eines Datagramms oder als Antwort behandelt werden soll. | |
Zieladresse für Antwortnachrichten | Nein | Dieser Wert ist der Name der JMS-Zieladresse, an die die empfangende Anwendung als Antwortnachricht gesendet werden sollte. 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. |
In der nachfolgenden Tabelle werden die erweiterten Eigenschaften des JMSSendeknotens beschrieben.
Eigenschaft | M | C | Standardwert | Beschreibung |
---|---|---|---|---|
Neue Korrelations-ID | Nein | Diese Eigenschaft ist ausgewählt, wenn eine Neue Korrelations-ID erforderlich ist. | ||
Transaktionsmodus | Ja | Nein | Keine | Diese Eigenschaft gibt an, ob die ankommende Nachricht unter Synchronisationspunktsteuerung empfangen wird. Gültige Werte sind Keine, local und Global. |
Zustellmodus | Nein | Nicht permanent | Nachrichtenselektor, der Nachrichten gemäß dem Nachrichtenübermittlungsmodus filtern wird. | |
Nachrichtenablauf | Nein | 0 | Mit diesem Eigenschaftenwert wird angefordert, dass der JMS-Provider die JMS-Ausgabenachricht für eine bestimmte Zeit aufbewahrt. Die Werte werden in Millisekunden angegeben, und der Standardwert 0 zeigt an, dass die Nachricht nicht ablaufen darf. |
|
Nachrichtenpriorität | Nein | 4 | Durch diesen Eigenschaftenwert wird der Nachricht eine relative Bedeutung zugewiesen. Dieser Wert kann von einer empfangenden JMS-Clientanwendung oder einem JMSSendeknoten für die Nachrichtenauswahl verwendet werden. |
In der nachfolgenden Tabelle werden die Auswertungseigenschaften des JMSSendeknotens beschrieben.
Der Abschnitt Eigenschaften der Gültigkeitsprüfung für Nachrichten in der MRM-Domäne enthält eine ausführliche Beschreibung dieser Eigenschaften.Eigenschaft | M | C | Standardwert | Beschreibung |
---|---|---|---|---|
Auswerten | Ja | Ja | Keine | Durch diese Eigenschaft wird angegeben, ob eine Auswertung stattfindet. Gültige Werte sind Keine,Inhalt und Inhalt und Wert. |
Aktion bei Fehler | Ja | Nein | Ausnahme | Durch diese Eigenschaft wird angegeben, was beim Fehlschlagen der Auswertung geschieht. Diese Eigenschaft kann nur festgelegt werden, wenn Auswerten auf Inhalt oder Inhalt und Wert gesetzt wird. Gültige Werte sind Benutzertrace, Lokales Fehlerprotokoll, Ausnahmebedingung und Ausnahmeliste. |
Alle Wertvorgaben einschließen | Ja | Nein | Ausgewählt | Diese Eigenschaft kann nicht bearbeitet werden. Die Standardaktion (ausgewähltes Markierungsfeld) besteht darin, dass in der Auswertung von Inhalt und Wert auch Basisprüfungen der Wertvorgaben ausgeführt werden. |
Korrektur | Ja | Nein | Keine | Diese Eigenschaft kann nicht bearbeitet werden. |
In der nachfolgenden Tabelle werden die Beschreibungseigenschaften des JMSSendeknotens beschrieben.
Eigenschaft | M | C | Standardwert | Beschreibung |
---|---|---|---|---|
Kurzbeschreibung | Nein | Nein | Kurze Beschreibung des Knotens | |
Ausführliche Beschreibung | Nein | Nein | Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt. |