Korrelationsnamen

Ein Korrelationsname ist eine Feldreferenz, die einen klar strukturierten Ausgangspunkt in der logischen Nachrichtenbaumstruktur identifiziert und in Feldreferenzen zur Beschreibung eines Standardbereichs des Baumstrukturformats verwendet wird.

Wenn Sie auf die Daten in einer der vier Baumstrukturen (Nachricht, Umgebung, Lokale Umgebung oder Ausnahmeliste) zugreifen, hängen die verwendbaren Korrelationsnamen von dem Knoten ab, für den Sie ESQL-Code oder Zuordnungen erstellen. Außerdem sind sie davon abhängig, ob der Knoten eine Ausgabenachricht erstellt. Ein Traceknoten ändert beispielsweise den Inhalt der Nachricht nicht, wenn sie durch den Knoten übergeben wird. Ein Rechenknoten hingegen kann eine neue Ausgabenachricht konstruieren.

Mit SELECT-Ausdrücken, Vergleichsfunktionen und FOR-Anweisungen können Sie neue Korrelationsnamen einführen. Durch die Verwendung von Referenzvariablen können Sie Nicht-Korrelationsnamen in einem Knoten erstellen.

Korrelationsnamen in Knoten, die keine Ausgabenachricht erstellen

Die meisten Nachrichtenflussknoten erstellen keine Ausgabenachricht; alle ESQL-Ausdrücke, die Sie in ESQL-Modulen oder in Zuordnungen innerhalb dieser Knoten schreiben, verweisen lediglich auf die Eingabenachricht. Sie können die folgenden Korrelationsnamen in den Datenbank- und Filterknoten (ESQL-Module) verwenden. Diese Korrelationsnamen können nicht im Ausdruck einer Zuordnung für einen Zuordnungs-, Extraktions-, Warehouse-, Dateneinfüge-, Datenaktualisierungs- oder Datenlöschknoten verwendet werden.

Root
Das Stammverzeichnis der Nachricht, die im Knoten übergeben wird.
Body (Hauptteil)
Das letzte untergeordnete Element des Stammverzeichnisses der Nachricht, d. h. der Hauptteil der Nachricht. Hierbei handelt es sich um einen Aliasnamen für Root.*[<].

Eine Beschreibung zur Verwendung von * finden Sie unter Anonyme Feldverweise verwenden.

DestinationList (Zieladressenliste)
Die Struktur, die die aktuellen lokalen Umgebungsvariablen enthält, die dem Knoten zur Verfügung stehen. Ihr gängiger Name lautet 'LocalEnvironment' (Lokale Umgebung); der Korrelationsname 'DestinationList' kann jedoch zur Abwärtskompatibilität verwendet werden.
Properties (Eigenschaften)
Die Standardeigenschaften der Eingabenachricht.
ExceptionList (Ausnahmeliste)
Die Struktur, die die aktuelle Ausnahmeliste enthält, auf die der Knoten zugreifen kann.
Environment (Umgebung)
Die Struktur, die die aktuellen globalen Umgebungsvariablen enthält, die dem Knoten zur Verfügung stehen. Lese- und Aktualisierungsvorgänge in der Umgebung sind von jedem Knoten aus möglich, für den Sie ESQL-Code oder Zuordnungen erstellen können.
LocalEnvironment (Lokale Umgebung)
Die Struktur, die die aktuellen lokalen Umgebungsvariablen enthält, die dem Knoten zur Verfügung stehen. Lese- und Aktualisierungsvorgänge in der lokalen Umgebung sind von jedem Knoten aus möglich, für den Sie ESQL-Code oder Zuordnungen erstellen können.

Korrelationsnamen in Knoten, die eine Ausgabenachricht erstellen

Wenn Sie für einen Rechenknoten ESQL-Code schreiben, lauten die Korrelationsnamen anders, da zwei Nachrichtenbaumstrukturen involviert sind: die Eingabenachricht und die Ausgabenachricht. Die Korrelationsnamen im ESQL-Code dieser Knoten lauten wie folgt:

Environment (Umgebung)
Die Struktur, die die aktuellen globalen Umgebungsvariablen enthält, die dem Knoten zur Verfügung stehen. Die Umgebung kann gelesen und aktualisiert werden.
InputRoot (Eingabestammverzeichnis)
Das Stammverzeichnis der Eingabenachricht.
InputBody (Eingabehauptteil)
Das letzte untergeordnete Element des Stammverzeichnisses der Eingabenachricht. Hierbei handelt es sich um einen Aliasnamen für InputRoot.*[<].

Eine Beschreibung zur Verwendung von * finden Sie unter Anonyme Feldverweise verwenden.

InputProperties (Eingabeeigenschaften)
Die Standardeigenschaften der Eingabenachricht.
InputDestinationList (Eingabe-Zieladressenliste)
Die Struktur, die die aktuellen lokalen Umgebungsvariablen für die Nachricht enthält, die im Knoten übergeben wird. Verwenden Sie den Korrelationsnamen 'InputDestinationList' aus Gründen der Abwärtskompatibilität; falls keine Kompatibilität erforderlich ist, verwenden Sie den gängigen Namen 'InputLocalEnvironment'.
InputExceptionList (Eingabe-Ausnahmeliste)
Die Struktur, die die Ausnahmeliste für die Nachricht enthält, die im Knoten übergeben wird.
InputLocalEnvironment (Lokale Umgebung der Eingabe)
Die Struktur, die die aktuellen lokalen Umgebungsvariablen für die Nachricht enthält, die im Knoten übergeben wird.
OutputRoot (Ausgabestammverzeichnis)
Das Stammverzeichnis der Ausgabenachricht.

In einem Rechenknoten gibt es den Korrelationsnamen 'OutputBody' nicht.

OutputDestinationList (Ausgabe-Zieladressenliste)
Die Struktur, die die aktuellen lokalen Umgebungsvariablen enthält, die vom Knoten aus gesendet werden. Verwenden Sie den Korrelationsnamen 'OutputDestinationList' aus Gründen der Abwärtskompatibilität; falls keine Kompatibilität erforderlich ist, verwenden Sie den gängigen Namen 'OutputLocalEnvironment'.
OutputExceptionList (Ausgabe-Ausnahmeliste)
Die Struktur, die die Ausnahmeliste enthält, die vom Knoten generiert wird.

Dieser Korrelationsname ist zwar immer gültig, ist jedoch nur von Bedeutung, wenn die Eigenschaft Rechenmodus des Rechenknotens angibt, dass der Rechenknoten die Ausnahmeliste weitergibt.

OutputLocalEnvironment (Lokale Umgebung der Ausgabe)
Die Struktur, die die aktuellen lokalen Umgebungsvariablen enthält, die vom Knoten aus gesendet werden.

Dieser Korrelationsname ist zwar immer gültig, ist jedoch nur von Bedeutung, wenn die Eigenschaft Rechenmodus des Rechenknotens angibt, dass der Rechenknoten die lokale Umgebung weitergibt.

Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
ac00510_