Dieses Thema enthält folgende Abschnitte:
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 einschließen. Wenn Sie jedoch keinen JMSEmpfangsknoten einschließen, müssen Sie den MQJMSUmsetzungsknoten einschließen, 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 Plattformen 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\Application Data\IBM\MQSI\shared-classes. Dadurch wird sichergestellt, dass der Pfad der Java-Klasse für die JMS-Knoten richtig festgelegt ist.
Unter z/OS ist kein Verzeichnis 'shared-classes' vorhanden. Stattdessen müssen Sie jede Java-JAR-Datei des JMS-Providers im Klassenpfad des BIPPROF-Mitglieds der partitionierten Datei des Brokers angeben. Aktualisieren Sie anschließend LIBPATH mit beliebigen nativen Bibliotheken, und übergeben Sie den BIPGEN JCL-Job zur Aktualisierung des Brokers ENVFILE.
Wenn Sie eine Instanz des JMSSendeknotens in einen Nachrichtenfluss eingereiht haben, können Sie ihn konfigurieren. Klicken Sie in der Editoransicht mit der rechten Maustaste auf den Knoten, und klicken Sie auf Eigenschaften. Daraufhin werden die grundlegenden Eigenschaften des Knotens im Eigenschaftendialogfeld angezeigt.
Alle verbindlichen Eigenschaften, für die kein Standardwert definiert ist, sind im Eigenschaftendialog 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 detaillierte Informationen hierzu unter Nachrichten prüfen und Eigenschaften der Gültigkeitsprüfung für Nachrichten in der MRM-Domäne.
Klicken Sie auf Abbrechen, um das Dialogfeld 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 dieses Knotens 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 empfangen 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 Plattformen (keine z/OS-Plattformen) stellt der JMS-Provider von WebSphere MQ die zusätzliche JAR-Datei com.ibm,mqetclient.jar zur Verfügung. Diese JAR-Datei muss auch zum Verzeichnis 'shared_classes' des Brokers hinzugefügt werden. Weitere Informationen finden Sie in diesem Abschnitt unter Client des JMS-Providers für JMS-Knoten verfügbar machen.
<Brokerinstallationspfad>/bin/ JMSSwitch.dll XAOpenString=<Ausgangskontext >,<JNDI-Position>, <Optional> ThreadOfControl=THREAD
XAResourceManager: Name=<Name_JMS-Provider> SwitchFile=/<Pfad der Brokerinstallation>/bin/ JMSSwitch.so XAOpenString=<Ausgangskontext >,<JNDI-Position>, <Optional> ThreadOfControl=THREADDabei gilt:
Name 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 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 WS-Manager des Brokers 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. |
Catch | 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-Namespace. 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 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 | Automatisch | Diese Eigenschaft gibt an, ob die ankommende Nachricht unter Synchronisationspunktsteuerung empfangen wird. Gültige Werte sind Automatisch, Ja und Nein. |
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 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. |