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:
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:
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.
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.
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.
Mit dem Befehl mqsireportproperties können Sie die Providereigenschaften anzeigen. Mit dem Befehl mqsichangeproperties können Sie die Eigenschaften festlegen oder modifizieren.
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.
Wenn Sie einen Wert für Wo die JNDI-Bindungen liegen eingeben, sind dabei folgende Anweisungen einzuhalten:
Informationen zum Erstellen der Bindungsdatei für verwaltete JNDI-Objekte finden Sie in der Dokumentation des JMS-Providers.
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.
Geben Sie für Zeitmarke keinen Wert an, wenn der Empfangsknoten keine Auswahl auf der Grundlage der JMS-Zeitmarke (JMSTimeStamp) treffen soll.
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.
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.
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.
Weitere Informationen finden Sie unter Nachrichten überprüfen und Auswertungseigenschaften.
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.
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.
Unter Windows: 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 zur .ini-Datei des Warteschlangenmanagers hinzu.
XAResourceManager: Name=Name_des_JMS-Providers SwitchFile=/Installationsverzeichnis/bin/ JMSSwitch.so XAOpenString=Ausgangskontext, JNDI-Position, Optionale Parameter ThreadOfControl=THREADDabei gilt:
Die optionalen Parameter werden durch Kommas getrennt und sind positionsgebunden. Aus diesem Grund müssen fehlende Parameter durch ein Komma dargestellt werden.
Installationsverzeichnis/classes/xarecovery.jar
Installationsverzeichnis/bin
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.
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.
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:
|
| 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. |