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:
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 ist in der WebSphere MQ-Ablage der Palette enthalten und wird im WebSphere Message Broker Toolkit durch folgendes Symbol dargestellt:
Weitere Informationen zur Verwendung des MQGet-Knotens in einem Nachrichtenfluss finden Sie im Abschnitt Szenario des Typs 'Anforderung/Antwort' unter Verwendung eines MQGet-Knotens.
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.
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.
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.
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.
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.
Einstellung | Beschreibung |
---|---|
QueueName | Diese Einstellung setzt die Eigenschaft Warteschlangenname des MQGet-Knotens außer Kraft. Beispiel:
|
InitialBufferSize | Diese Einstellung setzt die Eigenschaft Mindestgröße für Nachrichtenpuffer des MQGet-Knotens außer Kraft. Beispiel:
|
MQGMO.* | Diese Einstellung setzt die MQGET-Nachrichtenoptionen, die vom
MQGet-Knoten verwendet werden, außer Kraft. Beispiel:
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. |
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.
Der Abschnitt Verbindungen zu Fehlerterminals (Failure) herstellen enthält weitere Informationen hierzu.
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).
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. |
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.
<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. |
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. |
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:
|
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.
|
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.
|
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.
|
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. |
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:
|
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). |
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. |
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. |
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. |