Korrelationsnamen

Ein Korrelationsname ist ein Feldverweis, der einen klar strukturierten Ausgangspunkt in der logischen Nachrichtenbaumstruktur identifiziert und in Feldverweisen verwendet wird, um einen Standardteil des Baumstrukturformats zu beschreiben.

Wenn Sie auf Daten in einer der vier Baumstrukturen (Nachricht, Umgebung, lokale Umgebung oder Ausnahmeliste) zugreifen, hängen die verwendbaren Korrelationsnamen vom Knoten ab, für den Sie ESQL oder Zuordnungen erstellen, und davon ob der Knoten eine Ausgabenachricht erzeugt. Beispiel: Ein Traceknoten verändert nicht den Inhalt der Nachricht, wenn sie den Knoten durchläuft, aber ein Rechenknoten kann eine neue Ausgabenachricht erstellen.

Sie können neue Korrelationsnamen mit SELECT-Ausdrücken, Vergleichsfunktionen und FOR-Anweisungen erstellen. Es können Nicht-Korrelationsnamen in einem Knoten erstellt werden, indem Sie Referenzvariablen verwenden.

Korrelationsnamen in Knoten, die keine Ausgabenachricht erzeugen

Die meisten Nachrichtenflussknoten erzeugen keine Ausgabenachricht; alle ESQL-Ausdrücke, die Sie in ESQL-Modulen oder in Zuordnungen innerhalb dieser Knoten schreiben, beziehen sich nur auf die Eingabenachricht. Sie können die folgenden Korrelationsnamen in 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 den Knoten passiert.
Body
Das letzte untergeordnete Element des Stammverzeichnisses der Nachricht, d. h. der Hauptteil der Nachricht. Dies ist ein Aliasname für Root.*[<].

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

DestinationList
Die Struktur, welche die aktuellen lokalen Umgebungsvariablen enthält, die für den Knoten verfügbar sind. Der Rufname lautet 'LocalEnvironment', aber der 'DestinationList'-Korrelationsname kann für Abwärtskompatibilität verwendet werden.
Properties
Die Standardeigenschaften der Eingabenachricht.
ExceptionList
Die Struktur, welche die aktuelle Ausnahmeliste enthält, auf die der Knoten Zugriff hat.
Environment
Die Struktur, welche die aktuellen globalen Umgebungsvariablen enthält, die für den Knoten verfügbar sind. 'Environment' kann von jedem Knoten, für den Sie ESQL-Code oder Zuordnungen erstellen können, gelesen und aktualisiert werden.
LocalEnvironment
Die Struktur, welche die aktuellen lokalen Umgebungsvariablen enthält, die für den Knoten verfügbar sind. 'LocalEnvironment' kann von jedem Knoten, für den Sie ESQL-Code oder Zuordnungen erstellen können, gelesen und aktualisiert werden.

Korrelationsnamen in Knoten, die eine Ausgabenachricht erzeugen

Wenn Sie ESQL für einen Rechenknoten codieren, sind die Korrelationsnamen unterschiedlich, da zwei Nachrichtenbaumstrukturen einbezogen sind: die Eingabenachricht und die Ausgabenachricht. Die Korrelationsnamen in ESQL innerhalb dieser Knoten lauten:

Environment
Die Struktur, welche die aktuellen globalen Umgebungsvariablen enthält, die für den Knoten verfügbar sind. 'Environment' kann gelesen und aktualisiert werden.
InputRoot
Das Stammverzeichnis der Eingabenachricht.
InputBody
Das letzte untergeordnete Element des Stammverzeichnisses der Eingabenachricht. Dies ist ein Aliasname für InputRoot.*[<].

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

InputProperties
Die Standardeigenschaften der Eingabenachricht.
InputDestinationList
Die Struktur, welche die lokalen Umgebungsvariablen für die Nachricht enthält, die den Knoten passiert. Verwenden Sie den Korrelationsnamen 'InputDestinationList' für die Abwärtskompatibilität; falls keine Kompatibilität erforderlich ist, verwenden Sie den Rufnamen 'InputLocalEnvironment'.
InputExceptionList
Die Struktur, welche die Ausnahmeliste für die Nachricht enthält, die den Knoten passiert.
InputLocalEnvironment
Die Struktur, welche die lokalen Umgebungsvariablen für die Nachricht enthält, die den Knoten passiert.
OutputRoot
Das Stammverzeichnis der Ausgabenachricht.

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

OutputDestinationList
Die Struktur, welche die lokalen Umgebungsvariablen enthält, die vom Knoten gesendet werden. Verwenden Sie den Korrelationsnamen 'OutputDestinationList' für die Abwärtskompatibilität; falls keine Kompatibilität erforderlich ist, verwenden Sie den Rufnamen 'OutputLocalEnvironment'.
OutputExceptionList
Die Struktur, welche die Ausnahmeliste enthält, die der Knoten generiert.

Der Korrelationsname ist zwar immer gültig, er hat aber nur eine Bedeutung, wenn die Eigenschaft Compute Mode (Berechnungsmodus) des Rechenknotens angibt, dass der Rechenknoten 'ExceptionList' (Ausnahmeliste) auffüllt.

OutputLocalEnvironment
Die Struktur, welche die lokalen Umgebungsvariablen enthält, die vom Knoten gesendet werden.

Der Korrelationsname ist zwar immer gültig, er hat aber nur eine Bedeutung, wenn die Eigenschaft Compute Mode (Berechnungsmodus) des Rechenknotens angibt, dass der Rechenknoten 'LocalEnvironment' (lokale Umgebung) auffüllt.

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