MQInput-Knoten

Mit dem MQInput-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.

Dieses Thema ist in folgende Abschnitte eingeteilt:

Zweck

Der MQInputsknoten empfängt eine Nachricht von einer WebSphere MQ-Nachrichtenwarteschlange, die beim Warteschlangenmanager des Brokers definiert wurde. Der Knoten liest mittels MQGET 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.

Nachrichtenflüsse, die Nachrichten über WebSphere MQ-Verbindungen bearbeiten, müssen immer mit einem MQInputsknoten starten. Sie können die Eigenschaften des MQInputsknotens so festlegen, dass sie die Art und Weise des Empfangs von Nachrichten steuern, indem sie dafür sorgen, dass geeignete MQGET-Optionen eingestellt werden. Beispiel: Sie können angeben, dass eine Nachricht unter Transaktionssteuerung verarbeitet wird. Sie können ebenfalls bestimmen, dass beim Empfang von jeder Eingabenachricht eine Datenkonvertierung durchgeführt wird.

Der MQInput-Knoten bearbeitet Nachrichten in den folgenden Nachrichtendomänen:
  • MRM
  • XMLNSC
  • XMLNS
  • DataObject
  • JMSMap
  • JMSStream
  • MIME
  • BLOB
  • IDOC (diese Domäne ist veraltet; verwenden Sie MRM)
  • XML (diese Domäne ist veraltet; verwenden Sie XMLNSC)

Sie können jeden der unterstützten Sendeknoten, einschließlich der benutzerdefinierten Sendeknoten, in einen Nachrichtenfluss aufnehmen, der mit einem MQInputsknoten beginnt; es ist nicht erforderlich, einen MQOutputknoten aufzunehmen. Sie können einen Nachrichtenfluss erstellen, der Nachrichten von WebSphere MQ-Clients empfängt und für Clients generiert, die für die Verbindung mit dem Broker eines der unterstützten Transportprotokolle verwenden. Dies ist möglich, weil Sie den Nachrichtenfluss so konfigurieren können, dass er beim Broker die erforderliche Konvertierung anfordert.

Wenn Sie einen Nachrichtenfluss erstellen, der als untergeordneter Nachrichtenfluss eingesetzt werden soll, können Sie keinen Standardempfangsknoten verwenden. Sie müssen eine Instanz des Inputsknotens als ersten Knoten verwenden, um ein Eingangsterminal für den untergeordneten Nachrichtenfluss zu erstellen.

Wenn Ihr Nachrichtenfluss keine Nachrichten über WebSphere MQ-Verbindungen empfängt, können Sie einen der unterstützten Empfangsknoten auswählen.

Der MQInputknoten ist in der WebSphere MQ-Ablage der Palette enthalten und wird in der Workbench durch folgendes Symbol dargestellt:

Symbol für MQEmpfangsknoten

Den MQInputsknoten in einem Nachrichtenfluss verwenden

Den MQInputsknoten konfigurieren

Nachdem Sie eine Instanz des MQInputsknotens in einen Nachrichtenfluss eingereiht haben, können Sie den Knoten konfigurieren; siehe Nachrichtenflussknoten konfigurieren. Die Eigenschaften des Knotens werden in der Ansicht 'Eigenschaften' angezeigt.

Alle obligatorischen Eigenschaften, für die kein Standardwert definiert ist, sind mit einem Sternchen gekennzeichnet.

Konfigurieren Sie den MQInput-Knoten:

  1. Optional: Geben Sie auf der Registerkarte Beschreibung eine Kurzbeschreibung, eine ausführliche Beschreibung oder beides ein. Sie können den Knoten dort auch umbenennen.
  2. Geben Sie auf der Registerkarte Grundeinstellung den Namen der Warteschlange ein, von der der Nachrichtenfluss Nachrichten empfängt. 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. Diese Eigenschaft muss angegeben werden.
  3. Legen Sie auf der Registerkarte Syntaxanalyse der Eingabenachricht Werte für die Eigenschaften zur Beschreibung der Nachrichtendomäne, der Nachrichtengruppe, des Nachrichtentyps und des Nachrichtenformats fest, auf deren Basis der Knoten die Vorgehensweise bei der Syntaxanalyse der eingehenden Nachricht bestimmt.
    Wenn die eingehende Nachricht 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, z. B.:
    <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 aus der Liste unter Nachrichtendomäne den Namen des Parsers aus, den Sie verwenden möchten. Wenn kein MQRFH2-Header vorhanden ist, um den Wert für die Nachrichtendomäne bereitzustellen, können sie den Eigenschaftswert aus der Liste auswählen. Sie können entweder eine Option auswählen oder die Eigenschaft leer lassen; in diesem Fall ist der verwendete Standardwert BLOB. Es stehen folgende Optionen zur Auswahl:
      • MRM
      • XMLNSC
      • XMLNS
      • DataObject
      • JMSMap
      • JMSStream
      • MIME
      • BLOB
      • IDOC (diese Domäne ist veraltet; verwenden Sie MRM)
      • XML (diese Domäne ist veraltet; verwenden Sie XMLNSC)
    • Wenn Sie den MRM- oder IDOC-Parser oder den XMLNSC-Parser im Prüfungsmodus verwenden, wählen Sie die Nachrichtengruppe aus, die verwendet werden soll. Diese Liste wird mit verfügbaren Nachrichtengruppen gefüllt, wenn Sie MRM, XMLNSC oder IDOC als Domäne auswählen.
    • Wenn Sie den MRM-Parser verwenden, wählen Sie aus der Liste unter Nachrichtentyp den Nachrichtentyp aus. Diese Liste wird mit Nachrichten aufgefüllt, die in der von Ihnen ausgewählten Nachrichtengruppe definiert sind.
    • Wenn Sie den MRM- oder IDOC-Parser verwenden, wählen Sie aus der Liste unter Nachrichtenformat das gewünschte Format aus. Diese Liste enthält alle physischen Formate, die Sie für diese Nachrichtengruppe definiert haben.
  4. Auf der untergeordneten Registerkarte Parser-Optionen:
    1. Die Option Zeitpunkt für Syntaxanalyse ist standardmäßig auf Bei Bedarf gesetzt, d. h., die Analyse der Nachricht wird verschoben. Der Abschnitt Bedarfsgerechte Syntaxanalyse enthält Informationen zur sofortigen Analyse von Nachrichten.
    2. Aktivieren Sie MQRFH2C-Kompaktparser für MQRFH2-Header verwenden, wenn der MQRFH2C-Parser verwendet werden soll. Dieses Kontrollkästchen ist standardmäßig inaktiviert, d. h., der Kompaktparser wird nicht verwendet.
    3. Wenn Sie den XMLNSC-Parser verwenden, legen Sie die Werte für die Eigenschaften fest, die bestimmen, wie der XMLNSC-Parser vorgeht. Der Abschnitt Nachrichten in der XMLNSC-Domäne bearbeiten enthält weitere Informationen hierzu.
  5. Legen Sie auf der Registerkarte Erweitert Eigenschaften für die Vorgehensweise bei der Verarbeitung der Nachricht, z. B. ihre Transaktionsmerkmale, fest. Viele dieser Eigenschaften sind Optionen im MQGET-Aufruf zugeordnet.
    • Wählen Sie in der Liste die Option Transaktionsmodus aus, um die transaktionsorientierten Merkmale für die Handhabung dieser Nachricht zu definieren:
      • Bei der Auswahl von Automatisch wird die ankommende Nachricht unter Synchronisationspunktsteuerung empfangen, wenn sie als 'persistent' markiert ist; andernfalls wird sie unter dem Synchronisationspunkt nicht empfangen. Die Transaktionalität aller abgeleiteten Nachrichten, die später von einem Sendeknoten gesendet werden, hängt vom eingehenden Persistenzmerkmal ab, es sei denn, die Transaktionalität wurde vom Sendeknoten explizit außer Kraft gesetzt.
      • Bei der Auswahl von Ja wird die ankommende Nachricht unter Synchronisationspunktsteuerung empfangen. Alle abgeleiteten Nachrichten, die später von einem Sendeknoten in derselben Instanz des Nachrichtenflusses gesendet werden, werden transaktionsorientiert gesendet, es sei denn, die Transaktionalität wurde vom Sendeknoten explizit außer Kraft gesetzt.
      • Bei Auswahl von Nein wird die ankommende Nachricht nicht unter Synchronisationspunktsteuerung empfangen. Alle abgeleiteten Nachrichten, die später von einem Sendeknoten im Nachrichtenfluss gesendet werden, werden nicht transaktionsorientiert gesendet, es sei denn, für den Sendeknoten gilt, dass die Nachrichten der Synchronisationspunktsteuerung unterliegen.
    • Wählen Sie aus der Liste die Option Modus für Reihenfolge aus, um die Reihenfolge festzulegen, in der Nachrichten aus der Eingabewarteschlange abgerufen werden sollen. Diese Eigenschaft wirkt sich nur aus, wenn die Eigenschaft Zusätzliche Instanzen auf der Registerkarte Instanzen auf einen Wert größer als null gesetzt ist; d. h., wenn die Eingabewarteschlange von mehreren Threads gelesen wird. Gültige Werte sind:
      • Standardwert. Die Nachrichten werden in der durch die Warteschlangenattribute festgelegten Reihenfolge abgerufen, die jedoch nicht garantiert ist, da die Nachrichten vom Nachrichtenfluss verarbeitet werden.
      • Nach Benutzer-ID. Nachrichten mit derselben Benutzer-ID im MQMD werden in der durch die Warteschlangenattribute festgelegten Reihenfolge abgerufen und verarbeitet; diese Reihenfolge wird bei der Verarbeitung der Nachrichten garantiert eingehalten. Eine Nachricht, die einer bestimmten Benutzer-ID, die von einem Thread verarbeitet wird, zugeordnet ist, wird vollständig verarbeitet, bevor derselbe Thread oder ein anderer Thread mit der Verarbeitung einer anderen Nachricht mit derselben Benutzer-ID beginnen kann. Andere Reihenfolgen werden nicht garantiert.
      • Nach WS-Reihenfolge. Nachrichten werden von diesem Knoten in der durch die Warteschlangenattribute festgelegten Reihenfolge abgerufen und verarbeitet; diese Reihenfolge wird bei der Verarbeitung der Nachrichten garantiert eingehalten. Dieses Verhalten entspricht dem Verhalten, das gilt, wenn die Eigenschaft Zusätzliche Instanzen auf null gesetzt ist.

      Weitere Informationen zur Verwendung dieser Option finden Sie im Abschnitt Knoten für die Handhabung von Nachrichtengruppen konfigurieren.

    • Aktivieren Sie Logische Reihenfolge, wenn Sie sicherstellen möchten, dass Nachrichten, die Bestandteil einer Nachrichtengruppe sind, in der Reihenfolge empfangen werden, die von der sendenden Anwendung festgelegt wurde. Diese Option wird der Option MQGMO_LOGICAL_ORDER des MQGMO-Aufrufs der MQI-Schnittstelle zugeordnet.

      Wenn Sie dieses Kontrollkästchen inaktivieren, werden Nachrichten, die als Teil einer Gruppe gesendet werden, nicht in einer vorgegebenen Reihenfolge empfangen. Wenn ein Broker den Empfang von Nachrichten in Gruppen erwartet und dieses Kontrollkästchen nicht aktiviert ist, ist entweder die Reihenfolge der Eingabenachrichten nicht von Bedeutung, oder der Nachrichtenfluss muss so entwickelt werden, dass diese auf eine geeignete Weise verarbeitet werden.

      Sie müssen auch Festschreiben nach Nachrichtengruppe auswählen, wenn die Nachrichtenverarbeitung erst nach dem Empfang der letzten Nachricht einer Gruppe und deren Verarbeitung festgeschrieben werden soll.

      Weitere Informationen zu den Optionen, zu denen diese Eigenschaft eine Zuordnung durchführt, finden Sie im Abschnitt "Application Programming Reference" im WebSphere MQ Version 6 Information Center online.

      Weitere Informationen zur Verwendung dieser Option finden Sie im Abschnitt Knoten für die Handhabung von Nachrichtengruppen konfigurieren.

    • Aktivieren Sie Alle Nachrichten verfügbar, wenn der Nachrichtenabruf und die Nachrichtenverarbeitung nur erfolgen sollen, wenn alle Nachrichten in einer einzigen Gruppe verfügbar sind. Diese Eigenschaft wird der Option MQGMO_ALL_MSGS_AVAILABLE des MQGMO-Aufrufs der MQI-Schnittstelle zugeordnet. Heben Sie die Auswahl dieses Kontrollkästchens auf, wenn die Nachrichtenabfrage nicht davon abhängt, dass alle Nachrichten in einer Gruppe verfügbar sind, bevor die Verarbeitung beginnt.

      Weitere Informationen zu den Optionen, zu denen diese Eigenschaft eine Zuordnung durchführt, finden Sie im Abschnitt "Application Programming Reference" im WebSphere MQ Version 6 Information Center online.

    • Geben Sie unter Nachrichten-ID vergleichen eine Nachrichten-ID ein, wenn der Empfangsknoten nur Nachrichten empfangen soll, die im Feld 'MsgId' des MQMD einen übereinstimmenden Wert für die Nachrichten-ID enthalten.

      Geben Sie eine gerade Zahl bestehend aus hexadezimalen Ziffern (die Zeichen 0 bis 9, A bis F und a bis f sind gültig) ein. Es sind maximal 48 Ziffern zulässig. Wenn die von Ihnen eingegebene ID kürzer als die Größe des MsgId-Feldes ist, wird sie rechts mit X'00' Zeichen aufgefüllt. Diese Eigenschaft wird der Option MQMO_MATCH_MSG_ID des MQGMO-Aufrufs der MQI-Schnittstelle zugeordnet.

      Lassen Sie diese Eigenschaft leer, wenn der Empfangsknoten nicht prüfen soll, ob die Nachrichten-ID passt.

      Weitere Informationen zu den Optionen, zu denen diese Eigenschaft eine Zuordnung durchführt, finden Sie im Abschnitt "Application Programming Reference" im WebSphere MQ Version 6 Information Center online.

    • Geben Sie in Korrelations-ID vergleichen eine Nachrichten-ID ein, wenn der Empfangsknoten nur Nachrichten empfangen soll, die einen passenden Korrelations-ID-Wert im CorrelId-Feld des MQMD enthalten.

      Geben Sie eine gerade Zahl bestehend aus hexadezimalen Ziffern (die Zeichen 0 bis 9, A bis F und a bis f sind gültig) ein. Es sind maximal 48 Ziffern zulässig. Wenn die von Ihnen eingegebene ID kürzer als die Größe des CorrelId-Feldes ist, wird sie rechts mit X'00' Zeichen aufgefüllt. Diese Eigenschaft wird der Option MQMO_MATCH_CORREL_ID des MQGMO-Aufrufs der MQI-Schnittstelle zugeordnet.

      Lassen Sie diese Eigenschaft leer, wenn der Empfangsknoten nicht prüfen soll, ob die CorrelID passt.

      Weitere Informationen zu den Optionen, zu denen diese Eigenschaft eine Zuordnung durchführt, finden Sie im Abschnitt "Application Programming Reference" im WebSphere MQ Version 6 Information Center online.

    • Aktivieren Sie Konvertieren, wenn WebSphere MQ für die Nachricht bei deren Abruf aus der Warteschlange eine Datenkonvertierung durchführen soll. Diese Option ist nützlich, wenn Sie Nachrichten in der BLOB-Domäne verarbeiten oder benutzerdefinierte Parser verwenden. Wählen Sie diese Option jedoch nicht aus, wenn Sie Nachrichten der XML- oder MRM-Domäne analysieren möchten. Die Konvertierung wird nämlich vom Parser ausführt.

      WebSphere MQ konvertiert die ankommende Nachricht in die Codierung und den codierten Zeichensatz, die im MQMD angegeben sind, der vom Empfangsknoten beim MQGET-Aufruf zum Abrufen der Nachricht aus der Eingabewarteschlange bereitgestellt wird. Der Broker verwendet die Option MQGMO_CONVERT für den MQGET-Aufruf. Es gelten die üblichen Regeln der WebSphere MQ-Konvertierung. Die Werte, die Sie in den Optionen Codierung bei Konvertierung und ID von codiertem Zeichensatz bei Konvertierung festlegen, werden in den Feldern MsgDesc Encoding und CCSID des MQGET-Aufrufs verwendet. WebSphere MQ kann die eingehende Nachricht nur dann konvertieren, wenn das MQMD-Feld Format ein integrierter MQ-Wert ist, der Zeichendaten erkennt, oder wenn es in WebSphere MQ einen Datenkonvertierungsexit gibt.

      Diese Eigenschaft wird der Option MQGMO_CONVERT des MQGMO-Aufrufs der MQI-Schnittstelle zugeordnet.

      Inaktivieren Sie das Kontrollkästchen, wenn die Nachricht nicht von WebSphere MQ konvertiert werden soll.

      Wenn Sie dieses Kontrollkästchen aktivieren, können Sie auch Folgendes angeben:

      • Codierungskonvertierung. Geben Sie die Nummer der Codierung ein, in die numerische Daten im Nachrichtenhauptteil konvertiert werden sollen. Gültige Werte sind:
        • Windows platform 546 für DOS und all Windows-Systeme
        • Linux platform UNIX platform 273 für alle Linux- und UNIX-Systeme
        • z/OS platform 785 für z/OS-Systeme
        Die Codierung wird nur in folgenden Fällen verwendet:
        • Wenn ein benutzerdefinierter Datenkonvertierungsexit von WebSphere MQ die Codierung verwendet.
        • Wenn der integrierte WebSphere MQ-Konvertierungsexit die Codierung verwendet, um Nachrichten in irgendeins der vordefinierten WebSphere MQ-Formate zu konvertieren.
        Falls Sie einen falschen Wert angeben, wird keine Konvertierung durchgeführt.
      • CCSID-Konvertierung. Geben Sie den Wert für die Zeichensatzkennung (CCSID) ein, in die Zeichendaten im Nachrichtenhauptteil konvertiert werden sollen.

        Falls Sie einen falschen Wert angeben, wird keine Konvertierung durchgeführt.

      Weitere Informationen zur WebSphere MQ-Datenkonvertierung und zu Gründen für die Verwendung dieser Option finden Sie im Abschnitt "Application Programming Guide" im WebSphere MQ Version 6 Information Center online. Weitere Informationen über die Werte, die für Codierung bei Konvertierung und ID von codiertem Zeichensatz bei Konvertierung angegeben werden können, erhalten Sie im Anwendungsprogrammierungsreferenz-Abschnitt des WebSphere MQ Version 6 Information Center online Version 5.3.

    • Aktivieren Sie Festschreiben nach Nachrichtengruppe, wenn die Nachrichtenverarbeitung erst nach dem Empfang der letzten Nachricht einer Gruppe und deren Verarbeitung festgeschrieben werden soll. Wenn Sie dieses Kontrollkästchen nicht aktivieren, wird nach jeder vollständigen Übergabe einer Nachricht im Nachrichtenfluss eine Festschreibung vorgenommen.

      Diese Eigenschaft ist nur von Bedeutung, wenn Sie Logische Reihenfolge ausgewählt haben.

      Setzen Sie die Eigenschaft Modus für Reihenfolge auf Nach WS-Reihenfolge, wenn die Nachrichten in einer Gruppe in der Reihenfolge abgerufen und verarbeitet werden müssen, in der sie in der Warteschlange angezeigt werden.

    • z/OS platform Nur unter z/OS: Geben Sie bei Serialisierungs-Token für z/OS ein Serialisierungs-Token ein, wenn der serialisierte Zugriff auf gemeinsam genutzte Ressourcen, die von WebSphere MQ bereitgestellt werden, genutzt werden soll.

      Der Wert, den Sie für das Serialisierungs-Token angeben, muss den Regeln entsprechen, die im Abschnitt "Application Programming Reference" im WebSphere MQ Version 6 Information Center online beschrieben sind.

      Weitere Informationen zur Serialisierung und gemeinsamen Warteschlangennutzung bei z/OS erhalten Sie im Abschnitt 'Concepts and Planning Guide' des WebSphere MQ Version 6 Information Center online Version 5.3.

    • Optional: Sie können über die Eigenschaft Thema einer Nachricht ein Publish/Subscribe-Thema zuordnen. Im Namen des Themas können alle Zeichen eingegeben werden. Wenn Nachrichten den MQInput-Knoten durchlaufen, übernehmen sie jeden von Ihnen eingegebenen Themennamen. (Bei Verwendung von Publish/Subscribe können Sie ein Thema abonnieren und alle Nachrichten anzeigen, die den MQInputsknoten unter diesem Themanamen durchlaufen haben.) Wenn die ankommende Nachricht einen MQRFH2-Header enthält, müssen Sie keinen Wert für die Eigenschaft Thema festlegen, weil der Wert aus dem Ordner <psc> im MQRFH2-Header abgerufen werden kann, z. B.:
      <psc><Thema>Börsennotierung</Thema></psc>
      Wenn Sie für die Eigenschaft Thema einen Wert festlegen und dieser vom <Thema>-Wert im MQRFH2-Header abweicht, hat der Wert im MQRFH2-Header Vorrang.
    • Wählen Sie Nur anzeigen aus, um anzugeben, dass die Nachricht in der Warteschlange bleiben soll, wenn sie gelesen wird. Wenn Sie diese Option auswählen, wird OutputLocalEnvironment.MQ.GET.Browsed auf 'true' gesetzt, wenn eine Nachricht an das Ausgabeterminal des MQInput-Knotens weitergeleitet wird.
    • Geben Sie für Suchzeitlimit (ms) zurücksetzen einen Wert an, um die Zeitspanne in Millisekunden zwischen der letzten auswählbaren Nachricht, die gerade in der Eingabewarteschlange durchsucht wird, und der Rücksetzung der Durchsuchung auf den Anfang der Warteschlange festzulegen. Wenn Sie keinen Wert angeben, wird der Standardwert -1 verwendet, um anzuzeigen, dass die Durchsuchung nicht zurückgesetzt wird.
  6. Legen Sie auf der Registerkarte Auswertung die Auswertungseigenschaften fest, wenn der Parser den Hauptteil von Nachrichten anhand der Nachrichtengruppe überprüfen soll. (Wenn eine Nachricht an das Fehlerterminal des Knotens übergeben wird, wird sie nicht ausgewertet.)

    Sie finden weitere Informationen hierzu in den Abschnitten Nachrichten überprüfen und Auswertungseigenschaften.

  7. Optional: Geben Sie auf der Registerkarte Sicherheit die Werte für die Eigenschaften an, die die Extraktion einer Identität aus einer Nachricht steuern (wenn dem Knoten ein Sicherheitsprofil zugeordnet ist).
    • Optional: Wählen Sie eine Option in der Liste Identitätstokentyp aus, um den Identitätstyp in der eingehenden Nachricht anzugeben. Wenn Sie für diese Option den Standardwert angeben, wird die Identität aus den Transport-Headern abgerufen, und der Typ wird auf Benutzername gesetzt.
    • Optional: Geben Sie in Position des Identitätstokens den Standort in der Nachricht an, an dem die Identität angegeben wird. Wenn Sie diese Option leer lassen, wird die Identität aus dem Transport-Header 'MQMD.UserIdentifier' abgerufen.
    • Optional: Geben Sie in Position des Identitätstokens den Standort in der Nachricht an, an dem das Kennwort angegeben wird. Diese Option kann nur festgelegt werden, wenn der Identitätstokentyp auf Benutzername + Kennwort gesetzt ist. Wenn Sie keine Position angeben, wird das Kennwort nicht gesetzt.
    • Optional: Geben Sie in Identität-issuedBy-Position die Position in der Nachricht an, an dem der Aussteller der Identität angegeben wird. Wenn Sie keine Position angeben, wird der Wert 'MQMD.PutApplName' verwendet. Wenn Sie das Feld Identität-issuedBy-Position frei lassen und auch 'MQMD.PutApplName' leer ist, wird die Zeichenfolge MQ verwendet.
    • Optional: Wählen Sie Sicherheitsausnahmen als normale Ausnahmebedingungen behandeln aus, wenn Sicherheitsausnahmebedingungen wie z. B. 'Zugiff verweigert' als normale Ausnahmebedingungen behandelt und an das Fehlerterminal weitergegeben werden sollen (falls es angeschlossen ist).

    Sie finden weitere Informationen hierzu in den Abschnitten Nachrichtenflusssicherheit und Nachrichtenflusssicherheit einrichten.

  8. Optional: Geben Sie auf der Registerkarte Instanzen die Werte für die Eigenschaften an, welche die zusätzlichen Instanzen kontrollieren, die für einen Knoten verfügbar sind. Nähere Informationen finden Sie unter Konfigurierbare Nachrichtenflusseigenschaften.

Verbindungen zu Terminals herstellen

Der MQInputsknoten leitet jede Nachricht, die er erfolgreich empfängt, an das Ausgangsterminal weiter. Schlägt die Weiterleitung fehl, wird die Nachricht erneut weitergeleitet. Wenn der Rücksetzungszähler überschritten wird (festgelegt durch das Attribut 'BackoutThreshold' der Eingabewarteschlange), wird die Nachricht an das Fehlerterminal weitergeleitet. Sie können Knoten mit diesem Terminal verbinden, um diese Situation zu handhaben. Wenn keine Verbindung zum Fehlerterminal besteht, wird die Nachricht in die Rücksetzungswarteschlange geschrieben.

Wenn die Nachricht von diesem Knoten abgefangen wird, nachdem eine Ausnahmebedingung weiter vorne im Nachrichtenfluss ausgelöst wurde, wird die Nachricht an das Catch-Terminal weitergeleitet. Wenn keine Verbindung zum Catch-Terminal besteht, durchläuft die Nachricht den Knoten kontinuierlich in einer Schleife, bis das Problem behoben ist.

Sie müssen eine Rücksetzungswarteschlange oder eine Warteschlange für nicht zustellbare Nachrichten (DLQ) definieren, um die kontinuierliche Schleife der Nachricht im Knoten zu vermeiden.

Koordinierte Transaktionen konfigurieren

Wenn Sie einen MQInput-Knoten in einen Nachrichtenfluss einschließen, definiert der Wert, den Sie für den Transaktionsmodus festgelegt haben, ob die Nachrichten unter der Synchronisationspunktsteuerung empfangen werden:
  • Wird der Wert für die Eigenschaft auf Automatisch gesetzt, erfolgt der Empfang der Nachricht nur dann unter der Synchronisationspunktsteuerung, wenn die eingehende Nachricht als persistent markiert ist; ist dies nicht der Fall, wird sie nicht unter dem Synchronisationspunkt empfangen. Alle Nachrichten, die später von einem Sendeknoten gesendet werden, unterliegen der Synchronisationspunktsteuerung (wie vom Persistenzmerkmal der ankommenden Nachricht bestimmt), es sei denn, der Sendeknoten hat dies explizit außer Kraft gesetzt.
  • Wird der Wert für die Eigenschaft auf Ja (Standardeinstellung) gesetzt, wird die Nachricht unter der Synchronisationspunktsteuerung, d. h. in einer Arbeitseinheit von WebSphere MQ empfangen. Alle Nachrichten, die später von einem Sendeknoten in derselben Instanz des Nachrichtenflusses gesendet werden, unterliegen der Synchronisationspunktsteuerung, es sei denn, der Sendeknoten hat dies explizit außer Kraft gesetzt.
  • Wird der Wert für die Eigenschaft auf Nein gesetzt, unterliegt der Empfang der Nachricht 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 hat dies explizit vorgegeben.
Der MQOutputknoten ist der einzige Sendeknoten, der so konfiguriert werden kann, dass diese Option außer Kraft gesetzt wird.

Wenn Sie die Eigenschaft Nur anzeigen festgelegt haben, wird der Wert ignoriert, der für die Eigenschaft Transaktionsmodus festgelegt ist, da eine Nachricht unter dem Synchronisationspunkt nicht angezeigt werden kann. Alle abgeleiteten Nachrichten, die allerdings später von einem Sendeknoten in derselben Instanz des Nachrichtenflusses weitergegeben werden, weisen das gleiche Verhalten auf, das zuvor gemäß dem angegebenen Transaktionsmodus-Wert beschrieben wird.

Knoten für die Handhabung von Nachrichtengruppen konfigurieren

WebSphere MQ unterstützt Nachrichtengruppen. Sie können festlegen, dass eine Nachricht zu einer Gruppe gehört und ihre Verarbeitung sowie die Verarbeitung aller anderen Nachrichten in der Gruppe als eine Transaktion gehandhabt werden müssen, d. h., wenn die Verarbeitung einer Nachricht in der Gruppe fehlschlägt, werden sämtliche Nachrichten in der Gruppe zurückgesetzt. Die Nachrichtenverarbeitung wird nach erfolgreicher Verarbeitung aller Nachrichten festgeschrieben.

Wenn Sie Nachrichten in einer Gruppe einschließen und es wichtig ist, dass alle Nachrichten in der Gruppe von der Warteschlange gelesen und in der Reihenfolge verarbeitet werden, in der sie in der Gruppe definiert sind, müssen Sie alle der folgenden Aktionen durchführen:

  • Aktivieren Sie Festschreiben nach Nachrichtengruppe.
  • Aktivieren Sie Logische Reihenfolge.
  • Setzen Sie Modus für Reihenfolge auf Nach WS-Reihenfolge oder die Nachrichtenflusseigenschaft Zusätzliche Instanzen auf 0. (Sie können Nachrichtenflusseigenschaften modifizieren, wenn Sie den Nachrichtenfluss der BAR-Datei für die Implementierung hinzufügen.)

    Wenn Sie eine dieser Optionen oder beide wählen, verarbeitet der Nachrichtenfluss die Nachrichten in einem einzelnen Ausführungsthread, und eine Nachricht wird komplett verarbeitet, bevor die nächste aus der Warteschlange abgerufen wird. In allen anderen Fällen ist es möglich, dass mehrfache Threads innerhalb eines einzelnen Nachrichtenflusses mehrere Nachrichten verarbeiten; es gibt keine Garantie dafür, dass die letzte Nachricht in einer Gruppe, welche zur COMMIT- oder ROLLBACK-Aktion auffordert, komplett verarbeitet wird, nachdem alle anderen Nachrichten in der Gruppe verarbeitet worden sind.

Darüber hinaus müssen Sie sicherstellen, dass kein anderer Nachrichtenfluss Nachrichten aus derselben Eingabewarteschlange abruft. Andernfalls besteht keine Garantie hinsichtlich der Reihenfolge, in der die Nachrichten in einer Gruppe verarbeitet werden.

MQGET-Puffergröße

Die MQGET-Puffergröße wird vom Broker intern implementiert und kann nicht geändert werden. Die folgende Beschreibung dient nur zur Information. Sie sollten sich beim Entwickeln Ihrer Nachrichtenflüsse nicht darauf verlassen, da sich die interne Implementierung ändern könnte.

Bei der Initialisierung des MQInputsknotens wird die Größe des Standardpuffers für den ersten MQGET-Aufruf auf 4 KB gesetzt. Die Größe der Nachrichten wird vom MQInput-Knoten überwacht und der Puffer vergrößert oder verkleinert:

  1. Schlägt ein MQGET-Aufruf fehl, da die Nachricht größer als der Puffer ist, vergrößert der Knoten zur Aufnahme der Nachricht sofort den Puffer, gibt erneut den MQGET-Aufruf aus und setzt den Nachrichtenzähler auf null.
  2. Sobald zehn Nachrichten seit der Puffervergrößerung gezählt worden sind, vergleicht der Knoten die Größe der größten der zehn Nachrichten mit der Größe des Puffers. Wenn die Größe der größten Nachricht weniger als 75% der Puffergröße ausmacht, wird diese auf die Größe der größten der zehn Nachrichten reduziert. Wenn ein MQGET-Aufruf während der zehn Nachrichten fehlschlägt, weil eine Nachricht größer als die Puffergröße ist, führt der Knoten die Maßnahmen aus Schritt 1 aus.

Wenn z. B. die erste im Knoten eingehende Nachricht 20 MB beträgt und die folgenden zehn Nachrichten jeweils 14 MB betragen, wird die Puffergröße von 4 KB auf 20 MB angehoben und bleibt für diese zehn Nachrichten auf diesem Wert. Nach der zehnten Nachricht aber wird die Größe des Puffers auf 14 MB reduziert.

Terminals und Eigenschaften

In der folgenden Tabelle werden die Terminals des MQInputsknotens beschrieben.

Terminal Beschreibung
Fehlerterminal Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn ein Fehler auftritt. Selbst wenn die Eigenschaft 'Auswerten' festgelegt wird, werden Nachrichten, die an dieses Terminal weitergegeben wurden, nicht ausgewertet.)
Ausgabeterminal Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn sie erfolgreich von der WebSphere MQ-Warteschlange abgerufen wurde.
Catch-Terminal Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn nachgeschaltet eine Ausnahmebedingung ausgegeben und von diesem Knoten abgefangen wurde.

In den folgenden Tabellen werden die Knoteneigenschaften beschrieben. Die Spalte M zeigt an, ob die Eigenschaft obligatorisch ist (markiert mit einem Sternchen, wenn ein Wert eingegeben werden muss, weil kein Standardwert definiert ist). Die Spalte C zeigt an, ob die Eigenschaft konfigurierbar ist (Wert kann geändert werden, wenn der Nachrichtenfluss zur BAR-Datei hinzugefügt wird, um ihn einzusetzen).

In der folgenden Tabelle werden die Beschreibungseigenschaften des MQInputsknotens beschrieben.

Eigenschaft M C Standardwert Beschreibung
Knotenname Nein Nein Knotentyp MQInput Der Name des Knotens.
Kurzbeschreibung Nein Nein   Kurze Beschreibung des Knotens
Ausführliche Beschreibung Nein Nein   Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt.

In der folgenden Tabelle werden die grundlegenden Eigenschaften des MQInputsknotens beschrieben.

Eigenschaft M C Standardwert Beschreibung
Warteschlangenname Ja Ja   Der Name der WebSphere MQ-Eingabewarteschlange, aus der dieser Knoten (unter Verwendung von MQGET) Nachrichten zur Verarbeitung durch diesen Nachrichtenfluss abruft.

In der folgenden Tabelle werden die Eigenschaften von 'Syntaxanalyse der Eingabenachricht' des MQInputsknotens beschrieben.

Eigenschaft M C Standardwert Beschreibung
Nachrichtendomäne Nein Nein BLOB Die Domäne für die Syntaxanalyse der ankommenden Nachricht. Der Standardwert BLOB gilt nur, wenn kein voreingestellter 'MQRFH2'-Header vorhanden ist und keine Option aus der Liste ausgewählt wurde.
Nachrichtengruppe Nein Nein   Der Name oder die ID der Nachrichtengruppe, in der die ankommende Nachricht definiert ist.
Nachrichtentyp Nein Nein   Der Name der ankommenden Nachricht.
Nachrichtenformat Nein Nein   Der Name des physischen Formats der ankommenden Nachricht.

In der folgenden Tabelle werden die Eigenschaften der Parser-Optionen für den MQInputsknoten beschrieben.

Eigenschaft M C Standardwert Beschreibung
Zeitpunkt für Syntaxanalyse Nein Nein Bei Bedarf Durch diese Eigenschaft wird gesteuert, zu welchem Zeitpunkt eine Eingabenachricht syntaktisch analysiert wird. Gültige Werte sind Bei Bedarf, Sofort und Vollständig.

Eine umfassende Beschreibung dieser Eigenschaft finden Sie unter Bedarfsgerechte Syntaxanalyse.

MQRFH2C-Kompaktparser für MQRFH2-Header verwenden Nein Nein Nicht ausgewählt Durch diese Eigenschaft wird gesteuert, ob der MQRFH2C-Kompaktparser anstelle des MQRFH2-Parsers für MQRFH2-Header verwendet wird.
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 vom XML-Schema genommen wurden. Diese Eigenschaft kann nur ausgewählt werden, wenn die Eigenschaft Auswerten in der Registerkarte Auswerten auf Inhalt oder Inhalt und Wert gesetzt wird.
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 unter XMLNSC in Knoten, die mit dem Ausgabeterminal verbunden sind, angezeigt, wenn XMLNS die Nachrichtendomäne des MQRFH2-Eingabeheaders oder der Eigenschaften von 'Syntaxanalyse der Eingabenachricht' ist.
Zugriff auf gemischten Inhalt Nein Nein Nicht ausgewählt Durch diese Eigenschaft wird gesteuert, ob der XMLNSC-Parser beim Feststellen von gemischtem Text in einer Eingabenachricht Elemente in der Nachrichtenbaumstruktur erstellt. 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 Durch diese Eigenschaft wird gesteuert, ob der XMLNSC-Parser beim Erkennen von Kommentaren in einer Eingabenachricht Elemente in der Nachrichtenbaumstruktur erstellt. 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 Durch diese Eigenschaft wird gesteuert, ob der XMLNSC-Parser beim Erkennen von Verarbeitungsanweisungen in einer Eingabenachricht Elemente in der Nachrichtenbaumstruktur erstellt. 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   Mit dieser Eigenschaft wird eine Liste mit Elementen in der Eingabenachricht angegeben, die vom XMLNSC-Parser auf nicht transparente Weise analysiert werden sollen.

In der folgenden Tabelle werden die erweiterten Eigenschaften des MQInputsknotens beschrieben.

Eigenschaft M C Standardwert Beschreibung
Transaktionsmodus Ja Nein Ja Durch diese Eigenschaft wird gesteuert, ob die ankommende Nachricht unter Synchronisationspunktsteuerung empfangen wird. Gültige Werte sind Automatisch, Ja und Nein.
Modus für Reihenfolge Ja Nein Standardwert Gibt die Reihenfolge an, in der Nachrichten aus der Eingabewarteschlange abgerufen und verarbeitet werden. Gültige Werte sind Standardwert, Nach Benutzer-ID und Nach WS-Reihenfolge.
Logische Reihenfolge Ja Nein Ausgewählt Wenn Sie dieses Kontrollkästchen aktivieren, werden Nachrichten empfangen.
Alle Nachrichten verfügbar Ja Nein Nicht ausgewählt Wenn Sie das Kontrollkästchen auswählen, müssen alle Nachrichten in einer Gruppe verfügbar sein, bevor das Abfragen einer Nachricht möglich ist.
Nachrichten-ID vergleichen Nein Nein   Eine Nachrichten-ID muss der Nachrichten-ID im MQMD der ankommenden Nachricht entsprechen.
Korrelations-ID vergleichen Nein Nein   Eine Korrelations-ID muss der Korrelations-ID im MQMD der ankommenden Nachricht entsprechen.
Konvertieren Ja Nein Nicht ausgewählt Wenn Sie das Kontrollkästchen aktivieren, konvertiert WebSphere MQ Daten in der zu empfangenden Nachricht in Übereinstimmung mit den Werten, die im MQMD für 'CodedCharSetId' und 'Encoding' festgelegt wurden.
Codierungskonvertierung Nein Nein   Die Darstellung, die für numerische Werte in den Nachrichtendaten verwendet wird (ausgedrückt als ganzzahliger Wert). Diese Eigenschaft ist nur gültig, wenn Sie Konvertieren aktiviert haben.
CCSID-Konvertierung Nein Nein   Die ID des codierten Zeichensatzes, die für die Zeichendaten in den Nachrichtendaten verwendet wird (ausgedrückt als ganzzahliger Wert). Diese Eigenschaft ist nur gültig, wenn Sie Konvertieren aktiviert haben.
Festschreibung nach Nachrichtengruppe Ja Nein Nicht ausgewählt Durch diese Eigenschaft wird gesteuert, wann eine Transaktion bei der Verarbeitung von Nachrichten, die Teil einer Nachrichtengruppe sind, festgeschrieben wird. Wenn Sie das Kontrollkästchen aktivieren, wird die Transaktion festgeschrieben, nachdem die Nachrichtengruppe verarbeitet wurde.
z/OS-Serialisierungs-Token Nein Nein   Benutzerdefiniertes Token für eine serialisierte Anwendungsunterstützung. Der angegebene Wert muss den Regeln für gültige ConnTags in der MQCNO-Struktur von WebSphere MQ entsprechen.
Thema Nein Ja   Standardthema der Eingabenachricht
Nur durchsuchen Nein Nein Nicht ausgewählt Diese Eigenschaft bestimmt, ob eine Nachricht aus der Warteschlange gelöscht wird, wenn sie gelesen wurde. Wenn Sie dieses Kontrollkästchen aktivieren, wird die Nachricht nicht aus der Warteschlange gelöscht, wenn sie gelesen wurde.
Suchzeitlimit (ms) zurücksetzen Ja Ja -1 Die Zeit in Millisekunden ab der letzten durchsuchten Nachricht in der Eingabewarteschlange, bis die Durchsuchung auf den Anfang der Warteschlange zurückgesetzt wird. Der Standardwert von -1 weist darauf hin, dass die Durchsuchung nicht zurückgesetzt wird.

In der folgenden Tabelle werden die Auswertungseigenschaften des MQInputsknotens beschrieben.

Eine umfassende Beschreibung dieser Eigenschaften finden Sie unter Auswertungseigenschaften.
Eigenschaft M C Standardwert Beschreibung
Auswerten Nein Ja None Durch diese Eigenschaft wird gesteuert, ob eine Auswertung stattfindet. Gültige Werte sind Keine,Inhalt und Inhalt und Wert.
Fehlerbehebungsmaßnahme Nein Nein Ausnahme Durch diese Eigenschaft wird gesteuert, was beim Fehlschlagen der Auswertung geschieht. Sie können diese Eigenschaft nur angeben, wenn Sie Auswerten auf Inhalt oder Inhalt und Wert gesetzt haben. Gültige Werte sind Benutzertrace, Lokales Fehlerprotokoll, Ausnahmebedingung und Ausnahmeliste.

In der folgenden Tabelle werden die Eigenschaften für die Sicherheit des MQInput-Knotens beschrieben. Weitere Informationen zu diesen Eigenschaften finden Sie unter Identität und Identitätsauszug konfigurieren.

Eigenschaft M C Standardwert Beschreibung
Identitätstokentyp Nein Nein None Diese Eigenschaft gibt den Typ des Identitätstokens an, das in der eingehenden Nachricht vorhanden ist. Gültige Werte sind: Transportstandardwert, Benutzername, Benutzername + Kennwort und X.509-Zertifikat. Wird diese Eigenschaft nicht angegeben, wird die Identität aus den Transport-Headern abgerufen, und der Typ wird auf Benutzername gesetzt.
Identitätstokenstandort Nein Nein None Diese Eigenschaft gibt an, wo in der Nachricht sich die Identität befindet. Der Standort wird als ESQL-Feldreferenz oder XPath angegeben. Wird diese Eigenschaft nicht angegeben, wird die Identität aus dem Transport-Header 'MQMD.UserIdentifier' abgerufen.
Identitätskennwortstandort Nein Nein None Diese Eigenschaft gibt an, wo in der Nachricht sich das Kennwort befindet. Der Standort wird als ESQL-Feldreferenz oder XPath angegeben. Wird er nicht angegeben, wird das Kennwort nicht gesetzt. Diese Eigenschaft kann nur festgelegt werden, wenn der Identitätstyp auf Benutzername + Kennwort gesetzt ist.
Identität-issuedBy-Position Nein Nein None Diese Eigenschaft gibt eine Zeichenfolge oder einen Pfadausdruck an und beschreibt den Aussteller der Identität. Der Standort wird als ESQL-Feldreferenz oder XPath angegeben. Dieser dient zur Verwendung in einer Identitätszuordnungsfunktion. Wird diese Eigenschaft nicht angegeben, wird der Wert 'MQMD.PutApplName' verwendet.
Sicherheitsausnahmen als normale Ausnahmen behandeln Nein Nein False (falsch) Diese Eigenschaft gibt an, ob Sicherheitsausnahmen (wie z. B. 'Zugriff verweigert') als normale Ausnahmebedingungen behandelt werden sollen, und leitet sie zum Fehlerterminal (falls verbunden) weiter. Standardmäßig ist dies inaktiviert; somit wird sichergestellt, dass Sicherheitsausnahmen veranlassen, dass die Nachricht zurückgesetzt wird, selbst wenn das Fehlerterminal angeschlossen ist.
In der folgenden Tabelle werden die Instanzeigenschaften des MQInputsknotens beschrieben. Eine umfassende Beschreibung dieser Eigenschaften finden Sie unter Konfigurierbare Nachrichtenflusseigenschaften.
Eigenschaft M C Standardwert Beschreibung
Pool zusätzlicher Instanzen Nein Ja Dem Nachrichtenfluss zugeordneten Pool verwenden Der Pool, aus dem zusätzliche Instanzen beschafft werden.
  • Wenn Sie Dem Nachrichtenfluss zugeordneten Pool verwenden auswählen, werden zusätzliche Instanzen aus dem Nachrichtenflusswert beschafft.
  • Wenn Sie Dem Knoten zugeordneten Pool verwenden auswählen, werden zusätzliche Instanzen aus den zusätzlichen Instanzen des Knotens ausgehend von der in der Eigenschaft Zusätzliche Instanzen angegebenen Anzahl zugeordnet.
Zusätzliche Instanzen Nein Ja 0 Die Anzahl zusätzlicher Instanzen, die der Knoten starten kann, wenn die Eigenschaft Pool zusätzlicher Instanzen auf Dem Knoten zugeordneten Pool verwenden gesetzt ist. Standardmäßig werden dem Knoten keine zusätzlichen Instanzen bereitgestellt.
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
ac04560_