JMSSendeknoten

Dieses Thema enthält folgende Abschnitte:

Zweck

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:

Symbol für JMSSendeknoten

Den JMSSendeknoten in einem Nachrichtenfluss verwenden

Das Beispiel Beispielprogramm 'JMS Nodes' enthält einen Nachrichtenfluss, in dem der JMSSendeknoten verwendet wird. Dieses Beispiel demonstriert die Verwendung des JMSSendeknotens.

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.

Client des JMS-Providers für JMS-Knoten verfügbar machen

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.

Unter z/OS ist kein Verzeichnis 'shared-classes' vorhanden. Gehen Sie stattdessen wie folgt vor:
  1. Geben Sie jede Java-.jar-Datei des JMS-Providers im Klassenpfad des BIPPROF-Mitglieds der partitionierten Datei des Brokers an.
  2. Aktualisieren Sie LIBPATH mit eventuell vorhandenen nativen Bibliotheken.
  3. Übergeben Sie den BIPGEN JCL-Job zur Aktualisierung des Brokers ENVFILE.
Beginn der Änderung

Nachrichtenzielmodus verwenden

Der JMSSendeknoten agiert als Nachrichtenproduzent und unterstützt die folgenden Nachrichtenszenarios:

Eine Datagrammnachricht senden

Ein Datagramm ist eine abgeschlossene, unabhängige Datenentität, die selbst genügend Informationen enthält, um vom Quellensystem zum Zielsystem geleitet zu werden, ohne dabei auf Informationen aus früheren Übertragungen zwischen den beiden Systemen oder auf Informationen des verwendeten Transportnetzes angewiesen zu sein. In den folgenden Anweisungen wird das Senden einer Datagrammnachricht beschrieben:
  1. Legen Sie im Ordner 'Anforderung' das Attribut Zielmodus für den Bestimmungsnamen fest.
  2. Legen Sie das Nachrichtenziel entsprechend dem verwendeten Nachrichtenmodell fest. Legen Sie für den gültigen Namen eines JNDI-verwalteten Objekts eines der folgenden Attribute fest:
    • Das Veröffentlichungsthema im Ordner 'Publish/Subscribe'.
    • Die Zielwarteschlange im Ordner 'Punkt zu Punkt'.
  3. Lassen Sie den Wert für das Attribut Reply To Destination (Antwort an Zieladresse) leer.
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.

Antwortnachricht senden

Es gibt Situationen, in denen der Nachrichtenproduzent vom Konsumenten eine Antwort auf seine Nachricht erhalten möchte. In diesem Fall kann die JMS-Ausgabenachricht die abgehende Nachricht als Antwort behandeln und entsprechend dem Wert weiterleiten, der von der Anforderungsnachricht für die Eigenschaft JMSReplyTo angegeben wurde. In den folgenden Anweisungen wird das Senden einer Antwortnachricht beschrieben:
  1. Legen Sie im Ordner 'Anforderung' das Attribut Zielmodus für Reply to Destination (Antwort an Zieladresse) fest.
  2. Sie können den Wert der Eigenschaft JMSReplyTo in MbMessage für Instanzen mit Hilfe eines Rechenknotens oder Java-Rechenknotens ändern. Dies ermöglicht das dynamische Routing von Nachrichten vom JMSSendeknoten aus.
Der Knoten sendet die Nachricht an den JMS-Bestimmungsnamen, der im Feld JMSReplyTo der MbMessage-Baumstruktur festgelegt wurde.
Dabei stellt der Wert für JMSReplyTo in der MbMessage-Baumstruktur den Namen der JMS-Zieladresse dar, der aus JNDI aufgelöst wurde. Beispiel:
queue://QM_mn2/meineJMSWarteschlange4
In 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.
Wenn Sie keinen aufgelösten Namen für die JMS-Zieladresse angeben möchten, kann der JMSSendeknoten auch den Namen eines JNDI-verwalteten Objekts im Feld JMSReplyTo akzeptieren. Es ist jedoch erforderlich, dass der Name des JNDI-verwalteten Objekts in JNDI aufgelöst wird, damit der Knoten die Nachricht an die zugrunde liegende JMS-Zieladresse weiterleiten kann. In diesem Fall muss der Wert im Feld JMSReplyTo die Zeichenfolge jndi:\\ als Präfix erhalten. Beispiel:
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.

Anforderungsnachricht senden

Der JMSSendeknoten kann eine Nachricht an die JMS-Zieladresse in der Erwartung senden, von dem Nachrichtenkonsumenten, der die Anforderung verarbeitet, eine Antwort zu erhalten. In den folgenden Anweisungen wird das Senden einer Anforderungsnachricht beschrieben:
  1. Legen Sie das Nachrichtenziel entsprechend dem verwendeten Nachrichtenmodell fest. Legen Sie für den gültigen Namen eines JNDI-verwalteten Objekts eines der folgenden Attribute fest:
    • Das Veröffentlichungsthema im Ordner 'Publish/Subscribe'.
    • Die Zielwarteschlange im Ordner 'Punkt zu Punkt'.
  2. Legen Sie im Ordner 'Anforderung' das Attribut Zielmodus für den Bestimmungsnamen fest.
  3. Die für 'JMSReplyTo' anzugebende Zieladresse in der abgehenden Nachricht kann aus dem an den Knoten übergebenen Wert ersehen werden, der im Feld JMSReplyTo der MbMessage-Baumstruktur angegeben wurde. Alternativ hierzu kann der Wert auch durch den Namen eines JNDI-verwalteten Objekts überschrieben werden, der mit dem Knotenattribut Reply To Destination (Antwort an Zieladresse) festgelegt wurde.

    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 sucht zuerst nach einem Wert im Feld JMSReplyTo von MbMessage. Wenn er den Wert findet, übergibt er ihn an das Feld JMSReplyTo der abgehenden Nachricht. Wenn jedoch ein Wert im Feld Reply To Name (Antwort an Namen) des Ordners 'Anforderung' definiert wurde, überschreibt dieser Wert nach Auflösung des Namens des JNDI-verwalteten Objekts alle Angaben, die zuvor für die Eigenschaft JMSReplyTo der abgehenden Nachricht gemacht wurden.

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.

Ende der Änderung

JMSSendeknoten konfigurieren

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:

  1. Wählen Sie Grundeinstellung im Navigator des Eigenschaftendialogs, und machen Sie alle Angaben für folgende Eigenschaften:
    • Geben Sie einen Wert für die Ausgangskontext-Factory ein. Eine JMS-Anwendung verwendet den Ausgangskontext, um die verwalteten JNDI-Attribute für den JMS-Provider abzurufen und zu suchen. Der Standardwert ist

      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.

    • Beginn der ÄnderungGeben 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 JMSSendeknoten verwendet werden.

      Wenn Sie einen Wert für die Position der JNDI-Bindungen eingeben, müssen Sie sicherstellen, dass er mit den folgenden Anweisungen kompatibel ist:

      • Erstellen Sie die Bindungsdatei vor der Implementierung eines Nachrichtenflusses, der einen JMSSendeknoten 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, müssen Sie sowohl den LDAP-Principal (Benutzer-ID) als auch die LDAP-Berechtigungsnachweise (Kennwort) separat konfigurieren. Diese Werte werden auf Brokerebene konfiguriert. Die Befehle mqsicreatebroker und mqsichangebroker enthalten Informationen zur Konfiguration dieser Werte.
      • Der Zeichenfolgewert sollte eines der folgenden führenden Schlüsselwörter als Vorzeichen enthalten: file:/ , iiop:/ oder ldap:/.

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

      Ende der Änderung
    • Geben Sie den Namen der Verbindungsfactory ein. Der Name der Verbindungsfactory wird vom JMSSendeknoten für die Erstellung einer Verbindung zum JMS-Provider verwendet. Dieser Name muss in der Bindungsdatei bereits vorhanden sein.
  2. Beginn der ÄnderungWenn der JMSSendeknoten für die Veröffentlichung eines Themas verwendet werden soll, wählen Sie im Navigator des Eigenschaftendialogs Pub/Sub aus.
    • Geben Sie den Namen des Publisher-Themas ein.
      • Wenn diese Eigenschaft konfiguriert ist, agiert der Knoten nur in der Publish/Subscribe-Nachrichtendomäne.
      • Diese Eigenschaft und die Eigenschaft Zielwarteschlange im Abschnitt mit den Punkt zu Punkt-Eigenschaften schließen sich gegenseitig aus.
      • Der Name des Publisher-Themas muss den Standards des JMS-Providers entsprechen, der vom Knoten verwendet wird.
    Ende der Änderung
  3. Wenn der JMSSendeknoten zum Senden von Punkt-zu-Punkt-Nachrichten verwendet werden soll, wählen Sie im Navigator des Eigenschaftendialogs Punkt-zu-Punkt aus.
    • Geben Sie für den Namen der JMS-Warteschlange den Namen der Zielwarteschlange ein, die in der Bindungsdatei aufgeführt wird.
  4. Wählen Sie Anforderung im Navigator des Eigenschaftendialogs, und machen Sie alle Angaben für folgende Eigenschaften:
    • Wählen Sie eine Option aus der Dropdown-Liste Zielmodus aus.
      • Der Standardwert lautet Bestimmungsname. Wenn dieser Wert ausgewählt ist, wird die Nachricht als Anforderung eines Datagramms behandelt, und sie richtet sich entweder an das Veröffentlichungsthema oder die Zielwarteschlange .
      • Wenn die Nachricht als Antwort bearbeitet werden soll, wählen Sie Bestimmungsname für Antwortnachrichten aus. Dem JMS-Provider wird der JMSReplyTo-Wert aus dem Abschnitt JMSTransport_Header_values der Nachrichtenbaumstruktur bereitgestellt.
    • Geben Sie für Zieladresse für Antwortnachrichten einen Wert ein. Sie können eine JMS-Zieladresse eingeben, bei der es sich um eine Subskriptionswarteschlange oder um ein Zielthema handeln kann. Die Zieladresse für Antwortnachrichten 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.

      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.

  5. Wählen Sie im Navigator des Eigenschaftendialogs Erweitert aus.
    • Wenn eine Neue Korrelations-ID erforderlich ist, wählen Sie das Markierungsfeld aus.
    • 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 mit Hilfe einer 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 die Rücksetzung der vom Knoten gesendeten JMS-Nachrichten zusammen mit anderen Ressourcen (z. B. DB2 oder WebSphere MQ), die die Arbeit 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 JMSSendeknoten an einer globalen Nachrichtenflusstransaktion teilnehmen soll, die vom externen Synchronisationspunkt-Koordinator des Brokers verwaltet wird. Beim Synchronisationspunkt-Koordinator handelt es sich auf verteilten Plattformen um den WS-Manager 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 der folgenden Optionen 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 zeigt, dass die Nachrichten beibehalten werden sollen, bis sie erfolgreich an eine empfangende JMS-Clientanwendung übermittelt werden.
    • Geben Sie für den Nachrichtenablauf einen Wert ein, um anzufordern, dass der JMS-Provider die JMS-Ausgabenachricht für eine bestimmte Zeit aufbewahrt.

      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.

    • 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 JMSSendeknoten für die Nachrichtenauswahl verwendet werden.

      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.

  6. Wählen Sie im Navigator des Eigenschaftendialogs Auswertung aus, um die Knoteneigenschaften festzulegen, die sich auf die Gültigkeitsprüfung von Ausgabenachrichten beziehen.
    • Wählen Sie aus der Dropdown-Liste Auswerten eine der folgenden Optionen aus:
      • Keine
      • Inhalt und Wert
      • Inhalt
      • Übernehmen
      Wenn Sie Inhalt und Wert oder Inhalt auswählen, müssen Sie aus der Dropdown-Liste außerdem eine Aktion bei Fehler auswählen:
      • Benutzertrace
      • Lokales Fehlerprotokoll
      • Ausnahmebedingung (Standardwert)
      • Ausnahmeliste

    Sie finden detailliertere Informationen hierzu unter Nachrichten überprüfen und Eigenschaften der Gültigkeitsprüfung für Nachrichten in der MRM-Domäne.

  7. Wählen Sie im Eigenschaftendialognavigator Beschreibung aus, um eine Kurzbeschreibung, eine ausführliche Beschreibung oder beides einzugeben.
  8. Klicken Sie auf Übernehmen, um die Änderungen am JMSSendeknoten vorzunehmen, ohne das Dialogfeld mit den Eigenschaften zu schließen. Klicken Sie auf OK, um die Änderungen zu übernehmen und das Dialogfeld mit den Eigenschaften zu schließen.

    Klicken Sie auf Abbrechen, um den Dialog zu schließen und alle Änderungen zu verwerfen, die Sie an den Eigenschaften vorgenommen haben.

Verbindungen zu Terminals herstellen

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.

Koordinierte Transaktionen konfigurieren

Beginn der Änderung

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.

  • Lautet der Wert für Transaktionsmodus global, wird die Nachricht unter externer Synchronisationspunktsteuerung, d. h. innerhalb einer WebSphere MQ-Arbeitseinheit gesendet. Alle Nachrichten, die nacheinander von einem Sendeknoten in derselben Instanz des Nachrichtenflusses gesendet wurden, werden unter Synchronisationspunktsteuerung gestellt, ausgenommen, der Sendeknoten hat dies explizit überschrieben.
  • Lautet der Wert für Transaktionsmodus lokal, wird die Nachricht unter der lokalen Synchronisationspunktsteuerung des JMSSendeknotens gesendet. Alle Nachrichten, die nacheinander von einem Sendeknoten im Nachrichtenfluss gesendet wurden, werden nicht unter die lokale Synchronisationspunktsteuerung (syncpoint-Bedingung) gestellt, es sei denn, ein einzelner Sendeknoten hat dies angegeben.
  • Lautet der Wert für Transaktionsmodus Keine, wird die Nachricht nicht unter Synchronisationspunktsteuerung gesendet. Jede abgeleitete Nachricht, die nachfolgend von einem Sendeknoten im Nachrichtenfluss gesendet wird, wird nicht unter dem Synchronisationspunkt eingereiht, es sei denn, ein einzelner Sendeknoten hat angegeben, dass die Nachricht unter dem Synchronisationspunkt eingereiht werden muss.

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.

Für den Empfang von Nachrichten unter einem externen Synchronisationspunkt sind zusätzliche Konfigurationsschritte erforderlich. Die folgenden Schritte gelten nur für die erste Implementierung eines JMSSende- oder JMSEmpfangsknoten auf dem Broker für einen bestimmten JMS-Provider:
  • Auf verteilten Systemen wird als externer Synchronisationspunkt-Koordinator für den Broker WebSphere MQ verwendet. Vor der Implementierung eines Nachrichtenflusses, bei dem die Transaktionskoordination auf global gesetzt ist, müssen Sie die .ini-Datei des WS-Managers so ändern, dass für jeden Ressourcenmanager des JMS-Providers, der an global koordinierten Transaktionen mitwirkt, zusätzliche Definitionen enthalten sind.
    • Unter Windows:
      • Wenn WebSphere MQ Version 5.0 installiert ist, starten Sie die WebSphere MQ-Services, und klicken Sie mit der rechten Maustaste auf den Namen des WS-Managers. Wählen Sie Eigenschaften aus, und klicken Sie auf die Registerkarte für die Ressourceneigenschaften.
      • Wenn WebSphere MQ Version 6.0 installiert ist, starten Sie den WebSphere MQ-Explorer, und klicken Sie im linken Teilfenster mit der rechten Maustaste auf den Namen des WS-Managers. Wählen Sie im linken Teilfenster nacheinander Eigenschaften und XA-Ressourcenmanager aus. Weitere Informationen finden Sie im Handbuch WebSphere MQ System Administration Guide.
        Legen Sie für die Eigenschaft SwitchFile den folgenden Wert fest:
        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 zu der .ini-Datei des WS-Managers hinzu. Weitere Informationen finden Sie im Handbuch WebSphere MQ System Administration Guide.
      Beispiel:
      XAResourceManager:  
      Name=Name_des_JMS-Providers
      SwitchFile=/Installationsverzeichnis/bin/ JMSSwitch.so
      XAOpenString=Ausgangskontext, JNDI-Position, Optionale Parameter
      ThreadOfControl=THREAD
      Dabei 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.

      Für XAOpenString gelten folgende Werte:
      • Ausgangskontext ist der Wert, der in der Basiseigenschaft Ausgangskontextfactory des JMSEmpfangsknotens festgelegt wurde.
      • JNDI-Position ist der Wert, der in der Basiseigenschaft JNDI-Position des JMSEmpfangsknotens festgelegt wurde. Dieser Wert sollte eines der führenden Schlüsselwörter file:/, iiop:/ oder ldap:/ als Vorzeichen enthalten.
      Die folgenden Parameter sind optional:
      • LDAP-Principal; dieser entspricht dem Wert, der mit den Befehlen mqsicreatebroker oder mqsichangebroker für den Broker festgelegt wurde.
      • LDAP-Berechtigungsnachweise; entspricht dem Wert, der mit den Befehlen mqsicreatebroker oder mqsichangebroker für den Broker festgelegt wurde.
      • Name der Wiederherstellungs-Verbindungsfactory; entspricht der JNDI-verwalteten Verbindungsfactory, die in der Bindungsdatei definiert ist. Wenn kein Wert angegeben wird, muss den JNDI-Bindungen ein Standardwert für recoverXAQCF hinzugefügt werden. In jedem Fall sollte die Wiederherstellungs-Verbindungsfactory für den JMS-Provider, der der Ausgangskontext-Factory zugeordnet ist, als eine XA-Warteschlangenverbindungsfactory definiert werden.

      Die optionalen Parameter werden durch Kommas getrennt und sind positionsgebunden. Aus diesem Grund müssen fehlende Parameter durch ein Komma dargestellt werden.

      1. Aktualisieren Sie die Java-Umgebungsvariable CLASSPATH für den WS-Manager des Brokers, indem Sie einen Verweis auf die Datei xarecovery.jar einfügen. Beispiel:
        <Brokerinstallationspfad>/classes/xarecovery.jar
      2. Aktualisieren Sie die Java-Umgebungsvariable PATH für den WS-Manager des Brokers so, dass sie auf das Verzeichnis 'bin' verweist, in dem sich die Switch-Datei befindet. Beispiel:
        <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.

    • 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 (Bind) ist die einzige Transport-Option, 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.

Ende der Änderung

Terminals und Eigenschaften

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.
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
ac24830_