Mit dem Zuordnung-Knoten können Sie eine oder mehrere neue Nachrichten erstellen und diese mit verschiedenen Arten von Informationen füllen.
Dieses Kapitel enthält folgende Abschnitte:
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 auswählen, werden die Header in der Eingabenachricht immer ohne Änderung in die Ausgabenachricht kopiert. Wenn Sie die Nachrichtenheader in einem Zuordnung-Knoten ändern möchten, wählen Sie die Option Diese Zuordnung wird von einem Nachrichtenflussknoten aufgerufen und ordnet Eigenschaften, Header und den Hauptteil der Nachricht zu aus. Bei Auswahl dieser Eigenschaft können über die erstellte Zuordnung 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 mit dem Knoten verknüpften Zuordnungsdatei, indem Sie Eingaben (Nachricht oder Datenbank) den Ausgaben zuordnen. Sie können 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 Zuordnung-Knoten können folgende Aktionen ausgeführt werden:
Der Zuordnung-Knoten befindet sich im Ablagefach Transformation der Palette und wird in der Workbench durch folgendes Symbol dargestellt:
Sie können Beispiele nur anzeigen, wenn Sie das Information Center verwenden, das im Message Broker Toolkit integriert ist.
Nachdem Sie eine Instanz des Zuordnung-Knotens in einen Nachrichtenfluss eingereiht haben, können Sie ihn konfigurieren; siehe Nachrichtenflussknoten konfigurieren. Die Knoteneigenschaften werden in der Eigenschaftenansicht angezeigt.
Alle verbindlichen Eigenschaften, für die Sie einen Wert eingeben müssen (d. h. Eigenschaften ohne definierten Standardwert), sind mit einem Sternchen gekennzeichnet.
Konfigurieren Sie den Zuordnung-Knoten folgendermaßen:
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.
Wenn Sie neben dem Eingabefeld auf Durchsuchen klicken, wird ein Dialogfenster 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, die mit diesem Knoten verknüpft ist, zu arbeiten, klicken Sie doppelt auf den Knoten, oder klicken Sie mit der rechten Maustaste auf den Knoten, und klicken Sie im Kontextmenü auf Zuordnungen öffnen. 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 Brokerentwicklungsansicht öffnen.
Eine Zuordnungsroutine kann nur mit dem Knotentyp verwendet werden, mit dem sie verknüpft ist. Sie können eine für einen Zuordnung-Knoten entwickelte Zuordnungsroutine nicht mit einem anderen Knoten einsetzen, der Zuordnungen verwendet (z. B. einem DataInsert-Knoten). 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.
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 nicht eine bestimmte Komponente der Nachricht einschließt, wird diese Komponente in keiner Ausgabenachricht, die erstellt wird, eingeschlossen.
In einigen früheren Versionen wurde die lokale Umgebung (LocalEnvironment) als DestinationList (Zieladressenliste) bezeichnet; dies wird aus Kompatibilitätsgründen übernommen.
Die Moduseinstellung wirkt sich nicht auf die Umgebungskomponente der Nachrichtenbaumstruktur aus. Ihr Inhalt, falls vorhanden, wird von diesem Knoten aus übergeben.
| Modus | Beschreibung |
|---|---|
| Nachricht (Standardeinstellung) | Die Nachricht wird vom Zuordnung-Knoten wie im Knoten geändert generiert oder übergeben. |
| LocalEnvironment | Die Nachrichtenbaumstruktur 'LocalEnvironment' wird vom Zuordnung-Knoten wie im Knoten geändert generiert oder übergeben. |
| LocalEnvironment und Nachricht | Die Nachrichtenbaumstruktur 'LocalEnvironment' und die Nachricht werden vom Zuordnung-Knoten wie im Knoten geändert generiert oder übergeben. |
| Ausnahme | Die Ausnahmeliste wird vom Zuordnung-Knoten wie im Knoten geändert generiert oder übergeben. |
| Ausnahme und Nachricht | Die Ausnahmeliste und die Nachricht werden vom Zuordnung-Knoten wie im Knoten geändert generiert oder übergeben. |
| Ausnahme und LocalEnvironment | Die Ausnahmeliste und 'LocalEnvironment' werden vom Zuordnung-Knoten wie im Knoten geändert generiert oder übergeben. |
| Alle | Die Nachricht, Ausnahmeliste und 'LocalEnvironment' werden vom Zuordnung-Knoten wie im Knoten geändert generiert oder übergeben. |
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 schwer wiegenden Fehlern. Wenn Sie das Kontrollkästchen nicht aktivieren, behandelt der Knoten Warnungen als normale Rückkehrcodes und löst keine Ausnahmebedingungen 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.
Durch die Festlegung der Auswertungseigenschaften können Sie festlegen, wie die vom Zuordnung-Knoten generierte Nachricht ausgewertet werden soll. (Wenn eine Nachricht an das Fehlerterminal des Knotens übergeben wird, wird sie nicht ausgewertet.) Diese Eigenschaften führen nicht dazu, dass die Eingabenachricht ausgewertet wird. Falls diese Auswertung erforderlich ist, wird davon ausgegangen, dass die Auswertung bereits durch den Empfangsknoten oder einen vorhergehenden Auswertungsknoten ausgeführt wurde.
Weitere Informationen zur Auswertung von Nachrichten und Auswertungseigenschaften finden Sie unter Nachrichten überprüfen und Auswertungseigenschaften.
In der folgenden Tabelle werden die Zuordnung-Knotenterminals 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. |
| Ausgabeterminal | Das Ausgabeterminal, das die Nachricht nach Ausführung der Zuordnungen ausgibt. |
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 Zuordnung-Knotens beschrieben.
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| Knotenname | Nein | Nein | Knotentyp | 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 Zuordnung-Knotens beschrieben.
| Eigenschaft | M | C | Standardwert | 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 | Nachricht | Der Modus für die Verarbeitung von Informationen, die über den Zuordnung-Knoten weitergeleitet werden. Gültige Werte sind:
|
| Warnungen als Fehler behandeln | Ja | Nein | Nicht ausgewählt | Wenn Sie das Kontrollkästchen aktivieren, werden SQL-Datenbankwarnungen als Fehler behandelt. |
| Ausnahmebedingung für Datenbankfehler ausgeben | Ja | Nein | Ausgewählt | Wenn Sie das Kontrollkästchen aktivieren, führen Datenbankfehler dazu, dass der Broker eine Ausnahmebedingung auslöst. |
In der folgenden Tabelle werden die Parser-Optionen für den Zuordnung-Knoten beschrieben.
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| XMLNSC-Kompaktparser für XMLNS-Domäne verwenden | Nein | Nein | Nicht ausgewählt | Durch Festlegung dieser Eigenschaft wird im MQRFH2-Header der ausgehenden Nachricht der Parser XMLNS statt des Parsers XMLNSC angegeben. Dies bedeutet, dass eine externe Anwendung nicht geändert werden muss. Wenn ausgehende Nachrichten keine MQRFH2-Header enthalten, hat diese Eigenschaft keine Auswirkungen. |
In der folgenden Tabelle werden die Auswertungseigenschaften des Zuordnung-Knotens beschrieben.
Eine umfassende Beschreibung dieser Eigenschaften finden Sie unter Auswertungseigenschaften.
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| Auswerten | Nein | Ja | Keines | Durch diese Eigenschaft wird gesteuert, ob eine Auswertung stattfindet. Gültige Werte sind Keine, Inhalt und Wert, Inhalt und Übernehmen. |
| Aktion bei Fehler | Nein | Nein | Ausnahme | Durch diese Eigenschaft wird gesteuert, was beim Fehlschlagen der Auswertung geschieht. Sie können diese Eigenschaft nur angegeben, wenn Sie 'Auswerten' auf Inhalt oder Inhalt und Wert gesetzt haben. Gültige Werte sind Benutzertrace, Lokales Fehlerprotokoll, Ausnahmebedingung und Ausnahmeliste. |