JMSInput-Knoten

Mit dem JMSInput-Knoten können Sie Nachrichten von JMS-Zieladressen empfangen. Der Zugriff auf JMS-Zieladressen erfolgt über eine Verbindung zu einem JMS-Provider.

Dieses Thema enthält folgende Abschnitte:

Zweck

Der JMSInput-Knoten agiert als JMS-Nachrichtenkonsument und kann alle sechs Nachrichtentypen empfangen, die in der Java Message Service Specification, Version 1.1 definiert sind. Nachrichten werden mit Hilfe von Methodenaufrufen empfangen, die in der JMS-Spezifikation beschrieben sind.

Der JMSInput-Knoten befindet sich im Ablagefach JMS der Palette und wird in der Workbench durch folgendes Symbol dargestellt:

Symbol für JMSEmpfangsknoten

JMSInput-Knoten in einem Nachrichtenfluss verwenden

Das folgende Beispiel enthält einen Nachrichtenfluss, in dem der JMSInput-Knoten verwendet wird. Anhand dieses Beispiels wird die Verwendung des JMSInput-Knotens demonstriert. Sie können Beispiele nur anzeigen, wenn Sie das Information Center verwenden, das im Message Broker Toolkit integriert ist.

Der JMSInput-Knoten empfängt Nachrichten mit einer JMS-Nachrichtenbaumstruktur und gibt diese weiter. Sie können die Eigenschaften des JMSInput-Knotens festlegen, um die Methode zum Empfangen der JMS-Nachrichten zu steuern.

Der JMSInput-Knoten bearbeitet Nachrichten in den folgenden Nachrichtendomänen:
  • BLOB
  • XMLNSC
  • XMLNS
  • MRM
  • JMSMap
  • JMSStream
  • MIME
  • IDOC (diese Domäne wird nicht weiter unterstützt; verwenden Sie MRM)
  • XML (diese Domäne wird nicht weiter unterstützt; verwenden Sie XMLNSC)

Nachrichtenflüsse, die Nachrichten handhaben, die von Verbindungen mit JMS-Providern empfangen werden, müssen immer mit einem JMSInput-Knoten beginnen. Sie können jeden der unterstützten Sendeknoten (einschließlich benutzerdefinierter Sendeknoten) in einen Nachrichtenfluss aufnehmen, der mit einem JMSInput-Knoten beginnt; es muss sich hierbei nicht um einen JMSOutput-Knoten handeln. Wenn Sie jedoch keinen JMSOutput-Knoten einschließen, müssen Sie den JMSMQTransform-Knoten einschließen, um die Nachricht in das Format umzuwandeln, das vom Sendeknoten erwartet wird.

Wenn Sie JMS-Nachrichten weitergeben und einen Nachrichtenfluss entsprechend erstellen, dass er einen untergeordneten Fluss verwendet, können Sie keinen Standardsendeknoten verwenden, sondern müssen eine Instanz des JMSInput-Knotens als ersten Knoten nehmen, um ein Eingangsterminal für den untergeordneten Fluss zu erstellen.

Einschränkung: Wenn der JMSInput-Knoten Veröffentlichungsthemen empfängt, beschränkt er die Nachrichtenflusseigenschaft Zusätzliche Instanzen intern auf null, um den Empfang von doppelten Veröffentlichungen zu verhindern.

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

Konfigurierbare Services sind für eine Reihe von JMS-Providern definiert. Sie können einen der vordefinierten Services auswählen oder einen neuen Service für einen neuen Provider oder einen vorhandenen Provider erstellen. Die vordefinierten Services sind unter Konfigurierbare Services aufgeführt.

  • Wenn Sie den WebSphere MQ-JMS-Provider verwenden möchten und WebSphere MQ an der Standardposition im Brokersystem installiert haben, sind die Eigenschaften bereits gesetzt, und Sie müssen keine Änderungen vornehmen.
  • Wenn Sie den WebSphere MQ-JMS-Provider verwenden möchten und WebSphere MQ nicht an der Standardposition installiert haben oder Sie einen der anderen definierten Services verwenden möchten, müssen Sie die Eigenschaft jarsURL setzen, um die Position der JAR-Dateien des Service im Brokersystem zu identifizieren.

    Mit dem Befehl mqsireportproperties können Sie die Providereigenschaften anzeigen. Mit dem Befehl mqsichangeproperties können Sie die Eigenschaften festlegen oder modifizieren.

  • Wenn kein Service für Ihren JMS-Provider definiert ist oder wenn Sie einen anderen Service für einen vorhandenen JMS-Provider erstellen möchten, verwenden Sie den Befehl mqsicreateconfigurableservice zur Identifikation des neuen Service und zum Setzen der entsprechenden Eigenschaften.
  • Wählen Sie bei der Konfiguration des Knotens den entsprechenden Service in der Liste der vordefinierten Services aus, die für die Eigenschaft Name des JMS-Providers angezeigt werden, oder geben Sie den Namen des neuen Service an.

JMSInput-Knoten konfigurieren

Nachdem Sie eine Instanz des JMSInput-Knotens in einen Nachrichtenfluss eingereiht haben, können Sie ihn 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.

  1. Optional: Geben Sie auf der Registerkarte Beschreibung eine Kurzbeschreibung und/oder eine Ausführliche Beschreibung ein. Sie können den Knoten dort auch umbenennen.
  2. Wählen Sie den Modus für den JMSInput-Knoten auf der Registerkarte Grundeinstellungen aus. Der JMSInput-Knoten verfügt über drei Modi, von denen sich zwei gegenseitig ausschließen, Quellenwarteschlange und Subskriptionsthema.
    • Wenn der Knoten Daten aus einer Warteschlange lesen soll (Punkt-zu-Punkt), wählen Sie Quellenwarteschlange aus, und geben Sie den Namen der Quellenwarteschlange ein. Hierbei handelt es sich um die in der JMS-Bindungsdatei aufgeführte JMS-Warteschlange. Diese Eigenschaft und die Eigenschaft Subskriptionsthema schließen sich gegenseitig aus.
    • Wenn der Knoten Lesevorgänge für ein Subskriptionsthema durchführen soll (Publish/Subscribe), wählen Sie Subskriptionsthema aus, und geben Sie den Namen des Subskriptionsthemas ein.
      • Bei Auswahl von Subskriptionsthema funktioniert der Knoten nur in der Publish/Subscribe-Nachrichtendomäne.
      • Diese Eigenschaft und die Eigenschaft Quellenwarteschlange schließen sich gegenseitig aus.
      • Der Name des Subskriptionsthemas muss den Standards des vom Knoten verwendeten JMS-Providers entsprechen.
    • Geben Sie eine ID der permanenten Subskription ein, wenn der Knoten Veröffentlichungen zu einem permanenten Subskriptionsthema empfangen soll.
      • Das Entfernen einer permanenten Subskription ist eine separate Verwaltungsaufgabe. Informationen zum Entfernen einer permanenten Subskription finden Sie in der Dokumentation des JMS-Providers.
      • Diese Eigenschaft ist nur gültig, wenn eine Zeichenfolge Subskriptionsthema angegeben wurde.
  3. Legen Sie auf der Registerkarte JMS-Verbindung die folgenden Eigenschaften fest:
    • Wählen Sie in der Liste der vordefinierten Services einen Namen des JMS-Providers aus, oder geben Sie einen Namen eines benutzerdefinierten Service an. Der Standardwert lautet WebSphere MQ. Der Name muss dem Namen eines konfigurierbaren Service entsprechen, der für den Broker, für den Sie den Nachrichtenfluss implementieren, definiert ist.
    • Wenn Sie in der Liste Name des JMS-Providers einen Namen auswählen, wird die Eigenschaft Ausgangskontext-Factory automatisch mit der entsprechenden Java-Klasse aktualisiert. Wenn Sie einen eigenen Namen des JMS-Providers eingeben, müssen Sie auch einen Wert für die 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 JMSInput-Knoten verwendet werden.

      Wenn Sie einen Wert für Wo die JNDI-Bindungen liegen eingeben, sind dabei folgende Anweisungen einzuhalten:

      • Erstellen Sie die Bindungsdatei vor der Implementierung eines Nachrichtenflusses, der einen JMSInput-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 den LDAP-Principal (Benutzer-ID) und die LDAP-Berechtigungsnachweise (Kennwort) separat. Diese Werte werden auf Brokerebene konfiguriert. Informationen zur Konfiguration dieser Werte finden Sie in den Abschnitten Befehl 'mqsicreatebroker' und Befehl 'mqsichangebroker'.
      • Der Zeichenfolgewert muss eines der folgenden führenden Schlüsselwörter als Vorzeichen enthalten:
        • file:/
        • iiop:/
        • ldap:/

      Informationen zum Erstellen der Bindungsdatei für verwaltete JNDI-Objekte finden Sie in der Dokumentation des JMS-Providers.

    • Geben Sie den Namen der Verbindungsfactory ein. Der Verbindungsfactory-Name wird vom JMSInput-Knoten zum Erstellen einer Verbindung zum JMS-Provider verwendet. Dieser Name muss in der Bindungsdatei bereits vorhanden sein. Der Verbindungsfactory-Name kann der Name einer JMS-Warteschlangenverbindungsfactory oder einer JMS-Themaverbindungsfactory sein, er muss jedoch mit dem Nachrichtenmodell übereinstimmen, das vom Knoten verwendet wird. Alternativ dazu können Sie die generische JMS-Verbindungsfactory angeben, die für JMS-Warteschlangenziele oder für JMS-Themaziele verwendet werden kann.
    • Geben Sie einen Namen für das Rücksetzziel ein. Wenn der Nachrichtenfluss auf Grund von Fehlern die Nachricht nicht verarbeiten kann, werden Eingabenachrichten an diese Zieladresse gesendet, und die Nachricht muss aus dem Eingabeziel entfernt werden. Der Name des Rücksetzungsziels muss in der Bindungsdatei enthalten sein.
    • Geben Sie einen Wert für den Rücksetzschwellenwert ein. Durch diesen Wert wird festgelegt, wann eine Eingabenachricht an das Rücksetzziel übergeben wird. Wenn der Wert beispielsweise 3 lautet, versucht der JMS-Provider drei Mal, die Nachricht an die Eingabezieladresse zuzustellen. Nach dem dritten Zustellungsversuch wird die Nachricht aus der Eingabezieladresse entfernt und an das Rücksetzziel gesendet. Der Standardwert lautet 0.
  4. Legen Sie auf der Registerkarte Syntaxanalyse der Eingabenachricht Werte für die Eigenschaften zur Beschreibung der Nachrichtendomäne, der Nachrichtengruppe, des Nachrichtentyps und des Nachrichtenformats fest.
    • Wählen Sie aus der Liste unter Nachrichtendomäne den Namen des von Ihnen verwendeten Parsers aus. Folgende Optionen stehen zur Auswahl:
      • BLOB
      • XMLNSC
      • XMLNS
      • MRM
      • JMSMap
      • JMSStream
      • MIME
      • IDOC (diese Domäne wird nicht weiter unterstützt; verwenden Sie MRM)
      • XML (diese Domäne wird nicht weiter unterstützt; verwenden Sie XMLNSC)
      Die für den Knoten definierte Nachrichtendomäne hat Vorrang. Dies gilt nicht, wenn für die Knoteneigenschaft Nachrichtendomäne kein Wert angegeben ist. Ist für die Nachrichtendomäne kein Wert angegeben, kann der JMSInput-Knoten die Nachrichtendomäne auf eine der beiden folgenden Arten bestimmen:
      • Durch Überprüfung, ob im Wert des JMSType-Headers der JMS-Eingabenachricht Daten vorhanden sind
      • Auf Grundlage der Java-Klasse der JMS-Nachricht
      Weitere Informationen zur Ausführungspriorität bei der Bestimmung der Nachrichtendomäne finden Sie unter Ausführungspriorität zur Ableitung der Nachrichtendomäne.
    • Wählen Sie bei Verwendung des MRM- oder IDOC-Parsers oder des XMLNSC-Parsers im Prüfungsmodus die zu verwendende Nachrichtengruppe aus. Wenn Sie für die Nachrichtendomäne MRM, XMLNSC oder IDOC auswählen, wird diese Liste mit den verfügbaren Nachrichtengruppen aufgefüllt.
    • Wählen Sie bei Verwendung des MRM-Parsers in der Liste unter Nachrichtentyp die gewünschte Nachricht aus. In dieser Liste werden die Nachrichten aufgeführt, die in der ausgewählten Nachrichtengruppe definiert sind.
    • Wählen Sie bei Verwendung des MRM- oder IDOC-Parsers in der Liste unter Nachrichtenformat das gewünschte Format aus. Diese Liste enthält alle physischen Formate, die Sie für diese Nachrichtengruppe definiert haben.
  5. Auf der untergeordneten Registerkarte Parser-Optionen gilt Folgendes:
    1. Die Option Zeitpunkt für Syntaxanalyse ist standardmäßig auf Bei Bedarf gesetzt. Dies führt dazu, dass die Syntaxanalyse der Nachricht verzögert wird. Der Abschnitt Bedarfsgerechte Syntaxanalyse enthält Informationen zur sofortigen Analyse von Nachrichten.
    2. Legen Sie bei Verwendung des XMLNSC-Parsers Werte für die Eigenschaften fest, die die Funktionsweise des XMLNSC-Parsers bestimmen. Der Abschnitt Nachrichten in der XMLNSC-Domäne bearbeiten enthält weitere Informationen hierzu.
  6. Legen Sie auf der Registerkarte Nachrichtenselektoren folgende Eigenschaften fest, falls Nachrichten gefiltert werden müssen:
    • Wenn der JMS-Provider Nachrichten auf der Grundlage der von der initiierenden JMS-Clientanwendung festgelegten Nachrichteneigenschaften filtern soll, geben Sie für die Anwendungseigenschaft einen Wert ein, durch den sowohl der Eigenschaftsname als auch die Auswahlbedingungen angegeben werden (z. B. OrderValue > 200).

      Geben Sie für die Anwendungseigenschaft keinen Wert ein, wenn der Empfangsknoten keine Auswahl auf der Grundlage der Anwendungseigenschaft treffen soll. Eine Beschreibung zur Erstellung des JMS-Nachrichtenselektors finden Sie unter JMS-Nachrichtenselektor.

    • Wenn der JMS-Provider Nachricht filtern soll, die zu bestimmten Zeitpunkten generiert wurden, geben Sie für Zeitmarke einen Wert ein. Bei diesem Wert muss es sich um einen nicht näher bestimmten Java-Wert im Millisekunden handeln, z. B. 105757642321. Qualifizieren Sie den Selektor durch Operatoren, z. B. BETWEEN oder AND.

      Geben Sie für Zeitmarke keinen Wert an, wenn der Empfangsknoten keine Auswahl auf der Grundlage der JMS-Zeitmarke (JMSTimeStamp) treffen soll.

    • Wenn der JMS-Provider Nachrichten auf der Grundlage des JMSDeliveryMode-Headerwerts in den JMS-Nachrichten filtern soll, wählen Sie in der Liste eine Option für den Zustellmodus aus:
      • Nicht persistent, wenn nur Nachrichten empfangen werden sollen, die von der initiierenden JMS-Clientanwendung als nicht persistent markiert wurden.
      • Persistent, wenn nur Nachrichten empfangen werden sollen, die von der initiierenden JMS-Clientanwendung als persistent markiert wurden.
      • Alle, wenn persistente und nicht persistente Nachrichten empfangen werden sollen. Der Standardwert.
    • Wenn der JMS-Provider Nachrichten auf Basis des Headerwerts 'JMSPriority' in der JMS-Nachricht filtern soll, geben Sie für Priorität einen Wert ein.

      Gültige Werte für die Priorität reichen von 0 (niedrigste Priorität) bis 9 (höchste Priorität). Beispiele: Sie können 5 eingeben, um Nachrichten mit der Priorität 5 zu empfangen. Sie können den Selektor auch qualifizieren: Geben Sie beispielsweise > 4 ein, um Nachrichten mit einer höheren Priorität als 4 zu empfangen oder BETWEEN 4 AND 8, um Nachrichten mit einer Priorität im Bereich 4 bis 8 zu empfangen.

      Machen Sie im Feld Priorität keine Angabe, wenn der Empfangsknoten keine Auswahl auf der Grundlage der JMS-Priorität (JMSPriority) treffen soll.

    • Wenn der JMS-Provider Nachrichten auf Basis des Headerwerts 'JMSMessageID' filtern soll, geben Sie für Nachrichten-ID einen Wert ein.

      Geben Sie eine bestimmte Nachrichten-ID oder einen Bedingungsselektor ein, z. B. > WMBRK123456, damit Nachrichten zurückgegeben werden, deren Nachrichten-ID größer als WMBRK123456 ist.

      Machen Sie im Feld Nachrichten-ID keine Angabe, wenn der Empfangsknoten keine Auswahl auf der Grundlage der JMS-Nachrichten-ID (JMSMessageID) treffen soll.

    • Wenn der JMS-Provider Nachrichten auf Basis des Headerwerts 'JMSRedelivered' filtern soll, geben Sie für Erneut zugestellt einen Wert ein:
      • Geben Sie FALSE ein, wenn der Empfangsknoten nur Nachrichten akzeptieren soll, die vom JMS-Provider noch nicht zugestellt wurden.
      • Geben Sie TRUE ein, wenn der Empfangsknoten nur Nachrichten akzeptieren soll, die vom JMS-Provider bereits zugestellt wurden.
      • Machen Sie im Feld Erneut zugestellt keine Angabe, wenn der Empfangsknoten keine Auswahl auf der Grundlage von 'JMSRedelivered' treffen soll.
    • Wenn der JMS-Provider Nachrichten auf Basis des Headerwerts 'JMSCorrelationID' filtern soll, geben Sie für Korrelations-ID einen Wert ein.

      Geben Sie eine bestimmte Korrelations-ID oder eine Bedingungszeichenfolge ein. So werden beispielsweise bei Eingabe von WMBRKABCDEFG Nachrichten zurückgegeben, deren Korrelations-ID mit diesem Wert übereinstimmt.

      Machen Sie im Feld Korrelations-ID keine Angabe, wenn der Empfangsknoten keine Auswahl auf der Grundlage der JMS-Korrelations-ID (JMSCorrelationID) treffen soll.

  7. Legen Sie auf der Registerkarte Erweitert die Transaktionsmerkmale für die Handhabung der Nachricht fest. Treffen Sie hierfür in der Liste Transaktionsmodus eine Auswahl. Wählen Sie eine der folgenden Optionen aus:
    • Wählen Sie Keine aus, wenn die eingehende Nachricht als nicht persistent behandelt werden soll. Wenn Sie diesen Wert auswählen, wird die Nachricht über eine JMS-Sitzung ohne Transaktionsunterstützung empfangen, die mit Hilfe des Attributs Session.AUTO_ACKNOWLEDGE erstellt wird.
    • Wählen Sie Lokal aus, wenn der JMSInput-Knoten die Festschreibung oder Rücksetzung der vom Knoten empfangenen JMS-Nachrichten zusammen mit anderen Ressourcen (z. B. DB2 oder WebSphere MQ), die Arbeiten im Nachrichtenfluss ausführen, koordinieren muss. Wenn Sie diesen Wert auswählen, verwendet der Knoten eine JMS-Sitzung mit Transaktionsunterstützung.
    • Wählen Sie Global aus, wenn der JMSInput-Knoten an einer globalen Nachrichtenflusstransaktion teilnehmen muss, 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.
  8. Legen sie auf der Registerkarte Auswertung die Eigenschaften für die Auswertung der Eingabenachricht fest.

    Weitere Informationen finden Sie unter Nachrichten überprüfen und Auswertungseigenschaften.

Verbindungen zu Terminals herstellen

Jede erfolgreich empfangene Nachricht wird vom JMSInput-Knoten an das Ausgangsterminal weitergeleitet. Schlägt die Weiterleitung fehl, wird die Nachricht erneut weitergeleitet. Falls der Schwellenwert für die Wiederholung an dem Punkt erreicht wird, an dem der Schwellenwert durch die Eigenschaft Rücksetzschwellenwert des Knotens definiert ist, wird die Nachricht an das Fehlerterminal weitergeleitet. Sie können das Fehlerterminal mit Knoten verbinden, um diese Bedingung zu handhaben.

Wenn eine Ausnahmebedingung im Fehlerpfad auftritt, wird der Pfad so lange wiederholt, bis die Anzahl der Versuche den Wert Rücksetzschwellenwert um das Zweifache übersteigt. Wenn dieser Grenzwert überschritten wird, wird die Nachricht an das Rücksetzziel übergeben.

Wenn Sie keine Knoten mit dem Fehlerterminal verbunden haben, wird die Nachricht in das Rücksetzziel geschrieben. Wurde kein Rücksetzziel angegeben, gibt der Knoten die Fehlernachricht BIP4669 aus und stoppt die Verarbeitung weiterer eingehender Nachrichten.

Wenn die Nachricht vom JMSInput-Knoten abgefangen wird, nachdem eine Ausnahmebedingung an einer anderen Stelle im Fluss generiert wurde, wird die Nachricht an das Catch-Terminal weitergeleitet. Wenn keine Knoten mit dem Catch-Terminal verbunden wurden, setzt der Knoten die Nachricht für eine erneute Zustellung solange zurück, bis das Problem behoben ist oder der Rücksetzschwellenwert erreicht wird. Wird kein Rücksetzziel definiert, gibt der Knoten die Fehlernachricht BIP4669 aus und stoppt die Verarbeitung weiterer eingehender Nachrichten.

Koordinierte Transaktionen konfigurieren

Wenn Sie einen JMSInput-Knoten in einen Nachrichtenfluss aufnehmen, wird über den für den Transaktionsmodus festgelegten Wert definiert, ob Nachrichten unter Verwendung eines Synchronisationspunktes empfangen werden.

  • Wenn Sie diese Eigenschaft auf Global setzen, wird die Nachricht unter der externen Synchronisationspunktsteuerung empfangen, d. h. in einer WebSphere MQ-Arbeitseinheit. Alle Nachrichten, die später von einem Sendeknoten in derselben Instanz des Nachrichtenflusses gesendet werden, unterliegen der Synchronisationspunktsteuerung, es sei denn, der Sendeknoten setzt diese Einstellung explizit außer Kraft.
  • Wenn Sie diese Eigenschaft auf Lokal setzen, wird die Nachricht unter der lokalen Synchronisationspunktsteuerung des JMSInput-Knotens empfangen. Alle Nachrichten, die später von einem Sendeknoten im Nachrichtenfluss gesendet werden, unterliegen nicht der lokalen Synchronisationspunktsteuerung, es sei denn, ein einzelner Sendeknoten hat dies explizit vorgegeben.
  • Wird der Wert für diese Eigenschaft auf Keine gesetzt, unterliegt der Empfang der Nachricht nicht der Synchronisationspunktsteuerung. Alle Nachrichten, die später von einem Sendeknoten im Nachrichtenfluss gesendet werden, unterliegen nicht der Synchronisationspunktsteuerung, es sei denn, ein einzelner Sendeknoten hat dies explizit vorgegeben.
Für den Empfang von Nachrichten unter einer externen Synchronisationspunktsteuerung müssen Sie zusätzliche Konfigurationsschritte ausführen, die nur erforderlich sind, wenn ein JMSOutput- oder JMSInput-Knoten zum ersten Mal für einen bestimmten JMS-Provider auf dem Broker eingesetzt wird.
  • Auf verteilten Systemen wird als externer Synchronisationspunkt-Koordinator für den Broker WebSphere MQ verwendet. Vor der Implementierung eines Nachrichtenflusses, bei dem die Eigenschaft Transaktionsmodus auf Global gesetzt ist, müssen Sie die .ini-Datei des WS-Managers so ändern, dass darin für jeden Ressourcenmanager des JMS-Providers, der an global koordinierten Transaktionen mitwirkt, zusätzliche Definitionen enthalten sind.
    • Windows platform Unter Windows:
      1. Starten Sie den WebSphere MQ-Explorer.
      2. Klicken Sie im linken Teilfenster mit der rechten Maustaste auf den Namen des Warteschlangenmanagers, und klicken Sie auf Eigenschaften.
      3. Klicken Sie im linken Teilfenster auf XA-Ressourcenmanager.
      4. Legen Sie für die Eigenschaft SwitchFile den folgenden Wert fest:
        Installationsverzeichnis/bin/ JMSSwitch.dll 
        XAOpenString=Ausgangskontext, JNDI-Position, Optionale Parameter
        ThreadOfControl=THREAD 
      Weitere Informationen finden Sie im Bereich 'System Administration Guide' von WebSphere MQ Version 6 Information Center online.
    • Linux platform UNIX platform Fügen Sie auf Linux- und UNIX-Systemen für jeden JMS-Provider eine Zeilengruppe zur .ini-Datei des Warteschlangenmanagers hinzu.
      Beispiel:
      XAResourceManager:
      Name=Name_des_JMS-Providers SwitchFile=/Installationsverzeichnis/bin/ JMSSwitch.so
      XAOpenString=Ausgangskontext, JNDI-Position, Optionale Parameter
      ThreadOfControl=THREAD
      Dabei gilt:
      Name
      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 Eigenschaft Ausgangskontextfactory des JMSInput-Knotens festgelegt wurde.
      • JNDI-Position ist der Wert, der in der Eigenschaft Location JNDI bindings (Position der JNDI-Bindungen) des JMSInput-Knotens festgelegt wurde. Dieser Wert sollte eines der folgenden führenden Schlüsselwörter als Vorzeichen enthalten: file:/, iiop:/ oder ldap:/.
      Die folgenden Parameter sind optional:
      • LDAP-Principal 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 den JNDI-Bindungen definiert ist. Wenn kein Wert angegeben wird, muss zur JMS-Bindungsdatei ein Standardwert für recoverXAQCF hinzugefügt werden. In jedem Fall muss 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, z. B.:
        Installationsverzeichnis/classes/xarecovery.jar
      2. Aktualisieren Sie die Java-Umgebungsvariable PATH für den WS-Manager des Brokers, sodass sie auf das Verzeichnis 'bin' verweist, in dem sich die Switch-Datei befindet, z. B.:
        Installationsverzeichnis/bin
    Schließlich müssen Sie sicherstellen, dass Sie folgende Konfigurationsschritte ausgeführt haben:
    • Stellen Sie im Brokerarchiveditor sicher, dass im Nachrichtenfluss die Eigenschaft koordiniert aktiviert ist.
    • Stellen Sie sicher, dass für jeden Knoten, der in die XA-Transaktion aufgenommen werden muss, der Transaktionsmodus global gesetzt wurde.
    • Stellen Sie sicher, dass die Service-ID für den Broker der Service-ID für den Warteschlangenmanager entspricht.
    • Stellen Sie sicher, dass die Factory-Objekte der JNDI-Verbindung, die die JMS-Knoten für eine globale Transaktion verwenden, vom Typ MQXAConnectionFactory, MQXAQueueConnectionFactory bzw. MQXATopicConnectionFactory sind.

    Weitere Informationen finden Sie im Bereich 'System Administration Guide' von WebSphere MQ Version 6 Information Center online.

    Um denselben WS-Manager sowohl für den Broker als auch den JMS-Provider zu verwenden, müssen Sie sicherstellen, dass Ihre WebSphere MQ-Installation mindestens auf folgendem Stand ist: WebSphere MQ Version 6.0 Fixpack 1 oder höher ist erforderlich für XA, damit der gleiche WS-Manager für den Broker und den Provider verwendet wird.

  • z/OS platform 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 ist die einzige Transportoption, 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 WS-Manager des Brokers verwaltet. Die Datei .ini muss nicht geändert werden.

Terminals und Eigenschaften

In der folgenden Tabelle werden die Terminals des JMSInput-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.
Ausgabeterminal Das Ausgabeterminal, an das die Nachricht weitergeleitet wird, wenn sie erfolgreich abgerufen wird.
Abfangterminal Das Ausgabeterminal, an das die Nachricht weitergeleitet wird, wenn eine Ausnahmebedingung generiert und von diesem Knoten abgefangen 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 Beschreibungseigenschaften des JMSInput-Knotens beschrieben.

Eigenschaft M C Standardwert Beschreibung
Knotenname Nein Nein Knotentyp JMSInput 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 JMSInput-Knotens beschrieben.

Eigenschaft M C Standardwert Beschreibung
Quellenwarteschlange Nein Nein Ausgewählt Der Name der Warteschlange, aus der der Knoten eingehende Nachrichten empfängt.
Subskriptionsthema Nein Nein Nicht ausgewählt Der Name des Themas, das vom Knoten subskribiert wurde.
ID der permanenten Subskription Nein Nein   Die ID eines Themas einer permanenten Subskription.

In der folgenden Tabelle werden die JMS-Verbindungseigenschaften des JMSInput-Knotens beschrieben.

Eigenschaft M C Standardwert Beschreibung
Name des JMS-Provider Ja Nein WebSphere_MQ Wählen Sie in der Liste den Namen eines JMS-Anbieters aus, oder geben Sie einen Namen ein. Wenn Sie einen Namen in der Liste auswählen, wird die Eigenschaft Ausgangskontext-Factory automatisch mit der entsprechenden Java-Klasse aktualisiert. Wenn Sie einen eigenen JMS-Providernamen eingeben, müssen Sie auch einen Wert für die Ausgangskontext-Factory eingeben.
Der Standardwert ist WebSphere_MQ. Zu den gültigen Werten zählen folgende:
  • ActiveMQ
  • BEA_Weblogic
  • FioranoMQ
  • WebSphere_MQ
  • JBoss
  • JOnAS
  • Joram
  • OpenJMS
  • Oracle_OEMS
  • SeeBeyond
  • SonicMQ
  • SwiftMQ
  • Tibco_EMS
  • Generic_LDAP
  • Generic_File
Ausgangskontext-Factory Ja Ja com.sun.jndi.fscontext. RefFSContextFactory 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. 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 einen eigenen JMS-Providernamen eingeben, müssen Sie auch einen Wert für die Ausgangskontext-Factory eingeben.
Wo die JNDI-Bindungen liegen Ja Ja   Der Systempfad oder die LDAP-Position für die Bindungsdatei.
Verbindungsfactory-Name Ja Ja   Der Name der Verbindungsfactory, der vom JMSInput-Knoten für die Erstellung einer Verbindung zum JMS-Provider verwendet wird.
Rücksetzziel Nein Ja   Diese Zieladresse wird vom JMSInput-Knoten verwendet, wenn eine Nachricht auf Grund von Fehlern nicht vom Nachrichtenfluss verarbeitet werden kann.
Rücksetzschwellenwert Nein Ja 0 Der Wert, über den gesteuert wird, wann eine erneut zugestellte Nachricht in das Rücksetzziel gestellt wird.

In der folgenden Tabelle werden die Eigenschaften von 'Syntaxanalyse der Eingabenachricht' des JMSInput-Knotens beschrieben.

Eigenschaft M C Standardwert Beschreibung
Nachrichtendomäne Nein Nein   Die Domäne für die Syntaxanalyse der eingehenden Nachricht.
Nachrichtengruppe Nein Nein   Der Name oder die ID der Nachrichtengruppe, in der die eingehende Nachricht definiert ist.
Nachrichtentyp Nein Nein   Der Name der eingehenden Nachricht.
Nachrichtenformat Nein Nein   Der Name des physischen Formats der eingehenden Nachricht.

In der folgenden Tabelle werden die Eigenschaften der Parser-Optionen für den JMSInput-Knoten beschrieben.

Eigenschaft M C Standardwert Beschreibung
Zeitpunkt für Syntaxanalyse Nein Nein Bei Bedarf Durch diese Eigenschaft wird gesteuert, zu welchem Zeitpunkt eine Eingabenachricht syntaktisch analysiert wird. Gültige Werte sind Bei Bedarf, Sofort und Vollständig.

Eine vollständige Beschreibung dieser Eigenschaft finden Sie unter Bedarfsgerechte Syntaxanalyse.

Baumstruktur unter Verwendung von XML-Schemadatentypen erstellen Nein Nein Nicht ausgewählt Über diese Eigenschaft wird gesteuert, ob der XMLNSC-Parser Syntaxelemente in der Nachrichtenbaumstruktur mit Datentypen aus dem XML-Schema erstellt.
XMLNSC-Kompaktparser für XMLNS-Domäne verwenden Nein Nein Nicht ausgewählt Durch diese Eigenschaft wird gesteuert, ob der XMLNSC-Kompaktparser für Nachrichten in der XMLNS-Domäne verwendet wird. Bei Festlegung dieser Eigenschaft erscheinen die Nachrichtendaten in Knoten, die mit dem Ausgabeterminal verbunden sind, unter XMLNSC, wenn XMLNS die Nachrichtendomäne des MQRFH2-Eingabeheaders oder der Eigenschaften der Syntaxanalyse der Eingabenachricht ist.
Zugriff auf gemischten Inhalt Nein Nein Nicht ausgewählt Mit dieser Eigenschaft können Sie steuern, ob der XMLNSC-Parser Elemente in der Nachrichtenbaumstruktur erstellt, wenn er gemischten Text in einer Eingabenachricht feststellt. Wenn Sie das Kontrollkästchen aktivieren, werden Elemente für gemischten Text erstellt. Andernfalls wird gemischter Text ignoriert, und es werden keine Elemente erstellt.
Kommentare beibehalten Nein Nein Nicht ausgewählt Mit dieser Eigenschaft können Sie steuern, ob der XMLNSC-Parser Elemente in der Nachrichtenbaumstruktur erstellt, wenn er Kommentare in einer Eingabenachricht feststellt. Wenn Sie das Kontrollkästchen aktivieren, werden Elemente für Kommentare erstellt. Andernfalls werden Kommentare ignoriert, und es werden keine Elemente erstellt.
Verarbeitungsanweisung beibehalten Nein Nein Nicht ausgewählt Mit dieser Eigenschaft können Sie steuern, ob der XMLNSC-Parser Elemente in der Nachrichtenbaumstruktur erstellt, wenn er Verarbeitungsanweisungen in einer Eingabenachricht feststellt. Wenn Sie das Kontrollkästchen aktivieren, werden Elemente für Verarbeitungsanweisungen erstellt. Andernfalls werden Verarbeitungsanweisungen ignoriert, und es werden keine Elemente erstellt.
Nicht transparente Elemente Nein Nein   Über diese Eigenschaft wird eine Liste von Elementen in der Eingabenachricht angegeben, die vom XMLNSC-Parser nicht transparent analysiert werden sollen.

In der folgenden Tabelle werden die Nachrichtenselektoreigenschaften des JMSInput-Knotens beschrieben.

Eigenschaft M C Standardwert Beschreibung
Anwendungseigenschaft Nein Ja   Der Nachrichtenselektor, der Nachrichten gemäß dem Wert des Anwendungsmerkmals filtert.
Zeitmarke Nein Ja   Der Nachrichtenselektor, der Nachrichten gemäß der JMS-Zeitmarke filtert.
Zustellmodus Nein Ja   Der Nachrichtenselektor, der Nachrichten gemäß dem Nachrichtenübermittlungsmodus filtert.
Priorität Nein Ja   Der Nachrichtenselektor, der Nachrichten gemäß der Nachrichtenpriorität filtert.
Nachrichten-ID Nein Ja   Der Nachrichtenselektor, der Nachrichten gemäß der Nachrichten-ID filtert.
Korrelations-ID Nein Ja   Der Nachrichtenselektor, der Nachrichten gemäß der Korrelations-ID filtert.

In der folgenden Tabelle werden die erweiterten Eigenschaften des JMSInput-Knotens beschrieben.

Eigenschaft M C Standardwert Beschreibung
Transaktionsmodus Ja Nein Keine Durch diese Eigenschaft wird gesteuert, ob die eingehende Nachricht unter externer Synchronisationspunktsteuerung, lokaler Synchronisationspunktsteuerung oder außerhalb eines Synchronisationspunkts empfangen wird. Gültige Werte sind Keine, Lokal und Global.

In der folgenden Tabelle werden die Auswertungseigenschaften des JMSInput-Knotens beschrieben. Nähere Informationen finden Sie unter Auswertungseigenschaften.

Eigenschaft M C Standardwert Beschreibung
Auswerten Nein Ja Keines Durch diese Eigenschaft wird gesteuert, ob eine Auswertung stattfindet. Gültige Werte sind Keine,Inhalt und Inhalt und Wert.
Fehlerbehebungsmaßnahme 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.
Zugehörige Informationen
Konfigurierbare Services
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
ac24820_