Mapping-Knoten

Dieses Kapitel enthält folgende Abschnitte:

Zweck

Mit dem Zuordnungsknoten können Sie mindestens eine neue Nachricht erstellen und diese mit neuen Informationen, geänderten Informationen aus der Eingabenachricht oder Informationen aus einer Datenbank füllen. Sie können Elemente des Nachrichteninhalts, der verknüpften Umgebung und der Ausnahmeliste modifizieren.

Wenn Sie beim ersten Öffnen oder beim Erstellen einer Nachrichtenzuordnung für den Knoten die Option Diese Zuordnung wird von einem Nachrichtenflussknoten aufgerufen und ordnet Eigenschaften und den Hauptteil der Nachricht zu angeben, werden die Header in der Eingabenachricht immer ohne Änderung in die Ausgabenachricht kopiert.

Wenn Sie die Nachrichtenheader in einem Zuordnungsknoten ändern möchten, müssen Sie die Option Diese Zuordnung wird von einem Nachrichtenflussknoten aufgerufen und ordnet Eigenschaften, Header und den Hauptteil der Nachricht zu auswählen. Durch die hiermit erstellte Zuordnung können zusätzliche Elemente (einschließlich MQ-, HTTP- und JMS-Header) zugeordnet werden.

Diese Komponenten der Ausgabenachricht lassen sich unter Verwendung von Zuordnungen definieren, die auf Elementen der Eingabenachricht und auf Daten aus einer externen Datenbank basieren. Sie erstellen mit diesem Knoten verknüpfte Zuordnungen in der Zuordnungsdatei dieses Knotens, indem Sie Eingaben (Nachricht oder Datenbank) mit Ausgaben verknüpfen. Optional können Sie die Zuordnungen dieser Verknüpfungen mit Hilfe integrierter oder benutzerdefinierter Funktionen und Prozeduren modifizieren. So haben Sie beispielsweise die Möglichkeit, einen Zeichenfolgewert in Großbuchstaben zu konvertieren, wenn Sie ihn dem Nachrichtenausgabefeld zuweisen.

Mit dem Zuordnungsknoten können folgende Aktionen ausgeführt werden:

  • Neue Nachrichten erstellen
  • Nachrichten zwischen Parsern kopieren
  • Nachrichten von einem Format in ein anderes umwandeln

Der Zuordnungsknoten wird in der Workbench durch folgendes Symbol dargestellt:

Symbol für Zuordnungsknoten

Diesen Knoten in einem Nachrichtenfluss verwenden

Im nachfolgenden Beispiel ist zu sehen, wie dieser Knoten verwendet werden kann:

Zuordnungsknoten konfigurieren

Wenn Sie eine Instanz des Zuordnungsknotens in einen Nachrichtenfluss eingereiht haben, können Sie ihn konfigurieren. Klicken Sie mit der rechten Maustaste in der Editoransicht auf den Knoten, und wählen Sie die Option Eigenschaften aus. Daraufhin werden die grundlegenden Eigenschaften des Knotens angezeigt.

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

Konfigurieren Sie den Zuordnungsknoten wie folgt:

  1. Geben Sie unter Datenquelle den Namen der entsprechenden Datenbank an, unter dem sie in dem System gespeichert ist, in dem dieser Nachrichtenfluss ausgeführt werden soll. Der Broker stellt mit der Benutzer-ID und den Kennwortdaten, die Sie in den Befehlen mqsicreatebroker, mqsichangebroker oder mqsisetdbparms angegeben haben, eine Verbindung zu dieser Datenbank her.

    Auf z/OS-Systemen verwendet der Broker die vom Broker gestartete Task-ID oder die Benutzer-ID und das Kennwort, die im angepassten Datensatz <hlq>.SBIPPROC im mqsisetdbparms-Befehl 'JCL, BIPSDBP' angegeben wurden.

  2. Wählen Sie im Dropdown-Menü die Einstellung Transaktion. Folgende Werte stehen zur Verfügung:
    • Automatisch (Standardwert). Der Nachrichtenfluss, zu dem der Zuordnungsknoten gehört, wird festgeschrieben, wenn er erfolgreich ist. Das heißt dass die Aktionen, die Sie in den Zuordnungen definieren, ausgeführt werden und die Nachricht den Nachrichtenfluss weiter durchläuft. Wenn der Nachrichtenfluss fehl schlägt, wird er zurückgesetzt. Wenn Sie die Option Automatisch auswählen, hängt die Fähigkeit, die Aktionen des Zuordnungsknotens in der Datenbank festzuschreiben bzw. zurückzusetzen, vom Erfolg oder Scheitern des gesamten Nachrichtenflusses ab.
    • Festschreiben. Wenn Sie alle nicht festgeschriebenen Aktionen festschreiben möchten, die in diesem Nachrichtenfluss in der mit diesem Knoten verbundenen Datenbank ausgeführt werden, und zwar unabhängig von Erfolg oder Scheitern des gesamten Nachrichtenflusses, wählen Sie die Option Festschreiben. Die Datenbankänderungen werden festgeschrieben, selbst wenn der Nachrichtenfluss fehlschlägt.
  3. Geben Sie unter Zuordnungsroutine die Zuordnungsroutine an, die in diesem Knoten ausgeführt werden soll. Standardmäßig ist der Name der Zuordnungsroutine identisch mit dem Namen der Abgleichungsdatei, in der die Routine definiert ist. Der Standardname der Datei ist der Name des Nachrichtenflusses, der mit dem Knotennamen verknüpft wird, wenn Sie ihn in den Nachrichtenfluss einschließen (z. B. MFlow1_Mapping.mfmap für den ersten Zuordnungsknoten im Nachrichtenfluss MFlow1). Sie können keinen Wert angeben, der Leerzeichen enthält.

    Wenn Sie neben dem Eingabefeld auf Durchsuchen klicken, wird ein Dialogfeld mit allen verfügbaren Zuordnungsroutinen angezeigt, auf die dieser Knoten zugreifen kann. Wählen Sie die gewünschte Routine aus, und klicken Sie auf OK. Der Name der Routine wird unter Zuordnungsmodul angegeben.

    Um mit der Zuordnungsroutine zu arbeiten, die mit diesem Knoten verknüpft ist, klicken Sie mit der rechten Maustaste auf den Knoten, und wählen Sie im Kontextmenü die Option Zuordnungen öffnen aus. Wenn die Zuordnungsroutine nicht existiert, wird sie für Sie mit dem Standardnamen in der Standarddatei erstellt. Wenn die Datei bereits existiert, können Sie die Datei <Nachrichtenflussname>_<Knotenname>.mfmap auch in der Navigatoransicht öffnen.

    Eine Zuordnungsroutine kann nur mit dem Knotentyp verwendet werden, mit dem sie verknüpft ist. Sie können eine für einen Zuordnungsknoten entwickelte Zuordnungsroutine nicht mit einem anderem Knoten einsetzen, der Zuordnungen verwendet (z. B. einem Dateneinfügeknoten). Wenn Sie eine Zuordnungsroutine erstellen, können Sie sie nicht aus einer anderen Zuordnungsroutine heraus aufrufen, obwohl sie aus einer ESQL-Routine heraus aufgerufen werden kann.

    Weitere Informationen zum Arbeiten mit Zuordnungsdateien und Definieren ihres Inhalts erhalten Sie unter Nachrichtenzuordnungen entwickeln.

  4. Geben Sie unter Zuordnungsmodus den Modus an, in dem Informationen verarbeitet werden sollen, die über den Zuordnungsknoten weitergeleitet wurden. Sie können eine beliebige Kombination aus den Komponenten Nachricht, Lokale Umgebung und Ausnahmebedingung auswählen, die vom Zuordnungsknoten generiert und modifiziert werden soll.

    Diese Eigenschaft muss festgelegt werden, damit das benötigte Format der Ausgabenachricht richtig wiedergegeben wird. Wenn Sie eine Option auswählen (oder den Standardwert übernehmen), die eine bestimmte Komponente der Nachricht nicht enthält, wird diese Komponente in keine der erstellten Ausgabenachrichten eingefügt.

    (In den Vorgängerreleases von Version 2.1 wurde die verknüpfte Umgebung (lokale Umgebung; LocalEnvironment) als "DestinationList" (Zieladressenliste) bezeichnet. 'DestinationList' ist gültig und kann kompatibel verwendet werden.)

    (Die Moduseinstellung wirkt sich nicht auf die Komponente 'Environment' (Umgebung) der Nachrichtenbaumstruktur aus. Ihr Inhalt - falls vorhanden - wird von diesem Knoten aus übergeben.)

    In der folgenden Tabelle werden die Optionen erläutert.

    Modus Beschreibung
    Message (Nachricht, Standardwert) Die Nachricht wird vom Zuordnungsknoten wie im Knoten geändert generiert oder übergeben.
    LocalEnvironment (Lokale Umgebung) Die Nachrichtenbaumstruktur 'LocalEnvironment' wird vom Zuordnungsknoten wie im Knoten geändert generiert oder übergeben.
    LocalEnvironment And Message (Lokale Umgebung und Nachricht) Die Nachrichtenbaumstruktur 'LocalEnvironment' und die Nachricht werden vom Zuordnungsknoten wie im Knoten geändert generiert oder übergeben.
    Exception (Ausnahmebedingung) Die Ausnahmeliste wird vom Zuordnungsknoten wie im Knoten geändert generiert oder übergeben.
    Exception And Message (Ausnahme und Nachricht) Die Ausnahmeliste und die Nachricht werden vom Zuordnungsknoten wie im Knoten geändert generiert oder übergeben.
    Exception and LocalEnvironment (Ausnahmebedingung und Lokale Umgebung) Die Ausnahmeliste und 'LocalEnvironment' werden vom Zuordnungsknoten wie im Knoten geändert generiert oder übergeben.
    All (Alle) Die Nachricht, Ausnahmeliste und 'LocalEnvironment' werden vom Zuordnungsknoten wie im Knoten geändert generiert oder übergeben.
  5. Wählen Sie im Eigenschaften-Dialognavigator die Option "Grundeinstellung", und aktivieren bzw. inaktivieren Sie anschließend die beiden Markierungsfeld:
    • Wenn Datenbankwarnmeldungen als Fehler behandelt werden und der Knoten die Ausgabenachricht an das Fehlerterminal weitergeben soll, aktivieren Sie das Kontrollkästchen Warnungen als Fehler behandeln. Das Markierungsfeld ist ursprünglich inaktiviert.

      Wenn Sie es aktivieren, behandelt der Knoten alle positiven Rückkehrcodes von der Datenbank als Fehler und generiert Ausnahmebedingungen auf dieselbe Art wie bei negativen oder schwerwiegenden Fehlern.

      Wenn Sie das Kästchen nicht aktivieren, behandelt der Knoten Warnungen als normale Rückkehrcodes und gibt keine Ausnahmebedingung aus. Die höchstwertige Warnung, die ausgegeben werden kann, lautet nicht gefunden. Sie kann in den meisten Fällen als normaler Rückkehrcode sicher bearbeitet werden.

    • Wenn der Broker bei Feststellung eines Datenbankfehlers eine Ausnahmebedingung generieren soll, aktivieren Sie das Kontrollkästchen Ausnahme für Datenbankfehler ausgeben. Das Markierungsfeld ist ursprünglich aktiviert.

      Wenn Sie es inaktivieren, müssen Sie den Fehler im Nachrichtenfluss bearbeiten, um die Integrität des Brokers und der Datenbank zu gewährleisten: der Fehler wird ignoriert, wenn Sie ihn nicht über ihren eigenen Prozess bearbeiten, da Sie kein Aufrufen der Standardfehlerbehandlung durch den Broker ausgewählt haben. Sie könnten beispielsweise das Fehlerterminal mit einer Fehlerverarbeitungs-Subroutine verbinden.

  6. 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.

  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.

    Aktivieren Sie das Kontrollkästchen MQRFH2C-Kompaktparser für MQRFH2-Domäne verwenden, wenn Sie den MQRFH2C-Kompaktparser an Stelle des MQRFH2-Parsers für MQRFH2-Header verwenden möchten.

  8. Wählen Sie im Eigenschaftendialognavigator die Optionen für den XMLNS-Kompaktparser aus und aktivieren Sie das Kontrollkästchen XMLNSC-Kompaktparser für XMLNS-Domäne verwenden, wenn Sie den XMLNSC-Parser für Nachrichten in der XMLNS-Domäne verwenden möchten.

    Durch weitere Eigenschaften wird gesteuert, ob der XMLNSC-Parser für gemischten Text, Kommentare und die Verarbeitung von Anweisungen in der Eingabenachricht verwendet wird.

  9. Wählen Sie im Navigator des Eigenschaftendialogs die Option 'Beschreibung' aus, um ein kurze und/oder ausführliche Beschreibung einzugeben.
  10. Klicken Sie auf Übernehmen, um die Änderungen am Zuordnungsknoten vorzunehmen, ohne das Dialogfeld mit den Eigenschaften zu schließen. Klicken Sie auf OK, um die Änderungen zu übernehmen und das Dialogfeld mit den Eigenschaften 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.

Terminals und Eigenschaften

In der nachfolgenden Tabelle werden die Terminals des Zuordnungsknotens beschrieben.

Terminal Beschreibung
Eingangsterminal Das Eingangsterminal, das eine Nachricht zur Verarbeitung durch einen Knoten annimmt
Fehlerterminal Das Ausgabeterminal, an das die Eingabenachricht geleitet wird, wenn während der Berechnung ein Fehler auftritt. Wenn Sie die Option Warnungen als Fehler behandeln ausgewählt haben, gibt der Knoten die Nachricht auch dann an dieses Terminal weiter, wenn die Verarbeitung erfolgreich beendet wird.
Ausgangsterminal Das Ausgabeterminal, das die Nachricht nach Ausführung der Zuordnungen ausgibt.

In der nachfolgenden Tabelle werden die Knoteneigenschaften beschrieben. Die Spalte M zeigt an, ob die Eigenschaft obligatorisch ist (markiert mit einem Sternchen im Eigenschaftendialog, ob Sie einen Wert eingeben müssen, wenn kein Standardwert definiert ist). Die Spalte C zeigt an, ob die Eigenschaft konfigurierbar ist (Sie können den Wert ändern, wenn Sie der BAR-Datei den Nachrichtenfluss hinzufügen, um ihn einzusetzen).

In der nachfolgenden Tabelle werden die grundlegenden Eigenschaften des Zuordnungsknotens beschrieben.

Eigenschaft M C Standard Beschreibung
Datenquelle Nein Ja   Der Name der ODBC-Datenquelle für die Datenbank mit den Tabellen, auf die Sie in den mit diesem Knoten verknüpften Zuordnungen verweisen (wie unter der Eigenschaft Zuordnungsmodul festgelegt).
Transaktion Ja Nein Automatisch Der Transaktionsmodus für den Knoten. Gültige Werte sind Automatisch oder Festschreiben.
Zuordnungsroutine Ja Nein Zuordnung Der Name der Zuordnungsroutine, die die Anweisungen enthält, die gegen die Datenbank oder Nachrichtenbaumstruktur ausgeführt werden sollen. Die Routine ist eindeutig und kann nur mit diesem Knotentyp verwendet werden.
Zuordnungsmodus Ja Nein Message Wählen Sie einen der folgenden Werte aus:
  • Message
  • LocalEnvironment
  • LocalEnvironment And Message
  • Ausnahmebedingung
  • Exception And Message
  • Exception And LocalEnvironment
  • All
Wenn Sie eine Zuordnung erstellen möchten, die mehrere Zielnachrichten weitergibt, legen Sie für diese Eigenschaft 'Lokale Umgebung' und 'Nachricht' fest, um sicherzustellen, dass der Knoten korrekt ausgeführt wird.
Warnungen als Fehler behandeln Ja Nein Nicht ausgewählt SQL-Datenbankwarnungen als Fehler behandeln. Wenn Sie das Markierungsfeld aktivieren, wird der Vorgang ausgeführt.
Ausnahmebedingung für Datenbankfehler ausgeben Ja Nein Ausgewählt Datenbankfehler führen dazu, dass der Broker eine Ausnahmebedingung auslöst. Wenn Sie das Markierungsfeld aktivieren, wird der Vorgang ausgeführt.

In der nachfolgenden Tabelle werden die Auswertungseigenschaften des Zuordnungsknotens beschrieben.

Eigenschaft M C Standardwert Beschreibung
Auswerten Ja Ja Keine Durchführung einer Auswertung. Gültige Werte sind Keine, Inhalt und Wert, Inhalt und Übernehmen.
Aktion bei Fehler Ja Nein Ausnahme Aktion beim Auftreten eines Auswertungsfehlers. 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 Ja Nein Ausgewählt Diese Eigenschaft kann nicht bearbeitet werden. Standardmäßig werden, wenn das Markierungsfeld aktiviert ist, alle Wertvorgaben in die Auswertung eingeschlossen.
Korrektur Ja Nein Keine Diese Eigenschaft kann nicht bearbeitet werden. Mindestkorrekturen werden zur Verfügung gestellt. Gültige Werte sind Keine und Vollständig.

In der nachfolgenden Tabelle werden die Eigenschaften der allgemeinen Nachrichtenoptionen des Zuordnungsknotens beschrieben:

Eigenschaft M C Standard Beschreibung
Zeitpunkt für Syntaxanalyse Ja 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 Compact Parser für MQRFH2-Domäne verwenden Nein Nein False (falsch) 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 XMLNSC-Parseroptionen für den Zuordnungsknoten beschrieben.

Eigenschaft M C Standard Beschreibung
XMLNSC Compact Parser für XMLNS-Domäne verwenden Ja Nicht ausgewählt Nein Beginn der ÄnderungDurch die Festlegung dieser Eigenschaft wird im MQRFH2-Header der abgehenden Nachricht der Parser XMLNS anstelle des Parsers XMLNSC angegeben. Dies bedeutet, dass eine externe Anwendung nicht geändert werden muss. Wenn abgehende Nachrichten keine MQRFH2-Header enthalten, hat diese Eigenschaft keine Auswirkungen.Ende der Änderung
Residenter Modus für gemischten Inhalt Ja Nein Keine Durch diese Eigenschaft wird gesteuert, ob der XMLNSC-Parser beim Feststellen von gemischtem Text in einer Eingabenachricht Elemente in der Nachrichtenbaumstruktur erstellt. Gültige Werte sind Keine und Alle. Durch die Auswahl von Alle werden Elemente für gemischte Texte erstellt. Durch die Auswahl von Keine werden gemischte Texte ignoriert und keine Elemente erstellt.
Residenter Modus für Kommentare Ja Nein Keine Durch diese Eigenschaft wird gesteuert, ob der XMLNSC-Parser beim Feststellen von Kommentaren in einer Eingabenachricht Elemente in der Nachrichtenbaumstruktur erstellt. Gültige Werte sind Keine und Alle. Durch die Auswahl von Alle werden Elemente für Kommentare erstellt. Durch die Auswahl von Keine werden Kommentare ignoriert und keine Elemente erstellt.
Residenter Modus für Verarbeitungsanweisungen Ja Nein Keine Durch diese Eigenschaft wird gesteuert, ob der XMLNSC-Parser beim Feststellen von Verarbeitungsanweisungen in einer Eingabenachricht Elemente in der Nachrichtenbaumstruktur erstellt. Gültige Werte sind Keine und Alle. Durch die Auswahl von Alle werden Elemente für Verarbeitungsanweisungen erstellt. Durch die Auswahl von Keine werden Verarbeitungsanweisungen ignoriert und keine Elemente erstellt.

In der nachfolgenden Tabelle werden die Beschreibungseigenschaften des Zuordnungsknotens beschrieben.

Eigenschaft M C Standard 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
ac04720_