MQAbrufknoten

Dieses Thema enthält folgende Abschnitte:

Zweck

Mit dem MQAbrufknoten 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. Mit dem MQAbrufknoten können auch Nachrichten abgerufen werden, die zuvor in eine WebSphere MQ-Nachrichtenwarteschlange eingereiht wurden, die für den WS-Manager des Brokers definiert ist.

Der MQAbrufknoten liest eine Nachricht von einer angegebenen Warteschlange und baut die Verarbeitungsumgebung für die Nachricht auf. Falls passend, können Sie die Eingabewarteschlange als eine WebSphere MQ-Clusterwarteschlange oder als gemeinsam genutzte Warteschlange definieren.

Ein MQAbrufknoten kann - anders als ein MQEmpfangsknoten, der nur als erster Knoten im Nachrichtenfluss verwendet werden kann - an jeder beliebigen Stelle im Nachrichtenfluss verwendet werden. Die Baumstruktur einer Ausgabenachricht von einem MQAbrufknoten wird erstellt, indem die Empfangsbaumstruktur mit der Ergebnisbaumstruktur des MQGET-Aufrufs kombiniert wird. Sie können die Eigenschaften des MQAbrufknotens festlegen, um die Weise zu steuern, in der die Nachrichten empfangen werden. Sie können beispielsweise festlegen, dass eine Nachricht unter Transaktionssteuerung verarbeitet werden soll, oder Sie können anfordern, dass die Datenkonvertierung während der Erstellung einer Ergebnisbaumstruktur beim Empfang jeder Eingabenachricht ausgeführt wird.

Der MQAbrufknoten bearbeitet Nachrichten in den folgenden Nachrichtendomänen:

  • MRM
  • XML
  • XMLNS
  • XMLNSC
  • JMSMap
  • JMSStream
  • MIME
  • BLOB
  • IDOC

Der MQAbrufknoten wird in der Workbench durch folgendes Symbol dargestellt:

Symbol für MQAbrufknoten

Den MQAbrufknoten in einem Nachrichtenfluss verwenden

Die nachfolgenden Beschreibungen und Beispiele erläutern die Verwendung des MQAbrufknotens in einem Nachrichtenfluss:

MQAbrufknoten konfigurieren

Wenn Sie eine Instanz des MQAbrufknotens in einen Nachrichtenfluss eingereiht haben, können Sie ihn konfigurieren.

Klicken Sie in der Editoransicht mit der rechten Maustaste auf den Knoten, und klicken Sie auf Eigenschaften. Daraufhin werden die Basiseigenschaften des Knotens im Eigenschaftendialogfeld angezeigt.

Alle obligatorischen Eigenschaften sind im Eigenschaftendialog mit einem Stern markiert.

Konfigurieren Sie den MQAbrufknoten wie folgt:

  1. Geben Sie unter Name der Warteschlange den Namen der Warteschlange ein, aus der die Nachricht empfangen werden soll. Sie müssen diese WebSphere MQ-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 es wird eine Nachricht an das Fehlerterminal übergeben.
  2. Wählen Sie im Eigenschaften-Dialognavigator die Option "Standardwert", und legen Sie die Werte für die Eigenschaften fest, die die Nachrichtendomäne, die Nachrichtengruppe, Nachrichtenart und das Nachrichtenformat beschreiben, mit denen der Knoten festlegt, wie die ankommende Nachricht analysiert wird. Geben Sie auch das Standardthema an, das mit der Nachricht verknüpft wird
    • Verfügt die eingehende Nachricht über einen MQRFH2-Header, müssen Sie keine Werte für die Standardeigenschaften angeben, da die Werte vom <mcd>-Ordner im MQRFH2-Header abgeleitet werden können. 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.

    • Wählen Sie unter Nachrichtendomäne aus der Dropdown-Liste den Namen des von Ihnen verwendeten Parsers aus. Sie können einen der folgenden Namen auswählen:
      • MRM
      • XML
      • XMLNS
      • XMLNSC
      • JMSMap
      • JMSStream
      • MIME
      • BLOB
      • IDOC
    • Wenn Sie den MRM- oder IDOC-Parser verwenden, wählen Sie die korrekte Nachrichtengruppe aus der Dropdown-Liste in Nachrichtengruppe.

      Lassen Sie die Nachrichtengruppe bei den XML-, XMLNS-, XMLNSC-, JMS-, MIME- und BLOB-Parsern leer.

    • Wenn Sie den MRM-Parser verwenden, wählen Sie aus der Dropdown-Liste unter Nachrichtenart die entsprechende Nachrichtenart aus. Diese Liste wird mit Nachrichten aufgefüllt, die in der von Ihnen ausgewählten Nachrichtengruppe definiert sind.

      Bei XML-, XMLNS-, XMLNSC-, JMS-, IDOC-, MIME- und BLOB-Parsern erfolgt für Nachrichtenart keine Angabe.

    • Wenn Sie den MRM- oder IDOC-Parser verwenden, wählen Sie aus der Dropdown-Liste unter Nachrichtenformat das entsprechende Format der Nachricht aus. Diese Liste enthält alle physischen Formate, die Sie für diese Nachrichtengruppe definiert haben.

      Lassen Sie das Nachrichtenformat bei den XML-, XMLNS-, XMLNSC-, JMS-, MIME- und BLOB-Parsern leer.

  3. Wählen Sie im Navigator des Eigenschaftendialogs 'Erweitert' aus, und legen Sie Werte für die erweiterten Eigenschaften fest:
    • Wählen Sie aus der Dropdown-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 unter der Synchronisationspunktsteuerung empfangen, wenn 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 nacheinander von einem Sendeknoten weitergegeben wurden, wird bestimmt durch das Persistenzmerkmal der Nachricht, es sei denn, der Sendeknoten oder ein beliebiger anderer nachfolgender Knoten im Nachrichtenfluss hat die Transaktionalität explizit außer Kraft gesetzt.
      • Wenn Sie die Option Ja auswählen, wird die ankommende Nachricht unter Synchronisationspunktsteuerung empfangen. Jede abgeleitete Nachricht, die nachfolgend 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 hat explizit die Transaktionsorientierung außer Kraft gesetzt.
      • Wenn Sie die Option Nein auswählen, wird die ankommende Nachricht 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.
    • Wählen Sie aus der Dropdown-Liste einen Wert für den Generierungsmodus aus, um zu definieren, welche Komponenten der Ausgabenachricht innerhalb des MQAbrufknotens generiert werden, und welche Komponenten der Eingabenachricht entnommen werden.
      • Wenn Sie Keine auswählen, werden alle Komponenten der Nachricht aus der Eingabebaumstruktur unverändert weitergegeben.
      • Bei der Auswahl von Nachricht wird vom Knoten eine neue Nachrichtenkomponente erstellt, die Komponenten 'Lokale Umgebung', 'Umgebung' und 'Ausnahmeliste' aus der Eingabebaumstruktur werden jedoch unverändert weitergegeben. Dies ist die Standardeinstellung für den Generierungsmodus.
      • Bei der 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 der 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.
    • Wenn Sie für den Generierungsmodus entweder Nachricht oder Nachricht und lokale Umgebung festgelegt haben, wählen Sie aus der Dropdown-Liste einen Wert für Nachricht kopieren aus, um zu definieren, welche Teile der Nachricht im MQAbrufknoten generiert werden, und welche Teile der Eingabenachricht entnommen werden.
      • Wenn Sie Keine auswählen, wird kein Teil der Eingabenachricht aus der Eingabebaumstruktur weitergegeben. Dies ist die Standardeinstellung für Nachricht kopieren.
      • Bei der Auswahl von Header kopieren werden die Header aus der Eingabenachricht in der Eingabebaumstruktur unverändert weitergegeben.
      • Bei der Auswahl von Gesamte Nachricht kopieren wird die gesamte Eingabenachricht aus der Eingabebaumstruktur unverändert weitergegeben.
    • Wenn Sie für den Generierungsmodus entweder Lokale Umgebung oder Nachricht und lokale Umgebung festgelegt haben, wählen Sie aus der Dropdown-Liste einen Wert für Lokale Umgebung kopieren aus, um zu definieren, welche Teile der Nachricht im MQAbrufknoten generiert werden, und welche Teile der Eingabenachricht entnommen werden.
      • Bei der Auswahl von Keine wird kein Teil der lokalen Umgebung kopiert.
      • Bei der Auswahl von Gesamte lokale Umgebung kopieren wird die gesamte lokale Umgebung, die in der Eingabenachricht definiert wurde, kopiert. Dies ist die Standardeinstellung für die Eigenschaft Lokale Umgebung kopieren.
    • Geben Sie für die Eigenschaft Warteintervall einen Wert an, um festzulegen, wie viele Millisekunden auf den Empfang einer Nachricht vom MQGET-Aufruf gewartet werden soll. Wenn Sie keinen Wert angeben, wird der Standardwert 1000 Millisekunden verwendet.
    • Geben Sie für die Eigenschaft Mindestgröße für Nachrichtenpuffer einen Wert (in KB) an, um festzulegen, wie groß der anfängliche Puffer für den MQGET-Aufruf sein soll. Der Puffer wird automatisch erweitert, damit Nachrichten aller Größen aufgenommen werden können. Falls jedoch voraussichtlich alle Nachrichten groß sind, sollten Sie bereits zu Beginn einen entsprechend hohen Wert eingeben, damit die Häufigkeit der Größenanpassung des Puffers reduziert wird. Wenn Sie keinen Wert angeben, beträgt die Größe des Puffers anfänglich 4 KB.
  4. Wählen Sie im Navigator des Eigenschaftendialogs 'Auswertung' aus, wenn eine Gegenprüfung des Nachrichtenhauptteils mit dem von der Nachrichtengruppe generierten Dictionary durch den MRM-Parser durchgeführt werden soll. (Wenn eine Nachricht an das Fehlerterminal des Knotens übergeben wird, wird sie nicht ausgewertet.)

    Sie finden detaillierte Informationen hierzu unter Nachrichten überprüfen und Eigenschaften der Gültigkeitsprüfung für Nachrichten in der MRM-Domäne.

  5. Wählen Sie im Navigator des Eigenschaftendialogs 'Anforderung' aus, und legen Sie für die Eigenschaften Werte fest, die bestimmen, wie die Anforderungsparameter erstellt werden.
    • Falls der MQMD, der für den MQGET-Aufruf verwendet werden soll, nicht der Standardadresse InputRoot.MQMD entspricht, geben Sie unter MQMD-Eingabeposition die Adresse des MQMD an.
    • Falls die Position der Parameter für den MQGET-Aufruf (beispielsweise MQGMO-Überschreibungswerte) nicht der Standardadresse InputLocalEnvironment.MQ.GET entspricht, geben Sie unter Position für MQ-Eingabeparameter die entsprechende Adresse an.
    • Bei Auswahl des Markierungsfelds Aus Korrelations-ID abrufen muss das Feld CorrelId der Nachricht, die abgerufen werden soll, mit dem Feld CorrelId unter MQMD-Eingabeposition übereinstimmen. Das Markierungsfeld ist standardmäßig inaktiviert.
    • Bei Auswahl des Markierungsfelds Aus Nachrichten-ID abrufen muss das Feld MsgId der Nachricht, die abgerufen werden soll, mit dem Feld MsgId unter MQMD-Eingabeposition übereinstimmen. Das Markierungsfeld ist standardmäßig inaktiviert.
    • Bei Auswahl des Markierungsfelds Vollständiges Eingabe-MQMD verwenden muss das gesamte MQMD der Nachricht, die abgerufen werden soll, mit dem Wert der MQMD-Eingabeposition auf einer bitweisen Basis übereinstimmen. Das Markierungsfeld ist standardmäßig inaktiviert.
  6. Wählen Sie im Navigator des Eigenschaftendialogs 'Ergebnis' aus, und legen Sie für die Eigenschaften Werte fest, die bestimmen, wie die Ergebnisse des MQGET-Aufrufs gehandhabt werden.
    • Geben Sie unter Position für Ausgabedaten die Startposition innerhalb der Ausgabenachrichtenbaumstruktur ein, bei der die analysierten Elemente aus der abgerufenen Nachrichtenbitfolge gespeichert werden; der Standardwert lautet OutputRoot. Alle Elemente an dieser Adresse werden gelöscht, und die Nachricht der Eingabebaumstruktur wird standardmäßig durch die abgerufene Nachricht ersetzt.

      Sie können alle gültigen ESQL-Feldverweise eingeben. Dazu gehören auch Ausdrücke innerhalb des Verweises sowie neue Feldverweise zur Erstellung eines neuen Knotens innerhalb 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. Weitere Informationen finden Sie unter MQAbrufknoten in einem Anforderung-Antwort-Nachrichtenfluss verwenden.

      Wenn die abgerufene Nachrichtenbitfolge für die Erstellung der Inhalte der Nachrichtenbaumstruktur analysiert wird, werden die Nachrichteneigenschaften verwendet, die Sie als standardmäßige Eigenschaften des Knotens angegeben haben.

    • Legen Sie unter Position für Ergebnisdaten einen Wert fest, um zu steuern, welche untergeordnete Baumstruktur der abgerufenen Nachricht in die Ausgabenachricht gestellt werden soll. Der Standardwert lautet ResultRoot. Dies bedeutet, dass die gesamte abgerufene Nachricht in die Ausgabenachricht gestellt wird. Wenn Sie beispielsweise nur den MQMD aus der abgerufenen Nachricht wünschen, verwenden Sie ResultRoot.MQMD; diese untergeordnete Baumstruktur wird dann an den Ort gestellt, der durch die Position für Ausgabedaten angegeben ist.
    • Legen Sie unter Position für MQ-Ausgabeparameter einen Wert fest, mit dem gesteuert wird, wohin der CC (Completion Code, Bedingungscode), der RC (Return Code) sowie sonstige MQ-Parameter (beispielsweise der vom MQGET-Aufruf verwendete MQMD) in der Ausgabebaumstruktur gestellt werden sollen. Der Standardwert lautet OutputLocalEnvironment.MQ.GET.
    • Legen Sie unter Position für Warndaten einen Wert fest, um zu steuern, wohin die abgerufene Nachricht gestellt werden soll, wenn vom MQGET-Aufruf ein Warncode zurückgegeben wird. Der Standardwert lautet OutputRoot.

      Sie können jeden beliebigen 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. Position für Ergebnisdaten wird nicht für Warndaten verwendet.

  7. Wählen Sie im Navigator des Eigenschaftendialogs 'Allgemeine Nachrichtenoptionen' aus. Die Option Zeitpunkt für Syntaxanalyse ist standardmäßig auf den Wert Bei Bedarf gesetzt. In diesem Fall wird die Auswertung verzögert, bis im Rahmen einer Teilsyntaxanalyse eine Syntaxanalyse erfolgt.

    Wenn Sie für diese Option Sofort auswählen, wird die Teilsyntaxanalyse außer Kraft gesetzt. In diesem Fall werden mit Ausnahme der komplexen Typen mit der Zusammensetzung 'Auswahl' oder 'Nachricht' alle Nachrichtenkomponenten syntaktisch analysiert und ausgewertet, die zu diesem Zeitpunkt nicht aufgelöst werden können. Wenn Sie diese Option in Vollständig ändern, wird die Teilsyntaxanalyse außer Kraft gesetzt. In diesem Fall werden alle Nachrichtenkomponenten syntaktisch analysiert und ausgewertet; komplexe Typen mit der Zusammensetzung 'Auswahl' oder 'Nachricht', die zu diesem Zeitpunkt nicht aufgelöst werden können, verursachen einen Auswertungsfehler.

    Weitere Informationen finden Sie unter Eigenschaften der Gültigkeitsprüfung für Nachrichten in der MRM-Domäne.

    Aktivieren Sie das Markierungsfeld MQRFH2C-Kompaktparser verwenden, wenn der MQRFH2C-Parser verwendet werden soll. Dieses Markierungsfeld ist standardmäßig inaktiviert, d. h. der Kompaktparser wird nicht verwendet.

  8. Wählen Sie im Navigator des Eigenschaftendialogs 'XMLNSC-Parseroptionen' aus, und legen Sie für die Eigenschaften Werte fest, die bestimmen, wie die Anforderungsparameter erstellt werden.

    Weitere Informationen hierzu finden Sie unter Nachrichten unter Verwendung des XMLNSC-Parsers bearbeiten.

  9. Wählen Sie im Navigator des Eigenschaftendialogs 'Beschreibung' aus, um eine Kurzbeschreibung, eine ausführliche Beschreibung oder beides einzugeben.
  10. Klicken Sie auf Übernehmen, um die Änderungen am MQAbrufknoten vorzunehmen, ohne das Dialogfeld mit den Eigenschaften zu schließen, oder klicken Sie auf OK, um die Änderungen zu übernehmen und den Eigenschaftendialog zu schließen.

    Klicken Sie auf Abbrechen, um das Dialogfeld zu schließen und alle Änderungen zu verwerfen, die Sie an den Eigenschaften vorgenommen haben.

Verbindungen zu Terminals herstellen

Verbinden Sie die Ausgangs-, Warnungs- und Fehlerterminals sowie das Ausgabeterminal 'Keine Nachricht' dieses Knotens mit einem anderen Knoten im Nachrichtenfluss, wenn Sie die Nachricht weiterverarbeiten, Fehler verarbeiten oder die Nachricht an eine weitere Zieladresse senden möchten.

Welche Nachrichten an jedes Ausgabeterminal weitergegeben werden hängt von dem Bedingungscode ab, der vom MQGET-Aufruf generiert wird.

Bei einem erfolgreichen MQGET-Aufruf leitet der MQAbrufknoten 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 schwer wiegender ist als eine Warnung, wird die Eingabenachricht an das Fehlerterminal weitergegeben.

Beginn der ÄnderungWenn der MQGET-Aufruf mit dem Ursachencode MQRC_NO_MSG_AVAILABLE fehlschlägt, wird die Ausgabenachricht (ohne Ergebnishauptteil) an das Terminal 'Keine Nachricht' weitergegeben. Die Ausgabenachricht, die an das Terminal 'Keine Nachricht' weitergegeben wird, wird anhand der Werte der Eigenschaften 'Generierungsmodus' und 'Nachricht kopieren' oder 'Lokale Umgebung kopieren' nur aus der Eingabenachricht erstellt.Ende der Änderung

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 nicht mit einem anderen Knoten im Nachrichtenfluss verbinden, wird bei der Weitergabe von Nachrichten an dieses Terminal vom Broker eine Ausnahmebedingung ausgegeben.

Weitere Informationen finden Sie unter Verbindungen zu Fehlerterminals herstellen.

Koordinierte Transaktionen konfigurieren

Wenn Sie einen MQAbrufknoten in einen Nachrichtenfluss einschließen, definiert der Wert, den Sie für den Transaktionsmodus festgelegt haben, ob die Nachrichten unter der Synchronisationspunktsteuerung empfangen werden:

  • Der Wert Ja (Standardeinstellung) bewirkt, dass die Nachricht unter Synchronisationspunktsteuerung empfangen wird (d. h. in einer Arbeitseinheit von WebSphere MQ). Alle Nachrichten, die nacheinander von einem Sendeknoten in derselben Instanz des Nachrichtenflusses gesendet wurden, werden unter die Synchronisationspunktsteuerung gestellt, es sei denn, der Sendeknoten oder ein anderer nachfolgender Knoten hat dies explizit überschrieben.
  • Wenn Sie Automatisch auswählen, wird die Nachricht unter dem Synchronisationspunkt empfangen, wenn die eingehende Nachricht als persistent markiert ist. Ansonsten ist dies nicht der Fall. Alle Nachrichten, die nacheinander von einem Sendeknoten gesendet wurden, werden - wie vom Persistenzmerkmal der ankommenden Nachricht bestimmt - unter Synchronisationspunktsteuerung gestellt, es sei denn, der Sendeknoten oder ein anderer nachfolgender Knoten hat dies explizit überschrieben.
  • Der Wert Nein bewirkt, dass die Nachricht nicht unter Synchronisationspunktsteuerung empfangen wird. Alle Nachrichten, die nacheinander von einem Sendeknoten im Nachrichtenfluss gesendet wurden, werden nicht unter die Synchronisationspunktsteuerung (syncpoint-Bedingung) gestellt, es sei denn, ein einzelner Sendeknoten oder ein anderer nachfolgender Knoten hat dies angegeben.

Terminals und Eigenschaften

In der nachfolgenden Tabelle werden die Terminals des MQAbrufknotens beschrieben.

Terminal Beschreibung
Eingangsterminal 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 Das Ausgabeterminal, an das die Eingabenachricht weitergegeben wird, wenn beim Versuch, eine Nachricht aus der Warteschlange abzurufen, ein Fehler (mit einem Bedingungscode, der schwer wiegender ist als eine Warnung) im Knoten auftritt.
Ausgangsterminal Das Ausgabeterminal, an das die Nachricht weitergeleitet wird, wenn sie erfolgreich von der WebSphere MQ-Warteschlange abgerufen wird.
Keine Nachricht Beginn der ÄnderungDas Ausgabeterminal, an das die Eingabenachricht geleitet wird, wenn in der Warteschlange keine Nachricht zur Verfügung stand. Die Ausgabenachricht, die an das Terminal 'Keine Nachricht' weitergegeben wird, wird anhand der Werte der Eigenschaften 'Generierungsmodus' und 'Nachricht kopieren' oder 'Lokale Umgebung kopieren' nur aus der Eingabenachricht erstellt.Ende der Änderung

Die folgenden Tabellen beschreiben die Knoteneigenschaften; die Spalte mit der Überschrift 'O' gibt an, dass die Eigenschaft obligatorisch ist (beim Eigenschaftendialog mit einem Stern markiert, wenn Sie einen Wert eingeben müssen); die Spalte mit der Überschrift 'K' gibt an, ob die Eigenschaft konfigurierbar ist (Sie können den Wert ändern, wenn Sie den Nachrichtenfluss der BAR-Datei hinzufügen, um sie einzusetzen).

In der nachfolgenden Tabelle werden die Basiseigenschaften des MQAbrufknotens beschrieben.

Eigenschaft M C Standardwert Beschreibung
Name der Warteschlange Ja Ja Keine Der Name der WebSphere MQ-Nachrichtenwarteschlange, aus der dieser Knoten Nachrichten abruft.

In der nachfolgenden Tabelle werden die Standardeigenschaften des MQAbrufknotens beschrieben.

Eigenschaft M C Standardwert Beschreibung
Nachrichtendomäne Nein Nein Keine Die Domäne, die für die Syntaxanalyse der aus der Nachrichtenwarteschlange erhaltene Nachricht verwendet wird.
Nachrichtengruppe Nein Nein Keine Der Name oder die ID der Nachrichtengruppe, in der die aus der Nachrichtenwarteschlange erhaltene Nachricht definiert ist.
Nachrichtenart Nein Nein Keine Der Name der Nachricht, die aus der Nachrichtenwarteschlange erhalten wird.
Nachrichtenformat Nein Nein Keine Der Name des physischen Formats der Nachricht, die aus der Nachrichtenwarteschlange erhalten wird.

In der nachfolgenden Tabelle werden die erweiterten Eigenschaften des MQAbrufknotens beschrieben.

Eigenschaft M C Standardwert Beschreibung
Transaktionsmodus Nein Nein Ja Empfang der ankommenden Nachricht unter Synchronisationspunktsteuerung. Gültige Werte sind Automatisch, Ja und Nein.
Generierungsmodus Nein Nein Nachricht Teile der Nachricht, die aus der Eingabebaumstruktur kopiert werden. Gültige Werte sind Nachricht, Lokale Umgebung, Nachricht und lokale Umgebung und Keine.
Nachricht kopieren Nein Nein Keine Teile der Nachricht, die aus der Eingabebaumstruktur kopiert werden. Gültige Werte sind Keine, Header kopieren und Gesamte Nachricht kopieren.
Lokale Umgebung kopieren Nein Nein   Teile der Nachricht, die aus der Eingabebaumstruktur kopiert werden. Gültige Werte sind Keine und Gesamte lokale Umgebung kopieren.Der Standardwert lautet Gesamte lokale Umgebung kopieren.
Warteintervall Ja Nein 1000 Die maximale Zeitspanne (in Millisekunden), die auf den Erhalt der Nachricht aus der Nachrichtenwarteschlange gewartet wird.
Mindestgröße für Nachrichtenpuffer Ja Nein  4 Die Mindestgröße (in KB) des Abrufpuffers. Der Mindestwert dieser Eigenschaft beträgt 1 Kilobyte.

In der nachfolgenden Tabelle werden die Auswertungseigenschaften des MQAbrufknotens beschrieben.

Der Abschnitt Eigenschaften der Gültigkeitsprüfung für Nachrichten in der MRM-Domäne enthält eine ausführliche Beschreibung dieser Eigenschaften.
Eigenschaft M C Standardwert Beschreibung
Auswerten Nein Ja Keine Durchführung einer Auswertung. Gültige Werte sind Keine, Inhalt, Inhalt und Wert und Übernehmen.
Aktion bei Fehler Nein Nein Ausnahme Aktion beim Fehlschlagen einer Gültigkeitsprüfung. Diese Eigenschaft kann nur festgelegt werden, wenn Auswerten auf Inhalt oder Inhalt und Wert gesetzt wird. Gültige Werte sind Benutzertrace, Lokales Fehlerprotokoll, Ausnahmebedingung und Ausnahmeliste.
Alle Wertvorgaben einschließen Nein Nein True Diese Eigenschaft kann nicht bearbeitet werden. Die Standardaktion (ausgewähltes Markierungsfeld) besteht darin, dass in der Auswertung von Inhalt und Wert auch Basisprüfungen der Wertvorgaben ausgeführt werden.
Korrektur Nein Nein Keine Diese Eigenschaft kann nicht bearbeitet werden.

In der nachfolgenden Tabelle werden die Anforderungseigenschaften des MQAbrufknotens beschrieben.

Eigenschaft M C Standardwert Beschreibung
MQMD-Eingabeposition Nein Nein   Gibt an, an welcher Stelle im Aufbau der Eingabenachricht sich der MQMD befindet, der für den MQGET-Aufruf verwendet werden soll. Die Standardposition ist InputRoot.MQMD.
Position für MQ-Eingabeparameter Nein Nein   Gibt an, an welcher Stelle im Aufbau der Eingabenachricht sich die MQ-Parameter befinden (beispielsweise die anfängliche Puffergröße und die MQGMO-Überschreibungswerte). Die Standardposition ist InputLocalEnvironment.MQ.GET.
Aus Korrelations-ID abrufen Nein Nein False Wird dieses Markierungsfeld ausgewählt, werden nur Nachrichten mit der angegebenen Korrelations-ID abgerufen.
Aus Nachrichten-ID abrufen Nein Nein False Wird dieses Markierungsfeld ausgewählt, werden nur Nachrichten mit der angegebenen Nachrichten-ID abgerufen.
Vollständiges Eingabe-MQMD verwenden Nein Nein False Wird dieses Markierungsfeld ausgewählt, wird der gesamte MQMD verwendet. Andernfalls werden nur die Nachrichten-ID und Korrelations-ID verwendet.

In der nachfolgenden Tabelle werden die Ergebniseigenschaften des MQAbrufknotens beschrieben.

Eigenschaft M C Standardwert Beschreibung
Position für Ausgabedaten Nein Nein OutputRoot Gibt an, an welche Stelle die Ausgabedaten gestellt werden. Wird kein Wert angegeben, wird 'OutputRoot' als Standardwert verwendet.
Position für Ergebnisdaten Nein Nein ResultRoot Gibt an, welche Unterverzeichnisstruktur (der abgerufenen Nachricht) verwendet werden soll. Wenn kein Wert angegeben wird, wird 'ResultRoot' als Standardwert übernommen, und die gesamte abgerufene Nachricht wird verwendet. Wird beispielsweise ResultRoot.MQMD.ReplyToQ angegeben, wird nur diese untergeordnete Baumstruktur verwendet.
Position für MQ-Ausgabeparameter Nein Nein   Gibt an, an welcher Stelle sich die MQ-Ausgabeparameter befinden. Wird kein Wert angegeben, wird 'OutputLocalEnvironment.MQ.GET' als Standardwert verwendet. Der Generierungsmodus sollte so festgelegt werden, dass 'LocalEnvironment' eingeschlossen wird. In diesem Fall ist sichergestellt, dass die aktualisierten Werte in nachgeschalteten Knoten sichtbar sind. Die Standardposition ist OutputLocalEnvironment.MQ.GET.
Position für Warndaten Nein Nein OutputRoot Gibt an, an welche Stelle die Ausgabedaten gestellt werden, wenn von MQGET ein Warncode ausgegeben wird. Wird kein Wert angegeben, wird 'OutputRoot' als Standardwert verwendet.

In der nachfolgenden Tabelle werden die Eigenschaften der allgemeinen Nachrichtenoptionen des MQAbrufknotens 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.

Der Abschnitt Bedarfsgerechte Syntaxanalyse enthält eine ausführliche Beschreibung dieser Eigenschaft.

MQRFH2C-Kompaktparser für MQRFH2-Domäne verwenden Nein Nein False Durch diese Eigenschaft wird gesteuert, ob der MQRFH2C Compact Parser anstelle des MQRFH2-Parsers für MQRFH2-Header verwendet wird.

In der nachfolgenden Tabelle werden die Eigenschaften der XMLNSC-Parseroptionen des MQAbrufknotens beschrieben.

Eigenschaft M C Standardwert Beschreibung
XMLNSC-Kompaktparser für XMLNS-Domäne verwenden Nein Nein False Beginn der ÄnderungDurch diese Eigenschaft können Sie steuern, ob der XMLNSC-Kompaktparser für Nachrichten in der XMLNS-Domäne verwendet wird. Wenn Sie diese Eigenschaft festlegen, werden die Nachrichtendaten unter XMLNSC in Knoten angezeigt, die mit dem Ausgabeterminal verbunden sind, wenn der RFH2-Eingabeheader oder die Standardeigenschaftendomäne XMLNS ist.Ende der Änderung
Residenter Modus für gemischten Inhalt Nein Nein Keine Mit dieser Eigenschaft können Sie steuern, ob der XMLNSC-Parser Elemente in der Nachrichtenbaumstruktur erstellt, wenn er gemischten Text in einer Eingabenachricht feststellt. Gültige Werte sind Keine und Alle. Bei der Auswahl von Alle werden für gemischten Text Elemente erstellt. Bei der Auswahl von Keine wird gemischter Text ignoriert, und es werden keine Elemente erstellt.
Residenter Modus für Kommentare Nein Nein Keine Mit dieser Eigenschaft können Sie steuern, ob der XMLNSC-Parser Elemente in der Nachrichtenbaumstruktur erstellt, wenn er Kommentare in einer Eingabenachricht feststellt. Gültige Werte sind Keine und Alle. Bei der Auswahl von Alle werden für Kommentare Elemente erstellt. Bei der Auswahl von Keine werden Kommentare ignoriert, und es werden keine Elemente erstellt.
Residenter Modus für Verarbeitungsanweisungen Nein Nein Keine Mit dieser Eigenschaft können Sie steuern, ob der XMLNSC-Parser Elemente in der Nachrichtenbaumstruktur erstellt, wenn er Verarbeitungsanweisungen in einer Eingabenachricht feststellt. Gültige Werte sind Keine und Alle. Bei der Auswahl von Alle werden für Verarbeitungsanweisungen Elemente erstellt. Bei der Auswahl von Keine werden Verarbeitungsanweisungen ignoriert, und es werden keine Elemente erstellt.

In der nachfolgenden Tabelle werden die Beschreibungseigenschaften des MQAbrufknotens beschrieben.

Eigenschaft M C Standardwert Beschreibung
Kurzbeschreibung Nein Nein Kurze Beschreibung des Knotens
Ausführliche Beschreibung Nein Nein Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt.
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
ac20806_