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.

MQGet-Knoten

Mit dem MQGet-Knoten können Sie Nachrichten von Clients empfangen, die über WebSphere MQ Enterprise Transport eine Verbindung zum Broker herstellen und die MQI- und AMI-Anwendungsprogrammierschnittstellen verwenden.

Über den MQGet-Knoten können darüber hinaus Nachrichten abgerufen werden, die zuvor in eine für den Warteschlangenmanager des Brokers definierte WebSphere MQ-Nachrichtenwarteschlange eingereiht wurden.

Dieses Thema enthält folgende Abschnitte:

Im Thema werden folgende Begriffe verwendet:
Eingabenachricht
Eine Nachricht, die das Eingangsterminal des MQGet-Knotens erreicht.
Nachricht in der Warteschlange
Eine Nachricht, die der MQGet-Knoten in der Warteschlange liest.

Zweck

Der MQGet-Knoten liest eine Nachricht aus einer angegebenen Warteschlange und erstellt die Verarbeitungsumgebung für die Nachricht. Je nach Bedarf können Sie die Eingabewarteschlange als eine WebSphere MQ-Clusterwarteschlange oder als gemeinsam genutzte Warteschlange definieren.

Ein MQGet-Knoten kann - anders als ein MQInput-Knoten, der nur als erster Knoten in einem Nachrichtenfluss verwendet werden kann - an jeder beliebigen Stelle im Nachrichtenfluss eingesetzt werden. Die Baumstruktur einer Ausgabenachricht von einem MQGet-Knoten wird erstellt, indem die Eingabebaumstruktur mit der Ergebnisbaumstruktur des MQGET-Aufrufs kombiniert wird. Sie können in den Eigenschaften des MQGet-Knotens festlegen, dass die Art des Nachrichtenempfangs kontrolliert werden soll. So können Sie beispielsweise angeben, dass eine Nachricht unter Transaktionssteuerung verarbeitet werden soll. Außerdem können Sie anfordern, dass während der Erstellung der Ergebnisbaumstruktur beim Empfang aller Eingabenachrichten eine Datenkonvertierung erfolgen soll.

Der MQGet-Knoten bearbeitet Nachrichten in den folgenden Nachrichtendomänen:
  • DFDL
  • XMLNSC
  • DataObject
  • JSON
  • BLOB
  • MIME
  • MRM
  • JMSMap
  • JMSStream
  • XMLNS

Der MQGet-Knoten ist in der WebSphere MQ-Ablage der Palette enthalten und wird im WebSphere Message Broker Toolkit durch folgendes Symbol dargestellt:

Symbol für MQGet-Knoten

MQGet-Knoten in einem Nachrichtenfluss verwenden

Weitere Informationen zur Verwendung des MQGet-Knotens in einem Nachrichtenfluss finden Sie im Abschnitt Szenario des Typs 'Anforderung/Antwort' unter Verwendung eines MQGet-Knotens.

Aus dem folgenden Beispiel geht hervor, wie Nachrichten über den MQGet-Knoten angezeigt werden:

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.

Den MQGet-Knoten konfigurieren

Wenn Sie eine Instanz des MQGet-Knotens in einen Nachrichtenfluss eingereiht haben, können Sie ihn konfigurieren. Weitere Informationen finden Sie unter Nachrichtenflussknoten konfigurieren. Die Knoteneigenschaften werden in der Eigenschaftenansicht angezeigt.

Alle verbindlichen Eigenschaften, für die Sie einen Wert eingeben müssen (d. h. Eigenschaften ohne definierten Standardwert), sind mit einem Sternchen gekennzeichnet.

Koordinierte Transaktionen konfigurieren

Wenn Sie einen MQGet-Knoten in einen Nachrichtenfluss aufnehmen, wird über den für den Transaktionsmodus festgelegten Wert definiert, ob die Nachrichten unter Verwendung eines Synchronisationspunktes empfangen werden.
  • Wird der Wert für die Eigenschaft auf Ja (Standardeinstellung) gesetzt, wird die Nachricht in der Warteschlange unter der Synchronisationspunktsteuerung empfangen (d. h. in einer Arbeitseinheit von WebSphere MQ). Alle Nachrichten, die später von einem Sendeknoten in derselben Instanz des Nachrichtenflusses gesendet werden, unterliegen der Synchronisationspunktsteuerung, es sei denn, der Sendeknoten oder ein anderer nachfolgender Knoten setzen diese Einstellung explizit außer Kraft.
  • Wird der Wert für die Eigenschaft auf Automatisch gesetzt, erfolgt der Empfang der Nachricht in der Warteschlange unter der Synchronisationspunktsteuerung, wenn die eingehende Nachricht als persistent markiert ist. Andernfalls wird für den Empfang kein Synchronisationspunkt verwendet. Alle Nachrichten, die später von einem Sendeknoten gesendet werden, unterliegen der Synchronisationspunktsteuerung (wie vom Persistenzmerkmal der eingehenden Nachricht bestimmt), es sei denn, der Sendeknoten oder ein anderer nachfolgender Knoten setzen diese Einstellung explizit außer Kraft.
  • Wird der Wert für die Eigenschaft auf Nein gesetzt, unterliegt der Empfang der Nachricht in der Warteschlange 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 oder ein anderer nachfolgender Knoten hat dies explizit vorgegeben.

Wenn Sie die Eigenschaft Nur anzeigen festlegen, wird der für die Eigenschaft Transaktionsmodus definierte Wert ignoriert, da eine Nachricht nicht unter Verwendung eines Synchronisationspunktes durchsucht werden kann. Alle abgeleiteten Nachrichten, die später von einem Sendeknoten in derselben Instanz des Nachrichtenflusses weitergegeben werden, weisen jedoch das gleiche Verhalten auf, das zuvor gemäß dem angegebenen Transaktionsmodus-Wert beschrieben wird.

Knoteneigenschaften während der Nachrichtenverarbeitung überschreiben

Wenn Sie einen MQGet-Knoten in einen Nachrichtenfluss einschließen und konfigurieren, sollen dessen Eigenschaften möglicherweise unter bestimmten Bedingungen überschrieben werden. Zum Beispiel möchten Sie vielleicht aus einer Warteschlange lesen, die in einem anderen Teil der Nachricht identifiziert wird oder die aus einem Datenbanksatz abgerufen wird.

Wenn Sie die Werte, die Sie für die Eigenschaften eines MQGet-Knotens festgelegt haben, überschreiben möchten, um eine dynamischere Nachrichtenverarbeitung zu erreichen, fügen Sie vor dem MQGet-Knoten einen Compute- oder JavaCompute-Knoten in Ihren Nachrichtenfluss ein. Konfigurieren Sie diesen Knoten, um eine Ausgabenachricht zu erstellen, und fügen Sie Felder zur Baumstruktur für die lokale Umgebung hinzu, um neue Werte für die zu ändernden Eigenschaften zu definieren.

Fügen Sie beispielsweise einen Compute-Knoten im Nachrichtenfluss hinzu und definieren Sie einen neuen Warteschlangennamen für den MQGet-Knoten zum Lesen von Nachrichten, indem Sie folgende ESQL-Anweisung einfügen:
SET LocalEnvironment.MQ.GET.QueueName = 'Neue_Warteschlange';

Verwenden Sie LocalEnvironment.MQ.GET. als den Korrelationsnamen für alle Felder, die sich auf den MQGet-Knoten beziehen.

Unter der Baumstruktur 'InputLocalEnvironment.MQ.GET' können Sie die folgenden Eigenschaften festlegen. Wenn Sie einen Wert für die Eigenschaft Position der MQ-Parameter in der Eingabe auf dem MQGet-Knoten festgelegt haben, node, wird diese Position in der Baumstruktur stattdessen überprüft.
Einstellung Beschreibung
QueueName Diese Einstellung setzt die Eigenschaft Warteschlangenname des MQGet-Knotens außer Kraft. Beispiel:
SET InputLocalEnvironment.MQ.GET.QueueName = 'myQueue';
InitialBufferSize Diese Einstellung setzt die Eigenschaft Mindestgröße für Nachrichtenpuffer des MQGet-Knotens außer Kraft. Beispiel:
SET InputLocalEnvironment.MQ.GET.InitialBufferSize = 1024;
MQGMO.* Diese Einstellung setzt die MQGET-Nachrichtenoptionen, die vom MQGet-Knoten verwendet werden, außer Kraft. Beispiel:
SET InputLocalEnvironment.MQ.GET.MQGMO.Options = MQGMO_ACCEPT_TRUNCATED_MSG;
SET InputLocalEnvironment.MQ.GET.MQGMO.WaitInterval = 10000;
Dieser Korrekturwert wird aus Gründen der Flexibilität bereitgestellt, er sollte jedoch mit Vorsicht verwendet werden, da die MQGMO-Struktur genau wie angegeben verwendet wird. Knoteneigenschaften und andere Korrekturwerte der lokalen Umgebung werden nicht berücksichtigt.

Weitere Informationen zur MQGMO-Struktur finden Sie im WebSphere MQ Version 7 Information Center online.

Verbindungen zu Terminals herstellen

Verbinden Sie die Ausgangs-, Warnungs- und Fehlerterminals (Failure) sowie das Ausgabeterminal 'Keine Nachricht' dieses Knotens mit einem anderen Knoten im Nachrichtenfluss, um die Nachricht weiterzuverarbeiten, Fehler zu verarbeiten oder die Nachricht an eine weitere Zieladresse zu senden.

Über den vom MQGET-Aufruf generierten Beendigungscode (CC) wird gesteuert, was an die einzelnen Ausgabeterminals weitergegeben wird.
  • Bei einem erfolgreichen MQGET-Aufruf leitet der MQGet-Knoten jede analysierte Ausgabenachricht an das Ausgangsterminal weiter.
  • Wenn der MQGET-Aufruf mit einem Bedingungscode fehlschlägt, der eine Warnung anzeigt, wird eine nicht analysierte Ausgabenachricht an das Warnungsterminal weitergegeben.
  • Wenn der MQGET-Aufruf mit einem Bedingungscode fehlschlägt, der schwerwiegender ist als eine Warnung, wird die Eingabenachricht an das Fehlerterminal (Failure) weitergegeben.
  • Wenn der MQGET-Aufruf mit dem Ursachencode MQRC_NO_MSG_AVAILABLE fehlschlägt, wird die Ausgabenachricht (ohne Ergebnishauptteil) an das Terminal 'Keine Nachricht' weitergegeben. Die an das Terminal 'Keine Nachricht' weitergegebene Ausgabenachricht wird nur aus der Eingabenachricht erstellt, wobei die Werte der Eigenschaften Generierungsmodus, Nachricht kopieren und Lokale Umgebung kopieren berücksichtigt werden.
  • Wenn Sie die Ausgabe-, Warnungs- oder 'Keine Nachricht'-Terminals mit keinem anderen Knoten im Nachrichtenfluss verbinden, werden alle Nachrichten, die an diese Terminals weitergegeben werden, gelöscht.
  • Wenn Sie das Fehlerterminal (Failure) nicht mit einem anderen Knoten im Nachrichtenfluss verbinden, wird bei der Weitergabe einer Nachricht an dieses Terminal vom Broker eine Ausnahmebedingung generiert.

Der Abschnitt Verbindungen zu Fehlerterminals (Failure) herstellen enthält weitere Informationen hierzu.

Terminals und Eigenschaften

In der folgenden Tabelle werden die Terminals des MQGet-Knotens beschrieben.
Terminal Beschreibung
Eingabeterminal (In) Das Eingangsterminal, das die vom Nachrichtenfluss verarbeitete Nachricht annimmt.
Warnung Das Ausgabeterminal, an das die Ausgabebaumstruktur weitergegeben wird, wenn beim Versuch, eine Nachricht aus der Warteschlange abzurufen, ein Fehler (mit einem Bedingungscode, der eine Warnung anzeigt) im Knoten auftritt. Der MQMD-Bereich der Nachricht wird syntaktisch analysiert, beim übrigen Bereich der Nachricht handelt es sich jedoch um ein nicht syntaktisch analysiertes BLOB-Element. Die Warnung wird gelöscht, wenn das Terminal nicht verbunden ist, und es findet keine Weitergabe der Ausgabe vom Knoten statt.
Fehlerterminal (Failure) Das Ausgabeterminal, an das die Eingabenachricht weitergegeben wird, wenn beim Versuch, eine Nachricht aus der Warteschlange abzurufen, ein Fehler (mit einem Bedingungscode, der schwerwiegender ist als eine Warnung) im Knoten auftritt.
Ausgang Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn sie erfolgreich von der WebSphere MQ-Warteschlange abgerufen wurde.
Keine Nachricht Das Ausgabeterminal, an das die Eingabenachricht geleitet wird, wenn in der Warteschlange keine Nachricht zur Verfügung steht. Die an das Terminal 'Keine Nachricht' weitergegebene Ausgabenachricht wird nur aus der Eingabenachricht erstellt, wobei die Werte der Eigenschaften Generierungsmodus, Nachricht kopieren und Lokale Umgebung kopieren berücksichtigt werden.

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). 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 Eigenschaften für die Beschreibung des MQGet-Knotens beschrieben.
Eigenschaft O K Standardwert Beschreibung
Knotenname Nein Nein Knotentyp MQGet Der Name des Knotens.
Kurzbeschreibung Nein Nein Leer Kurze Beschreibung des Knotens.
Langbeschreibung Nein Nein Leer Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt.
In der folgenden Tabelle werden die Basiseigenschaften des MQGet-Knotens beschrieben.
Eigenschaft O K Standardwert Beschreibung Eigenschaft des Befehls mqsiapplybaroverride
Warteschlangenname Ja Ja Ohne Der Name der WebSphere MQ-Nachrichtenwarteschlange, aus der dieser Knoten Nachrichten abruft.

Sie müssen diese Warteschlange für den Warteschlangenmanager vordefinieren, auf dem sich der Broker befindet, für den der Nachrichtenfluss implementiert wird. Wenn es sich hierbei um eine ungültige Warteschlange handelt, generiert der Knoten eine Ausnahmebedingung und die Eingabenachricht wird an das Fehlerterminal (Failure) weitergegeben.

queueName

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

Wenn die Nachricht in der Warteschlange einen MQRFH2-Header enthält, müssen Sie keine Werte für die Eigenschaften unter 'Syntaxanalyse der Eingabenachricht' angeben, da die Werte aus dem Ordner <mcd> im MQRFH2-Header abgeleitet werden können, zum Beispiel:
<mcd><Msd>MRM</Msd><Set>DHM4UO906S001</Set><Type>receiptmsg1</Type>
<Fmt>XML</Fmt></mcd>
Wenn Sie Werte festlegen, die sich von denen im MQRFH2-Header unterscheiden, haben die Werte im MQRFH2-Header Vorrang.
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 MQGet-Knoten beschrieben.
Eigenschaft O K Standardwert Beschreibung
Zeitpunkt für Syntaxanalyse Nein Nein Bei Bedarf Über diese Eigenschaft wird der Zeitpunkt der syntaktischen Analyse der Nachricht in der Warteschlange gesteuert. Gültige Werte sind Bei Bedarf, Sofort und Vollständig. Diese Eigenschaft ist standardmäßig auf Bei Bedarf gesetzt, d. h., die Syntaxanalyse der Nachricht wird verschoben. Der Abschnitt Bedarfsgerechte Syntaxanalyse enthält Informationen zur sofortigen Analyse von Nachrichten.
MQRFH2C-Kompaktparser für MQRFH2-Header verwenden Nein Nein Nicht ausgewählt Durch diese Eigenschaft wird gesteuert, ob der MQRFH2C-Kompaktparser anstelle des MQRFH-Parsers für MQRFH2-Header verwendet wird. Wählen Sie MQRFH2C-Kompaktparser für MQRFH2-Domäne verwenden aus, wenn der MQRFH2C-Parser verwendet werden soll. Dieses Kontrollkästchen ist standardmäßig inaktiviert, d. h., der Kompaktparser wird nicht verwendet.
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. Diese Eigenschaft kann nur ausgewählt werden, wenn für die Eigenschaft Auswerten auf der Registerkarte Auswertung Inhalt oder Inhalt und Wert festgelegt wurde. Weitere Informationen zu XMLNSC finden Sie im Abschnitt 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 Über diese Eigenschaft wird gesteuert, ob der XMLNSC-Parser Elemente in der Nachrichtenbaumstruktur erstellt, wenn er in der Nachricht in der Warteschlange gemischten Text findet. 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 Über diese Eigenschaft wird gesteuert, ob der XMLNSC-Parser Elemente in der Nachrichtenbaumstruktur erstellt, wenn er in der Nachricht in der Warteschlange Kommentare findet. 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 Über diese Eigenschaft wird gesteuert, ob der XMLNSC-Parser Elemente in der Nachrichtenbaumstruktur erstellt, wenn er in der Nachricht in der Warteschlange Verarbeitungsanweisungen findet. 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 Nachricht in der Warteschlange 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 erweiterten Eigenschaften des MQGet-Knotens beschrieben.
Eigenschaft O K Standardwert Beschreibung
Transaktionsmodus Nein Nein Ja Durch diese Eigenschaft wird gesteuert, ob die ankommende Nachricht unter Synchronisationspunktsteuerung empfangen wird.
Wählen Sie in der Liste einen Wert für den Transaktionsmodus aus, um die transaktionsorientierten Merkmale für die Handhabung dieser Nachricht zu definieren:
  • Wenn Sie die Option Automatisch auswählen, wird die Nachricht in der Warteschlange unter der Synchronisationspunktsteuerung empfangen, falls sie als persistent markiert ist. Wenn die Nachricht nicht als persistent markiert ist, wird sie nicht unter der Synchronisationspunktsteuerung empfangen. Die Transaktionalität abgeleiteter Nachrichten, die später von einem Sendeknoten weitergegeben werden, wird durch das Persistenzmerkmal der Nachricht bestimmt, es sei denn, der Sendeknoten oder ein beliebiger anderer nachfolgender Knoten im Nachrichtenfluss setzt die Transaktionalität explizit außer Kraft.
  • Wenn Sie die Option Ja auswählen, wird die Nachricht in der Warteschlange unter Synchronisationspunktsteuerung empfangen. Jede abgeleitete Nachricht, die später von einem Sendeknoten in der gleichen Instanz des Nachrichtenflusses weitergegeben wird, wird transaktionsorientiert gesendet, es sei denn, der Sendeknoten oder ein beliebiger anderer nachfolgender Knoten im Nachrichtenfluss setzt die Transaktionsorientierung explizit außer Kraft.
  • Wenn Sie die Option Nein auswählen, wird die Nachricht in der Warteschlange nicht unter Synchronisationspunktsteuerung empfangen. Alle abgeleiteten Nachrichten, die später von einem Sendeknoten in derselben Instanz des Nachrichtenflusses weitergegeben werden, werden nicht transaktionsorientiert gesendet - es sei denn, vom Sendeknoten oder einem beliebigen anderen nachfolgenden Knoten im Nachrichtenfluss wurde angegeben, dass die Nachrichten unter Synchronisationspunktsteuerung gesetzt werden müssen.
Generierungsmodus Nein Nein Nachricht Durch diese Eigenschaft wird gesteuert, welche Teile der Nachricht aus der Eingabebaumstruktur kopiert werden.
Wählen Sie in der Liste einen Wert für Generierungsmodus aus und legen Sie damit fest, welche Komponenten der Ausgabenachricht innerhalb des MQGet-Knotens generiert und welche Komponenten aus der Eingabenachricht entnommen werden sollen.
  • Bei Auswahl von Keine werden alle Komponenten der Nachricht aus der Eingabebaumstruktur unverändert weitergegeben.
  • Bei Auswahl von Nachricht (die Standardeinstellung) wird vom Knoten eine neue Nachrichtenkomponente erstellt, die Komponenten 'Lokale Umgebung', 'Umgebung' und 'Ausnahmeliste' aus der Eingabebaumstruktur werden jedoch unverändert weitergegeben.
  • Bei Auswahl von Lokale Umgebung wird vom Knoten eine neue Komponente des Typs 'Lokale Umgebung' erstellt, die Komponenten 'Nachricht', 'Umgebung' und 'Ausnahmeliste' aus der Eingabebaumstruktur werden jedoch unverändert weitergegeben.
  • Bei Auswahl von Nachricht und lokale Umgebung werden vom Knoten neue Komponenten des Typs 'Nachricht' und 'Lokale Umgebung' erstellt, die Komponenten 'Umgebung' und 'Ausnahmeliste' aus der Eingabebaumstruktur werden jedoch unverändert weitergegeben.
Nachricht kopieren Nein Nein Ohne Durch diese Eigenschaft wird gesteuert, welche Teile der Nachricht aus der Eingabebaumstruktur kopiert werden.
Wenn Sie Generierungsmodus auf Nachricht oder Nachricht und lokale Umgebung gesetzt haben, wählen Sie in der Liste einen Wert für Nachricht kopieren aus und legen Sie damit fest, welche Nachrichtenteile innerhalb des MQGet-Knotens generiert und welche Teile aus der Eingabenachricht entnommen werden sollen.
  • Wenn Sie Keine (die Standardeinstellung) auswählen, wird kein Teil der Eingabenachricht aus der Eingabebaumstruktur weitergegeben.
  • Wenn Sie Header kopieren auswählen, werden die Header aus der Eingabenachricht in der Eingabebaumstruktur in die Ausgabenachricht kopiert.
  • Wenn Sie Gesamte Nachricht kopieren auswählen, wird die gesamte Eingabenachricht aus der Eingabebaumstruktur in die Ausgabenachricht kopiert.
Lokale Umgebung kopieren Nein Nein Gesamte lokale Umgebung kopieren Durch diese Eigenschaft wird gesteuert, wie die lokale Umgebung in die Ausgabenachricht kopiert wird.
Wenn Sie Generierungsmodus auf Lokale Umgebung oder Nachricht und lokale Umgebung gesetzt haben, wählen Sie in der Liste einen Wert für Lokale Umgebung kopieren aus und legen Sie damit fest, welche Teile der lokalen Umgebung innerhalb des MQGet-Knotens generiert und welche Teile der Eingabenachricht entnommen werden sollen.
  • Bei Auswahl von Gesamte lokale Umgebung kopieren (die Standardeinstellung), wird in jedem Knoten im Nachrichtenfluss eine neue Kopie der lokalen Umgebung in der Baumstruktur erstellt und mit dem Inhalt der lokalen Umgebung aus dem vorherigen Knoten aufgefüllt. Wenn ein Knoten die lokale Umgebung ändert, werden diese Änderungen den vorgeschalteten Knoten daher nicht angezeigt, da sie über eigene Kopien verfügen. Dieses Verhalten könnte ein Problem darstellen, wenn Sie einen FlowOrder-Knoten verwenden oder den Befehl propagate auf einem Compute-Knoten verwenden. Die gesamte lokale Umgebung, die in der Eingabenachricht definiert ist, wird in die Ausgabenachricht kopiert.
  • Bei Auswahl von Keine erstellen die jeweiligen Knoten keine eigene Kopien der lokalen Umgebung, sondern verwenden die lokale Umgebung, die vom vorherigen Knoten übergeben wird. Wenn also in diesem Fall die lokale Umgebung für einen Knoten geändert wird, werden diese Änderungen auch von den vorgeordneten Knoten bemerkt.
Warteintervall (ms) Ja Nein 1000 Die maximale Zeitspanne (in Millisekunden), die auf den Erhalt der Nachricht in der Warteschlange aus der Nachrichtenwarteschlange gewartet wird.

Geben Sie einen Wert für die Eigenschaft Warteintervall (ms) an und legen Sie damit fest, wie viele Millisekunden auf den Empfang einer Nachricht vom MQGET-Aufruf gewartet werden soll. Bei Auswahl von 0 ist das Warteintervall inaktiviert, es gibt keine Wartezeit für Nachrichten. Für Warteintervall (ms) kann kein negativer Wert angegeben werden. Falls Sie keinen Wert angeben, wird der Standardwert von 1000 Millisekunden verwendet.

Mindestgröße für Nachrichtenpuffer (KB) Ja Nein 4 Die Mindestgröße (in KB) des Abrufpuffers. Der Mindestwert für diese Eigenschaft beträgt 1.

Mit dem Wert, den Sie für diese Eigenschaft eingeben, legen Sie die Größe des anfänglichen Puffers für den MQGET-Aufruf fest. Der Puffer wird automatisch erweitert, damit Nachrichten aller Größen aufgenommen werden können. Falls jedoch umfangreiche Nachrichten erwartet werden, geben Sie einen geeigneten Wert an, um die Häufigkeit der Größenanpassung des Puffers zu reduzieren. Wenn Sie keinen Wert angeben, hat der Puffer eine Größe von 4 KB.

In der folgenden Tabelle werden die Anforderungseigenschaften des MQGet-Knotens beschrieben.
Eigenschaft O K Standardwert Beschreibung
MQMD-Position in der Eingabe Nein Nein InputRoot.MQMD Die Position im Aufbau der Eingabenachricht an der sich der für den MQGET-Aufruf zu verwendende MQMD befindet. Die Standardposition ist InputRoot.MQMD.
Position der MQ-Parameter in der Eingabe Nein Nein InputLocalEnvironment.MQ.GET Die Position im Aufbau der Eingabenachricht, an der sich die WebSphere MQ-Parameter (z. B. die anfängliche Puffergröße und die MQGMO-Überschreibungswerte) befinden. Die Standardposition ist InputLocalEnvironment.MQ.GET.
Abruf nach Korrelations-ID Nein Nein Nicht ausgewählt Wird dieses Kontrollkästchen aktiviert, werden nur Nachrichten mit der angegebenen Korrelations-ID abgerufen.

Bei Auswahl von Abruf nach Korrelations-ID muss das Feld CorrelId der abzurufenden Nachricht mit dem Feld CorrelId unter MQMD-Position in der Eingabe übereinstimmen. Das Kontrollkästchen ist standardmäßig inaktiviert.

Die Einstellung von CorrelId auf 'MQCI_NONE' hat die gleiche Wirkung, wie wenn Sie Abruf nach Korrelations-ID inaktivieren.

Abruf nach Nachrichten-ID Nein Nein Nicht ausgewählt Wird dieses Kontrollkästchen aktiviert, werden nur Nachrichten mit der angegebenen Nachrichten-ID abgerufen.

Bei Auswahl von Abruf nach Nachrichten-ID muss das Feld MsgId der abzurufenden Nachricht mit dem Feld MsgId unter MQMD-Position in der Eingabe übereinstimmen. Das Kontrollkästchen ist standardmäßig inaktiviert.

Verwenden Sie alle Eingabe-MQMD-Felder Nein Nein Nicht ausgewählt Bei Auswahl von Verwenden Sie alle Eingabe-MQMD-Felder werden alle MQMD-Eingabefelder in der MQMD-Position in der Eingabe für den Abruf der Nachricht verwendet. Ist in der MQMD-Position in der Eingabe ein MQMD-Bitstrom vorhanden, werden alle Felder in dem Bitstrom verwendet. Vergewissern Sie sich, dass der MQMD der abzurufenden Nachricht mit diesen Feldern übereinstimmt. Das Kontrollkästchen ist standardmäßig inaktiviert.

Wenn Sie keinen Eingabe-MQMD angeben, wird der Standard-MQMD verwendet.

Wenn Sie einen Eingabe-MQMD angeben, wird der Standard-MQMD mit folgenden Änderungen verwendet:
  • Wenn Sie die Eigenschaft Verwenden Sie alle Eingabe-MQMD-Felder setzen, werden alle angegebenen MQMD-Felder aus dem Eingabe-MQMD in den Standard-MQMD kopiert.
  • Wenn Sie die Eigenschaft Verwenden Sie alle Eingabe-MQMD-Felder nicht setzen, die Eigenschaften Abruf nach Nachrichten-ID bzw. Abruf nach Korrelations-ID aber ausgewählt sind, werden die jeweiligen IDs aus dem Eingabe-MQMD in den Standard-MQMD kopiert.
Weitere Informationen zur Konstruktion der MQMD für den MQGET-Aufruf finden Sie im Abschnitt Szenario des Typs 'Anforderung/Antwort' unter Verwendung eines MQGet-Knotens.
Nur anzeigen Nein Nein Nicht ausgewählt Diese Eigenschaft bestimmt, ob eine Nachricht aus der Warteschlange gelöscht wird, wenn sie gelesen wurde. Wenn das Kontrollkästchen aktiviert ist, wird die Nachricht beim Lesen nicht aus der Warteschlange entfernt. Wählen Sie Nur anzeigen aus, um anzugeben, dass die Nachricht in der Warteschlange bleiben soll, wenn sie gelesen wird.
Anzeigecursor zurücksetzen Nein Nein Nicht ausgewählt Diese Eigenschaft kann nur festgelegt werden, wenn Nur anzeigen ausgewählt ist. Bei Auswahl von Anzeigecursor zurücksetzen beginnt der Knoten am Anfang der MQ-Warteschlange (d. h., die Abrufoption MQGMO_BROWSE_FIRST MQ wird angegeben).

Wenn Sie diese Eigenschaft nicht auswählen, beginnt der Knoten an der aktuellen Cursorposition in der MQ-Warteschlange (d. h., die Abrufoption MQGMO_BROWSE_NEXT MQ wird angegeben).

In der folgenden Tabelle werden die Ergebniseigenschaften des MQGet-Knotens beschrieben. Mit diesen Eigenschaften legen Sie fest, wie die Ergebnisse des MQGET-Aufrufs behandelt werden.
Eigenschaft O K Standardwert Beschreibung
Position für Ausgabedaten Nein Nein OutputRoot Durch diese Eigenschaft wird festgelegt, wohin die Ausgabedaten gestellt werden. Falls in diesem Feld keine Angabe erfolgt, wird als Standardwert OutputRoot verwendet. Geben Sie die Startposition innerhalb der Ausgabenachrichtenbaumstruktur ein, an der die analysierten Elemente aus der Bitfolge der Nachricht in der Warteschlange gespeichert werden. Alle Elemente an dieser Adresse werden gelöscht und die Nachricht der Eingabebaumstruktur wird standardmäßig durch die Nachricht in der Warteschlange ersetzt.

Sie können alle gültigen ESQL-Feldverweise eingeben. Dazu gehören auch Ausdrücke innerhalb des Verweises sowie neue Feldverweise zum Erstellen eines Knotens in der Nachrichtenbaumstruktur zur Eingabe der Antwort in die Nachricht, die von der Eingabebaumstruktur weitergegeben wird. OutputRoot.XMLNS.ABC.DEF und Environment.GotReply sind beispielsweise gültige Feldverweise. Ausführlichere Informationen finden Sie im Abschnitt Szenario des Typs 'Anforderung/Antwort' unter Verwendung eines MQGet-Knotens.

Wenn die Nachricht in der Warteschlange-Bitfolge für die Erstellung der Inhalte der Nachrichtenbaumstruktur analysiert wird, werden die Nachrichteneigenschaften verwendet, die Sie als Eigenschaften für 'Syntaxanalyse der Eingabenachricht' des Knotens angegeben haben.

Position für Ergebnisdaten Nein Nein ResultRoot Diese Eigenschaft gibt an, welche Unterverzeichnisstruktur (der Nachricht in der Warteschlange) verwendet werden soll. Wenn in diesem Feld kein Wert angegeben wird, wird als Standardwert ResultRoot übernommen und es wird die gesamte Nachricht in der Warteschlange verwendet. Wird beispielsweise ResultRoot.MQMD.ReplyToQ angegeben, wird nur diese untergeordnete Baumstruktur verwendet.

Mit dieser Eigenschaft steuern Sie, welche untergeordnete Baumstruktur der Nachricht in der Warteschlange in die Ausgabenachricht gestellt wird. Wenn z. B. nur der MQMD aus der Nachricht in der Warteschlange verwendet werden soll, geben Sie ResultRoot.MQMD an; diese untergeordnete Baumstruktur wird dann an den Ort gestellt, der durch die Position für Ausgabedaten angegeben ist.

Position für MQ-Ausgabeparameter Nein Nein OutputLocalEnvironment.MQ.GET Über diese Eigenschaft wird angegeben, wo sich die WebSphere MQ-Ausgabeparameter befinden. Bleibt das Feld leer, wird 'OutputLocalEnvironment.MQ.GET' als Standardwert verwendet. Legen Sie für den Generierungsmodus fest, dass Lokale Umgebung enthalten sein soll. Auf diese Weise wird sichergestellt, dass die aktualisierten Werte in nachgeordneten Knoten sichtbar sind. Die Standardposition lautet OutputLocalEnvironment.MQ.GET.

Mit dieser Eigenschaft steuern Sie, wohin der Beendigungscode (CC = Completion Code), der Ursachencode (RC = Reason Code), der Durchsuchungsanzeiger sowie sonstige WebSphere MQ-Parameter (z. B. der vom MQGET-Aufruf verwendete MQMD) in der Ausgabebaumstruktur gestellt werden.

Position für Warndaten Nein Nein OutputRoot Über diese Eigenschaft wird angegeben, wohin die Ausgabedaten gestellt werden, wenn von MQGET ein Warncode ausgegeben wird. Bleibt das Feld leer, wird OutputRoot als Standardwert verwendet.

Mit dieser Eigenschaft steuern Sie, wohin die Nachricht in der Warteschlange gestellt wird, wenn vom MQGET-Aufruf ein Warncode zurückgegeben wird. Sie können jeden beliebigen gültigen ESQL-Feldverweis eingeben (siehe Beschreibung der Eigenschaft Position für Ausgabedaten). Bei den Daten, die an diese Position gestellt werden, handelt es sich immer um die gesamte Ergebnisbaumstruktur, deren Hauptteil als Element des Typs BLOB (Binäres Großobjekt) enthalten ist. Für Warndaten wird das Feld Position für Ergebnisdaten nicht verwendet.

Nachrichteninhalte in Assemblierung der Ausgabenachricht aufnehmen Nein Nein Ausgewählt Durch diese Eigenschaft wird angegeben, dass für die Assemblierung der Ausgabenachricht keine Daten als Ergebnis oder Warnung erforderlich sind. Wenn dieses Kontrollkästchen aktiviert ist, ruft der Knoten die Nachricht auf der Warteschlange ab oder durchsucht sie dort, ohne die Inhalte vollständig zu lesen oder zu analysieren.

Wenn Sie die Option Nachrichteninhalte in Assemblierung der Ausgabenachricht aufnehmen auswählen, ist dadurch nicht gewährleistet, dass die Nachrichteninhalte in die Ausgabebaumstruktur aufgenommen werden, da hierfür andere Knoteneigenschaften wie z. B. die Eigenschaft Generierungsmodus ausschlaggebend sind.

Inaktivieren Sie Nachrichteninhalte in Assemblierung der Ausgabenachricht aufnehmen und geben Sie damit an, dass für die Assemblierung der Ausgabenachricht keine Ergebnis- oder Warndaten erforderlich sind. Durch diese Aktion wird die Nachricht von der Warteschlange abgerufen oder dort durchsucht, wobei die Inhalte nicht gelesen oder analysiert werden.

In der folgenden Tabelle werden die Auswertungseigenschaften des MQGet-Knotens beschrieben. Eine umfassende Beschreibung dieser Eigenschaften finden Sie unter 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 Keine, Inhalt, Inhalt und Wert und Übernehmen. 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, Ausnahmebedingung und 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:04


ReferenzthemaReferenzthema | Version 8.0.0.5 | ac20806_