Die Baumstruktur für die lokale Umgebung hat einen eigenen Korrelationsnamen (LocalEnvironment), und Sie müssen diesen Namen in allen ESQL-Anweisungen verwenden, die auf den Inhalt dieser Baumstruktur verweisen oder diesen festlegen.
Die Baumstruktur für die lokale Umgebung wird vom Broker verwendet, und Sie können auf diese Informationen verweisen und sie ändern. Darüber hinaus können Sie die Baumstruktur um von Ihnen angegebene Informationen erweitern. Sie können innerhalb dieser Baumstruktur untergeordnete Baumstrukturen erstellen, die als Arbeitspuffer oder Arbeitsbereich verwendet werden können.
Der Nachrichtenfluss richtet in zwei untergeordneten Baumstrukturen (Destination und WrittenDestination) Informationen ein. Diese befinden sich unterhalb des Stammverzeichnisses für die lokale Umgebung. Sie können auf den Inhalt dieser beiden verweisen und Daten in diese Strukturen schreiben, um die Art und Weise zu beeinflussen, in der Ihre Nachricht vom Nachrichtenfluss verarbeitet wird. Wenn Sie jedoch Daten in diese Bereiche schreiben, vergewissern Sie sich, dass Sie der definierten Struktur folgen, damit die Baumstruktur auch weiterhin gültig ist.
Wenn die Baumstruktur für die lokale Umgebung in der Ausgabenachricht, die vom Compute-Knoten weitergegeben wird, enthalten sein soll, müssen Sie die Eigenschaft Rechenmodus des Compute-Knotens auf einen Wert setzen, der die lokale Umgebung enthält (z. B. All).
Andernfalls wird die Baumstruktur für die lokale Umgebung nicht in die Ausgabenachricht kopiert.
Die in 'DestinationData' oder 'Defaults' eingefügten Informationen hängen vom Merkmal der entsprechenden Knoteneigenschaft ab:
- Wenn eine Knoteneigenschaft durch ein Kontrollkästchen dargestellt wird (beispielsweise Neue Nachrichten-ID), setzen Sie das Element 'Defaults' oder 'DestinationData' auf 'yes' (entspricht der Auswahl des Kontrollkästchens) oder 'No' (entspricht der Aufhebung der Auswahl des Kontrollkästchens).
- Wenn eine Knoteneigenschaft durch eine Dropdown-Liste dargestellt wird (beispielsweise Transaktionsmodus), setzen Sie das Element 'Defaults' oder 'DestinationData' auf die entsprechende Zeichenfolge (z. B. 'Automatic').
- Wenn eine Knoteneigenschaft durch ein Texteingabefeld dargestellt wird (beispielsweise
WS-Managername), setzen Sie das Element 'Defaults' oder 'DestinationData'
auf die Zeichenfolge, die Sie in diesem Feld eingeben würden.
Gegebenenfalls müssen
Sie den Sendeknoten für die Angabe der Informationen zur Zieladresse konfigurieren. Legen Sie für den Ausgabeknoten MQOutput beispielsweise Zielmodus fest:
- Wenn Sie den Zielmodus auf Warteschlangenname setzen, wird die Ausgabenachricht an die Warteschlange gesendet, die in den Eigenschaften Warteschlangenname und WS-Managername des Sendeknotens identifiziert ist. Der Knoten verweist nicht auf die Zieladresse.
- Wenn Sie den Zielmodus auf Zieladressenliste setzen, extrahiert der Knoten die Informationen zu den Zieladressen aus der untergeordneten Baumstruktur für Zieladressen (Destination). Wenn Sie diesen Wert verwenden, können Sie eine einzelne Nachricht an mehrere Zieladressen senden, wenn Sie 'Destination' und einen einzelnen Sendeknoten richtig konfigurieren. Der Knoten prüft die Knoteneigenschaften nur daraufhin, ob ein Wert in 'Destination' nicht verfügbar ist (siehe Beschreibung oben).
- Wenn Sie den Zielmodus auf Warteschlange für Anwortnachrichten setzen, wird die Nachricht an die Warteschlange für Antwortnachrichten gesendet, die im MQMD in dieser Nachricht identifiziert ist (Feld 'ReplyToQ'). Der Knoten verweist nicht auf die Zieladresse.
Weitere Informationen zu ESQL-Prozeduren, die für die lokale Umgebung typische Aktualisierungen ausführen, finden Sie unter Zieladresse in der Baumstruktur für die lokale Umgebung mit Daten füllen. Die ESQL-Anweisungen in diesen Prozeduren erläutern das Ändern der lokalen Umgebung.
Sie können diese Prozeduren unverändert verwenden oder Sie an Ihre Anforderungen anpassen.
Weitere Informationen zum Erweitern der Inhalte dieser Baumstruktur für Ihre eigenen Zwecke finden Sie unter Arbeitspufferbereiche in der lokalen Umgebung verwenden.
Der Nachrichtenfluss für XML-Passagierabfragen (XML_PassengerQuery) im folgenden Beispielprogramm ist ein weiteres Beispiel für die Verwendung der lokalen Umgebung zum Ändern des Verhaltens eines Nachrichtenflusses:
Der
Compute-Knoten in dieser Nachricht schreibt eine Liste mit Zieladressen in die untergeordnete Baumstruktur 'RouterList' von 'Destination', die von einem nachfolgenden
RouteToLabel-Knoten, der die Nachricht an den entsprechenden
Kennung-Knoten weitergibt, als Zieladressen verwendet werden.
Sie können Beispiele nur anzeigen, wenn Sie das Information Center
verwenden, das im Message Broker Toolkit integriert ist.