Parameter für das Muster Nachrichtenverteiler für WebSphere MQ: unidirektional (bei XML)

Eingabeinformationen
Musterparameter M K Standard Beispiel
Eingabewarteschlange Ja Ja IN Dieser Musterparameter gibt die Brokerwarteschlange an, in der die XML-Nachrichten empfangen werden.
Containername Ja Nein *:* Der Pfad des Containerelements in der eingehenden XML-Nachricht, in dem sich die zu extrahierenden Elemente befinden. Dieser Pfad wird mit Syntax wie ESQL angegeben, er enthält aber nur die Elemente aus XML. Beispiel: SalesData.Invoices.

Der Namensbereich kann vollständig angegeben werden, allerdings reicht auch ein Platzhalterzeichen aus, es sei denn, Sie müssen zwischen zwei Containerelementen mit dem gleichen Namen, aber unterschiedlichen Namensbereichen unterscheiden. Beispiel: *:SalesData.*:Invoices.

Wenn der Standardwert *:* verwendet wird, wird vom Stammelement der XML-Nachricht ausgegangen, das einen beliebigen Namen haben kann.

Name des Nachrichtenelements Ja Nein *:* Der Name der Elemente, die aus der eingehenden Nachricht extrahiert werden.

Wenn der Standardwert *:* verwendet wird, werden alle untergeordneten Elemente des Containers akzeptiert.

Namensbereiche müssen nicht angegeben werden, da davon ausgegangen wird, dass jedes Element mit dem angegebenen Namen unabhängig von seinem Namensbereich erforderlich ist.

Routing
Musterparameter M K Standard Beispiel
Routing Nein Nein Kein Routing Gültige Werte sind:
  • Kein Routing
  • Routen angeben
  • Routen suchen
Kein Routing
Musterparameter M K Standard Beispiel
Ausgabe-WS-Manager Nein Ja   Dieser Parameter gibt den Warteschlangenmanager an, an den alle Ausgabenachrichten gesendet werden. Ohne Angabe dieses Parameters wird als Standardeinstellung der Warteschlangenmanager des Brokers verwendet.
Ausgabewarteschlange Nein Ja OUT Dieser Parameter definiert die Zielwarteschlange.
Routen angeben

Die Parameter in der folgenden optionalen Namensbereichstabelle definieren die Namensbereichspräfixe und Namensbereichs-URIs, die Sie zur Definition der Schlüsselpositionen für Routen in XPath-Ausdrücken verwenden können. Wenn eine Zeile eingeschlossen ist, müssen beide Parameter eingeschlossen sein. Sie können der Tabelle Werte hinzufügen und die Werte bearbeiten, löschen und ihre Reihenfolge ändern.

Musterparameter M K Standard Beispiel
Namensbereichspräfix Ja Nein Nicht zutreffend Der Parameter Namensbereichspräfix ist in der Definition der Routen im XPath-Ausdruck des Parameters Schlüsselposition enthalten.
Namespace-URI Ja Nein Nicht zutreffend Die Namensbereichs-URI ist der dem angegebenen Präfix zugeordnete Namensbereich.

Die Parameter der folgenden Routing-Tabelle definieren die Ausgabeziele und Regeln, wenn der Wert des Parameters Routing Routen angeben lautet. Zur Festlegung einer Route stehen vier Parameter zur Verfügung; diese können für beliebig viele Routen verwendet werden. Sie können der Tabelle Werte hinzufügen und die Werte bearbeiten, löschen und ihre Reihenfolge ändern.

Musterparameter M K Standard Beispiel
Schlüsselposition Ja Nein Nicht zutreffend

Eine Schlüsselposition ist ein XPath-Ausdruck, der eine Position im weitergegebenen Datensatz definiert. Beispiel: $Root/XMLNSC/submitPORequest/partNo.

Unter "Route-Knoten" und "XPath verwenden" in der WebSphere Message Broker-Dokumentation finden Sie weitere Informationen zu der Art des zu verwendenden Ausdrucks.

Namensbereiche können angegeben werden, wenn sie in der optionalen Namensbereichstabelle angegeben sind.

Schlüsselwert Ja Nein Nicht zutreffend Dieser Parameter enthält den Wert, mit dem das Feld Schlüsselposition der eingehenden Nachricht übereinstimmen muss, damit diese Route ausgewählt wird.
WS-Manager Ja Ja   Dieser Parameter definiert den Warteschlangenmanager für dieses Routing-Ziel. Ohne Angabe dieses Parameters wird als Standardeinstellung der Warteschlangenmanager des Brokers verwendet.
Warteschlange Ja Ja Nicht zutreffend Dieser Parameter definiert die Warteschlange für dieses Routing-Ziel.
Routen suchen
Musterparameter M K Standard Beispiel
Routing-Datenquelle Nein Ja Nicht zutreffend Dieser Parameter definiert die Datenquelle, aus der die Route ausgewählt werden kann. Die Routing-Informationen werden in der Tabelle ROUTING_TABLE gesucht.
Routing-Kontext Nein Nein Nicht zutreffend Dieser Parameter definiert einen Routing-Kontext, durch den die Tabelle ROUTING_TABLE für mehrere Mediationsflüsse verwendet werden kann.

Nur Zeilen, deren Eintrag im Feld ROUTING_CONTEXT mit dem Wert von Routing-Datenkontext übereinstimmt, werden für die Routing-Suche verwendet und dem Speichercache hinzugefügt.

Schlüsselposition 1 Nein Nein Nicht zutreffend Dieser Parameter definiert, wie der erste Schlüssel aus dem weitergegebenen Nachrichtenelement extrahiert wird. Der Parameter wird als ESQL-Ausdruck definiert.

Der erste Schlüssel wird zur Auswahl für VARIABLE1 eines Datenquellen-Routing-Eintrags verwendet. Die Position muss im Format InputBody oder InputRoot angegeben werden.

Schlüsselposition 2 Nein Nein Nicht zutreffend Dieser Parameter definiert, wie ein optionaler zweiter Schlüssel aus dem weitergeleiteten Nachrichtenelement extrahiert wird. Der Parameter wird als ESQL-Ausdruck definiert.

Der zweite Schlüssel wird zur Auswahl für VARIABLE2 eines Datenquellen-Routing-Eintrags verwendet. Die Position muss im Format InputBody oder InputRoot angegeben werden.

Cache-Aktualisierung Nein Nein Gelöscht Wenn dieser Parameter ausgewählt ist, wird der Speichercache mit den Routing-Daten aus der Datenquelle aktualisiert, sobald eine Aktualisierungsnachricht eingeht.
Aktualisierungswarteschlange Nein Ja REFRESH Wenn Cache-Aktualisierung aktiviert ist, löst eine an diese Warteschlange gesendete Nachricht eine Aktualisierung der Routing-Daten im Speichercache aus.
Protokollierung
Musterparameter M K Standard Beispiel
Protokollierung erforderlich Nein Nein Gelöscht Dieser Musterparameter bestimmt, ob die Musterinstanz den Code für die Protokollierung enthält.

Wenn inaktiviert, ist der untergeordnete Protokollnachrichtenfluss nicht enthalten.

Wenn aktiviert, müssen für Protokoll-WS-Manager und Protokollwarteschlange Werte eingegeben werden.

Protokoll-WS-Manager Nein Ja   Dieser Musterparameter definiert den Warteschlangenmanager für die Protokollierung. Er kann leer bleiben, wenn der Warteschlangenmanager des Brokers für die Protokollierung verwendet werden soll.

Er ist nur erforderlich, wenn Protokollierung erforderlich aktiviert ist.

Protokollwarteschlange Nein Ja LOG Dieser Musterparameter definiert die Warteschlange für die Protokollierung.

Er ist nur erforderlich, wenn Protokollierung erforderlich aktiviert ist.

Fehlerbehandlung
Musterparameter M K Standard Beispiel
Fehlernachricht erforderlich Nein Ja Ausgewählt Dieser Musterparameter bestimmt, ob die Musterinstanz den Code für das Einreihen von Fehlernachrichten in eine Warteschlange enthält.

Wenn aktiviert, müssen für Fehler-WS-Manager und Fehlerwarteschlange Werte eingegeben werden.

Fehler-WS-Manager Nein Ja   Dieser Musterparameter definiert den Warteschlangenmanager für die Fehlerprotokollierung.

Er ist nur erforderlich, wenn Fehlernachricht erforderlich aktiviert ist.

Fehlerwarteschlange Nein Ja ERROR Dieser Musterparameter definiert die Warteschlange für Fehlernachrichten.

Er ist nur erforderlich, wenn Fehlernachricht erforderlich aktiviert ist.

Aktion für fehlerhafte Nachrichten Nein Nein Speichern Dieser Parameter definiert die Aktion, die durchgeführt wird, wenn ein Nachrichtenelement nicht weitergeleitet werden kann. Gültige Werte sind:
  • Speichern
  • Abbrechen

Wenn Speichern aktiviert ist, werden alle Nachrichtenelemente, die nicht weitergeleitet werden können, in die Warteschlange für fehlerhafte Nachrichten eingereiht.

Wenn Abbrechen aktiviert ist und ein Nachrichtenelement nicht weitergeleitet werden kann, wird der gesamte Nachrichtenfluss zurückgesetzt.

WS-Manager für fehlerhafte Nachrichten Nein Ja   Dieser Musterparameter definiert den Warteschlangenmanager zum Speichern von Nachrichtenelementen, die nicht weitergeleitet werden können. Ohne Angabe dieses Parameters wird als Standardeinstellung der Warteschlangenmanager des Brokers verwendet.

Dieser Parameter ist nur erforderlich, wenn der Wert des Parameters Aktion für fehlerhafte Nachrichten Speichern lautet.

Warteschlange für fehlerhafte Nachrichten Nein Ja BAD Dieser Musterparameter definiert die Warteschlange zum Speichern von Nachrichtenelementen, die nicht weitergeleitet werden können.

Dieser Parameter ist nur erforderlich, wenn der Wert des Parameters Aktion für fehlerhafte Nachrichten Speichern lautet.

Allgemein
Musterparameter M K Standard Beispiel
Brokerschema Nein Nein mqsi Wenn festgelegt, werden alle Nachrichtenflüsse und ESQL-Dateien im angegebenen Brokerschema erstellt. Anderenfalls wird das Standardschema verwendet.
Nachrichtenflusspräfix Nein Nein   Wenn festgelegt, erhalten die Namen aller Nachrichtenflüsse dieses Präfix.
Nachrichtenflusssuffix Nein Nein   Wenn festgelegt, erhalten die Namen aller Nachrichtenflüsse dieses Suffix.
Warteschlangenpräfix Nein Nein   Wenn festgelegt, erhalten die Namen aller Warteschlangen dieses Präfix.

Wenn Standard-Warteschlangennamen verwendet werden, muss ein Präfix, ein Suffix oder beides festgelegt werden, um die Warteschlangennamen der einzelnen Musterinstanzen unterscheiden zu können.

Warteschlangensuffix Nein Nein   Wenn festgelegt, erhalten die Namen aller Warteschlangen dieses Suffix.
Kurzbeschreibung Nein Nein   Diese Beschreibung wird der Eigenschaft Kurzbeschreibung aller generierten Nachrichtenflüsse hinzugefügt.
Ausführliche Beschreibung Nein Nein   Diese Beschreibung wird der Eigenschaft Ausführliche Beschreibung aller generierten Nachrichtenflüsse hinzugefügt.

Alle Musterparameter sind mit ihren Standardwerten aufgelistet.

Die Spalte mit der Überschrift O gibt an, ob die Eigenschaft obligatorisch ist. Die Spalte mit der Überschrift K gibt an, ob die Eigenschaft konfigurierbar ist, d. h., ob Sie den Wert ändern können, wenn Sie den Nachrichtenfluss zur Brokerarchivdatei (BAR-Datei) hinzufügen.

Wenn kein Standardwert angegeben ist, ist der Standardwert eine leere Zeichenfolge.

Zurück zur Spezifikation des Musters 'Message Splitter for WebSphere MQ: one-way (for XML)' (Nachrichtenverteiler für WebSphere MQ: unidirektional (bei XML))