WebSphere Message Broker Version 8.0.0.5 Betriebssysteme: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Sehen Sie sich die Informationen zur aktuellen Produktversion im IBM Integration Bus Version 9.0 an.

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 ist in folgende Abschnitte eingeteilt:

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 mithilfe von Methodenaufrufen empfangen, die in der JMS-Spezifikation beschrieben sind.

Der JMSInput-Knoten befindet sich im Ablagefach JMS der Palette und wird im WebSphere Message Broker Toolkit durch folgendes Symbol dargestellt:

Symbol für JMSInput-Knoten

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.

Informationen zu Beispielen können nur bei Verwendung des in das WebSphere Message Broker Toolkit integrierten bzw. online verfügbaren Information Center angezeigt werden. Muster können nur ausgeführt werden, wenn das im WebSphere Message Broker Toolkit integrierte Information Center verwendet wird.

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:
  • DFDL
  • XMLNSC
  • DataObject
  • JSON
  • BLOB
  • MIME
  • MRM
  • JMSMap
  • JMSStream
  • XMLNS

Nachrichtenflüsse, die Nachrichten handhaben, die von Verbindungen mit JMS-Providern empfangen werden, müssen immer mit einem JMSInput-Knoten beginnen. In einen mit einem JMSInput-Knoten startenden Nachrichtenfluss können Sie einen beliebigen unterstützten Sendeknoten (auch einen benutzerdefinierten Sendeknoten) aufnehmen, 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 für einen neuen oder einen bereits vorhandenen Provider einen Service erstellen. Die vordefinierten Services sind unter Eigenschaften von konfigurierbaren Services aufgeführt.

  • Wenn der WebSphere MQ-JMS-Provider verwendet werden soll und WebSphere MQ in der Standardposition im Brokersystem installiert ist, sind die Eigenschaften bereits definiert und müssen nicht geändert werden.
  • Soll der WebSphere MQ-JMS-Provider verwendet werden und ist WebSphere MQ an einer anderen Speicherposition (nicht an der Standardposition) installiert oder soll einer der anderen definierten Services verwendet werden, muss über die Eigenschaft jarsURL die Position der Service-JAR-Dateien im Brokersystem angegeben werden. Unter Windows kann es sich bei der Dateiadresse nicht um ein zugeordnetes Netzlaufwerk auf einem fernen Windows-Computer handeln. Es kommt nur ein lokales Verzeichnis oder ein Verzeichnis auf einem SAN-Datenträger (SAN = Storage Area Network = Speicherbereichsnetz) in Frage.

    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 beim Konfigurieren 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 gewünschten Service an.
  • Einige JMS-Provider stellen für bestimmte JMS-API-Aufrufe eine alternative Schnittstelle zur JMS-Standardspezifikation bereit. In diesen Fällen stellt IBM® eine Java-Klasse als Schnittstelle zur eigenen Anwendungsprogrammierschnittstelle zur Verfügung. Verwenden die JMS-Knoten als JMS-Provider beispielsweise BEA WebLogic und sollen die Knoten Teil eines XA-koordinierten Nachrichtenflusses sein, müssen die Eigenschaften der diesem Anbieter zugeordneten konfigurierbaren Services geändert werden. Der Abschnitt Broker für die Nutzung der proprietären Anwendungsprogrammierschnittstelle eines JMS-Providers konfigurieren enthält weitere Informationen hierzu.
  • Einige JMS-Provider, z. B. der BEA WebLogic-Provider, aktualisieren nicht das optionale Feld 'JMSXDeliveryCount' im JMS-Nachrichtenheader; deshalb ist keine Rücksetzungsverarbeitung des JMSInput-Knotens möglich. Um eventuelle Fehler im Nachrichtenfluss abzufangen, müssen Sie eine Verbindung mit dem Fehlerterminal des JMSInput-Knotens herstellen.
  • Sie können Verbindungen zu verschiedenen Versionen eines JMS-Providers herstellen, indem Sie einen konfigurierbaren JMSProviders-Service für jede Version des JMS-Providers erstellen und dann die Eigenschaft jarsURL auf einen eindeutigen Pfad setzen.

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.

Falls bei einer transaktionsorientierten Nachricht eine Ausnahmebedingung im Fehlerpfad auftritt, wird der Pfad zweimal so oft wiederholt wie unter Rücksetzschwellenwert angegeben. Wenn dieser Grenzwert überschritten wird, wird die Nachricht an das Rücksetzziel weitergeleitet. Falls bei einer nicht transaktionsorientierten Nachricht eine Ausnahmebedingung im Fehlerpfad auftritt, wird die Nachricht sofort an das Rücksetzziel übertragen. Wenn Sie keine Knoten mit dem Fehlerterminal (Failure) verbunden haben, wird die Nachricht direkt an das Rücksetzziel gesendet. Ist kein Rücksetzziel definiert, so wird die Nachricht zurückgesetzt.

Wenn die Verarbeitung nach dem Neustart des Brokers oder der Ausführungsgruppe nicht wieder aufgenommen wird, überprüfen Sie das Implementierungsprotokoll auf mögliche Ursachen, z. B. kann in den Knoteneigenschaften ein falscher Parser angegeben sein. Korrigieren Sie den Fehler, und implementieren Sie den Nachrichtenfluss erneut. Falls die Nachricht selbst ungültig ist, entfernen Sie die Nachricht aus der Eingabewarteschlange, um die Verarbeitung wieder aufzunehmen.

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 sind, setzt der Knoten transaktionsorientierte Nachrichten für eine erneute Zustellung solange zurück, bis das Problem behoben ist oder der Rücksetzschwellenwert erreicht wird. Bei Erreichen des Schwellenwerts wird die Nachricht an das Rücksetzziel weitergeleitet. Wenn keine Knoten mit dem Catch-Terminal verbunden sind, wird eine nicht transaktionsorientierte Nachricht direkt an das Rücksetzziel weitergeleitet. Ist kein Rücksetzziel definiert, so wird die Nachricht zurückgesetzt.

Koordinierte Transaktionen konfigurieren

Wenn Sie einen JMSInput-Knoten in einen Nachrichtenfluss einschließen, definiert der Wert, den Sie für den Transaktionsmodus festgelegt haben, ob die Nachrichten unter der Synchronisationspunktsteuerung empfangen werden. Weitere Informationen hierzu finden Sie unter Koordinierte JMS-Transaktionen konfigurieren.

Konfiguration für Gesamtbestätigung

Sie können den JMSInput-Knoten so konfigurieren, dass für den Empfang nicht transaktionsorientierter JMS-Nachrichten eine Gesamtbestätigung gesendet wird. Weitere Informationen hierzu finden Sie unter JMSInput-Knoten für die Verarbeitung von Stapelnachrichten.

Terminals und Eigenschaften

Nachdem Sie eine Instanz des JMSInput-Knotens in einen Nachrichtenfluss eingereiht haben, können Sie den Knoten konfigurieren; siehe Nachrichtenflussknoten konfigurieren. Die Eigenschaften des Knotens werden in der Ansicht 'Eigenschaften' angezeigt. Alle verbindlichen Eigenschaften, für die kein Standardwert definiert ist, sind mit einem Stern markiert.

In der folgenden Tabelle werden die Terminals des JMSInput-Knotens beschrieben.
Terminal Beschreibung
Fehlerterminal (Failure) Das Ausgabeterminal, an das die Nachricht geleitet 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 abgerufen wird.
Catch-Terminal 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 O zeigt an, ob die Eigenschaft obligatorisch ist (markiert mit einem Sternchen, wenn ein Wert eingegeben werden muss, weil kein Standardwert definiert ist). Die Spalte K 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 O K Standardwert Beschreibung
Knotenname Nein Nein Knotentyp JMSInput Der Name des Knotens.
Kurzbeschreibung Nein Nein   Kurze Beschreibung des Knotens.
Langbeschreibung Nein Nein   Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt.
In der folgenden Tabelle werden die Basiseigenschaften des JMSInput-Knotens beschrieben.
Eigenschaft O K Standardwert Beschreibung Eigenschaft des Befehls mqsiapplybaroverride
Quellenwarteschlange Nein Ja Ausgewählt Der Name der Warteschlange, aus der der Knoten eingehende Nachrichten empfängt. 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. sourceQueueName
Subskriptionsthema Nein Ja Nicht ausgewählt Der Name des Themas, das vom Knoten subskribiert wurde. 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.
Thema
ID der permanenten Subskription Nein Ja   Die ID eines Themas einer permanenten Subskription. 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.
durableSubscriptionID
In der folgenden Tabelle werden die JMS-Verbindungseigenschaften des JMSInput-Knotens beschrieben.
Eigenschaft O K Standardwert Beschreibung Eigenschaft des Befehls mqsiapplybaroverride
Name des JMS-Providers Ja Nein WebSphere MQ Wählen Sie in der Liste den Namen eines JMS-Anbieters aus oder geben Sie einen Namen ein. Wenn Sie in der Liste einen Namen auswählen, wird die Eigenschaft Ausgangskontextfactory automatisch mit der entsprechenden Java-Klasse aktualisiert. Wenn Sie einen eigenen JMS-Providernamen eingeben, müssen Sie auch einen Wert für die Ausgangskontextfactory eingeben. Der Name muss dem Namen eines konfigurierbaren Service entsprechen, der für den Broker, für den Sie den Nachrichtenfluss implementieren, definiert ist. Alternativ können Sie den konfigurierbaren Service JMSProviders angeben.  
Ausgangskontextfactory Nein 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 Ausgangskontextfactory automatisch mit der entsprechenden Java-Klasse aktualisiert. Wenn Sie einen eigenen JMS-Providernamen eingeben, müssen Sie auch einen Wert für die Ausgangskontextfactory eingeben.Der Standardwert lautet com.sun.jndi.fscontext.RefFSContextFactory. Mit diesem Wert wird die dateibasierte Ausgangskontextfactory für den JMS-Provider von WebSphere MQ definiert.

Wenn der Knoten für die Verwendung Ihres eigenen JMS-Providers eingestellt ist und für die entsprechende Eigenschaft 'Konfigurierbare Services' der Definition mqsichangeproperties das Attribut InitialContextFactory (Ausgangskontextfactory) definiert ist, wird die Einstellung auf dem Knoten mit diesem Attribut überschrieben.

initialContextFactory
Wo die JNDI-Bindungen liegen No Ja   Der Systempfad oder die LDAP-Position für die Bindungsdatei. 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-Position 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 ein unterstütztes URL-Präfix einschließen, das einen im Klassenpfad verfügbaren URL-Handler enthält.

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

Wenn der Knoten für die Verwendung Ihres eigenen JMS-Providers eingestellt ist und für die entsprechende Eigenschaft 'Konfigurierbare Services' der Definition mqsichangeproperties das Attribut jndiBindingsLocation definiert ist, wird die Einstellung auf dem Knoten mit diesem Attribut überschrieben.

locationJndiBindings
Verbindungsfactory-Name No Ja   Der Name der Verbindungsfactory, der vom JMSInput-Knoten für die Erstellung einer Verbindung zum JMS-Provider verwendet wird. 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. Sie können auch die generische JMS-Verbindungsfactory angeben, die für JMS-Warteschlangenziele oder für JMS-Themaziele verwendet werden kann. connectionFactoryName
Rücksetzziel Nein Ja   Wenn der Nachrichtenfluss aufgrund von Fehlern die Nachricht nicht verarbeiten kann, werden Eingabenachrichten vom JMSInput-Knoten an diese Zieladresse gesendet, und die Nachricht muss aus dem Eingabeziel entfernt werden. Der Name des Rücksetzungsziels muss in der Bindungsdatei enthalten sein. backoutDestination
Rücksetzschwellenwert Nein Ja 0 Der Wert, über den gesteuert wird, wann eine erneut zugestellte Nachricht in das Rücksetzziel gestellt 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.

Weitere Informationen hierzu finden Sie unter Eigenschaft 'Rücksetzschwellenwert' konfigurieren.

 

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

Eigenschaft M C Standardwert Beschreibung
Nachrichtendomäne Nein Nein BLOB (Binary large object) Die Domäne für die Syntaxanalyse der Nachricht. Wenn das Feld leer ist, ist der Standardwert BLOB.
Nachrichtenmodell Nein Nein Nicht ausgewählt Der Name bzw. die Position der Nachrichtenmodell-Schemadatei, in der die Nachricht definiert ist. Diese Liste ist mit allen verfügbaren Nachrichtenmodell-Schemadateien für die ausgewählte Nachrichtendomäne gefüllt.
Nachricht Nein Nein Nicht ausgewählt Der Name bzw. die Position des Nachrichtenstamms innerhalb der Nachrichtenmodell-Schemadatei. Diese Liste wird mit allen verfügbaren Nachrichten belegt, die in dem von Ihnen ausgewählten Nachrichtenmodell definiert sind.
Physisches Format Nein Nein Nicht ausgewählt Der Name des physischen Formats der Nachricht. Wenn Sie den MRM- oder IDOC-Parser verwenden, wählen Sie das physische Format der ankommenden Nachricht aus der Liste aus. Diese Liste umfasst alle physischen Formate, die für das ausgewählte Nachrichtenmodell definiert wurden. Wenn Sie die Eigenschaft Nachrichtendomäne auf DataObject setzen, können Sie diese Eigenschaft auf XML oder SAP ALE IDoc setzen. Legen Sie für diese Eigenschaft SAP ALE IDoc fest, wenn ein Bitstrom aus einer externen Quelle analysiert und eine Nachrichtenbaumstruktur generiert werden muss.
In der folgenden Tabelle werden die Eigenschaften der Parser-Optionen für den JMSInput-Knoten beschrieben.
Eigenschaft O K 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
  • Vollständig

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.

Baumstruktur unter Verwendung von XML-Schemadatentypen erstellen Nein Nein Nicht ausgewählt Durch diese Eigenschaft wird gesteuert, ob der XMLNSC-Parser Syntaxelemente in der Nachrichtenbaumstruktur mit Datentypen erstellt, die aus dem XML-Schema entnommen wurden.

Einzelheiten dazu, wie der XML-Parser funktioniert, finden Sie unter Nachrichten in der XMLNSC-Domäne bearbeiten.

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. Wenn Sie diese Eigenschaft festlegen, werden die Nachrichtendaten in Knoten, die mit dem Ausgabeterminal verbunden sind, unter XMLNSC angezeigt, wenn es sich bei dem MQRFH2-Eingabeheader oder der Eigenschaft Nachrichtendomäne unter 'Syntaxanalyse der Eingabenachricht' um XMLNS handelt.
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 Leer Über diese Eigenschaft wird eine Liste von Elementen in der Eingabenachricht angegeben, die vom XMLNSC-Parser nicht transparent analysiert werden sollen. Die nicht transparente Syntaxanalyse wird nur ausgeführt, wenn keine Gültigkeitsprüfung aktiviert ist (das heißt, wenn Auswerten auf Keine gesetzt ist); Einträge, die in Nicht transparente Elemente angegeben sind, werden ignoriert, wenn die Gültigkeitsprüfung aktiviert ist.
In der folgenden Tabelle werden die Nachrichtenselektoreigenschaften des JMSInput-Knotens beschrieben. Legen Sie diese Eigenschaften fest, um Nachrichten zu filtern. Eine Beschreibung, wie der JMS-Nachrichtenselektor erstellt wird, finden Sie im Abschnitt JMS-Nachrichtenselektor.
Eigenschaft O K Standardwert Beschreibung
Anwendungseigenschaft Nein Nein   Der Nachrichtenselektor, der Nachrichten gemäß dem Wert des Anwendungsmerkmals filtert.

Wenn der JMS-Provider Nachrichten auf der Grundlage der von der initiierenden JMS-Clientanwendung festgelegten Nachrichteneigenschaften filtern soll, geben Sie für die Anwendungseigenschaft eine Selektorzeichenfolge ein, durch die 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.

Zeitmarke Nein Nein   Der Nachrichtenselektor, der Nachrichten gemäß der JMS-Zeitmarke filtert.

Wenn der JMS-Provider Nachrichten filtern soll, die zu bestimmten Zeitpunkten generiert wurden, geben Sie für Zeitmarke eine Selektorzeichenfolge 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.

Zustellmodus Nein Nein Alle Der Nachrichtenselektor, der Nachrichten gemäß dem Nachrichtenübermittlungsmodus filtert.
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:
  • Wählen Sie Nicht permanent aus, wenn Nachrichten empfangen werden sollen, die von der sendenden JMS-Clientanwendung als nicht permanent markiert wurden.
  • Wählen Sie Persistent aus, wenn nur Nachrichten empfangen werden sollen, die von der initiierenden JMS-Clientanwendung als persistent markiert wurden.
  • Wählen Sie Alle aus, wenn sowohl permanente als auch nicht permanente Nachrichten empfangen werden sollen. (Dieser Wert ist der Standardwert.)
Priorität Nein Nein   Der Nachrichtenselektor, der Nachrichten gemäß der Nachrichtenpriorität filtert.

Wenn der JMS-Provider Nachrichten auf Basis des Headerwerts 'JMSPriority' in der JMS-Nachricht filtern soll, geben Sie für Priorität eine Selektorzeichenfolge ein.

Die gültigen Werte für Priorität liegen zwischen 0 (niedrigste Priorität) und 9 (höchste Priorität). Geben Sie beispielsweise = 5 ein, um Nachrichten der Priorität 5 zu empfangen, > 4, um Nachrichten mit einer Priorität größer als 4 zu empfangen, oder BETWEEN 4 AND 8, um Nachrichten mit einer Priorität im Bereich von 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.

Nachrichten-ID Nein Nein   Der Nachrichtenselektor, der Nachrichten gemäß der Nachrichten-ID filtert.

Wenn der JMS-Provider Nachrichten auf Basis des Headerwerts 'JMSMessageID' filtern soll, geben Sie für Nachrichten-ID eine Selektorzeichenfolge ein. Geben Sie beispielsweise > WMBRK123456 ein, 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.

Erneut zugestellt Nein Nein   Wenn der JMS-Provider Nachrichten auf Basis des Headerwerts 'JMSRedelivered' filtern soll, geben Sie für Erneut zugestellt eine Selektorzeichenfolge 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.
Korrelations-ID Nein Nein   Der Nachrichtenselektor, der Nachrichten gemäß der Korrelations-ID filtert.

Wenn der JMS-Provider Nachrichten auf Basis des Headerwerts 'JMSCorrelationID' filtern soll, geben Sie für Korrelations-ID eine Selektorzeichenfolge ein. Geben Sie beispielsweise = WMBRKABCDEFG ein, damit Nachrichten zurückgegeben werden, 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.

In der folgenden Tabelle werden die erweiterten Eigenschaften des JMSInput-Knotens beschrieben.
Eigenschaft O K Standardwert Beschreibung
Transaktionsmodus Ja Nein Nein
Durch diese Eigenschaft wird gesteuert, ob die Nachricht unter einer JMS-Transaktion empfangen wird. Gültige Werte sind Ja und Nein.
  • Wählen Sie Nein aus, um die Nachricht mit einer nicht transaktionsorientierten JMS-Sitzung zu empfangen.
  • Wählen Sie Ja aus, um die Nachricht mit einer transaktionsorientierten JMS-Sitzung zu empfangen. Die JMS-Transaktion kann entweder lokal oder XA-koordiniert sein. Um eine XA-Transaktion mit einer XA-JMS-Sitzung zu verwenden, müssen Sie in den Eigenschaften der BAR-Datei auch die Nachrichtenflusseigenschaft Koordinierte Transaktion auswählen. Weitere Informationen hierzu finden Sie unter Koordinierte JMS-Transaktionen konfigurieren.
Der Wert, der für Transaktionsmodus auf dem JMSInput-Knoten festgelegt ist, wird von den nachgeschalteten Knoten im Nachrichtenfluss übernommen, bei denen Transaktionsmodus auf Automatisch gesetzt ist. Andere Ressourcen, die Arbeiten im Nachrichtenfluss durchführen, z. B. DB2 oder WebSphere MQ, verwenden Transaktionen unabhängig von der Einstellung des Knotens für Transaktionsmodus und schreiben ihre Transaktion fest, nachdem die Nachricht verarbeitet wurde.
In der folgenden Tabelle werden die Auswertungseigenschaften des JMSInput-Knotens beschrieben. Weitere Informationen finden Sie unter Nachrichten überprüfen und Auswertungseigenschaften.
Eigenschaft O K Standardwert Beschreibung Eigenschaft des Befehls mqsiapplybaroverride
Auswerten Nein Ja Ohne Durch diese Eigenschaft wird gesteuert, ob eine Auswertung stattfindet. Gültige Werte sind:
  • Ohne
  • Inhalt und Wert
  • Inhalt

Wenn Sie Inhalt oder Inhalt und Wert auswählen, müssen Sie in der Liste Aktion bei Fehler eine Option auswählen.

validateMaster
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
  • Ausnahme (Standardwert)
  • Ausnahmeliste
 
Die Überwachungseigenschaften des Knotens werden in der folgenden Tabelle beschrieben.
Eigenschaft O K Standardwert Beschreibung
Ereignisse Nein Nein Ohne Auf dieser Registerkarte werden Ereignisse angezeigt, die Sie für den Knoten definiert haben. Standardmäßig sind für keinen Knoten in einem Nachrichtenfluss Überwachungsereignisse definiert. Über Hinzufügen, Bearbeiten und Löschen können Sie Überwachungsereignisse für den Knoten erstellen, ändern oder löschen (Details siehe Überwachungsereignisquellen mithilfe von Überwachungseigenschaften konfigurieren).

Sie können hier angezeigte Ereignisse aktivieren oder inaktivieren, indem Sie das Kontrollkästchen Aktiviert aktivieren oder inaktivieren.

Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Letzte Aktualisierung:
        
        Letzte Aktualisierung: 2015-02-28 16:20:05


ReferenzthemaReferenzthema | Version 8.0.0.5 | ac24820_