Die Baumstruktur für die lokale Umgebung ist Teil der logischen Nachrichtenbaumstruktur, in der Sie Informationen speichern können, während der Nachrichtenfluss die Nachricht verarbeitet.
Das Stammelement der Baumstruktur für die lokale Umgebung lautet LocalEnvironment. Diese Baumstruktur ist immer in der Eingabenachricht enthalten; sie wird erstellt, wenn der Empfangsknoten eine Nachricht empfängt. Einige Empfangsknoten erstellen Felder für die lokale Umgebung, andere lassen die Baumstruktur leer.
Speichern Sie in der Baumstruktur für die lokale Umgebung Variablen, auf die Nachrichtenverarbeitungsknoten, die weiter hinter im Nachrichtenfluss stehen, verweisen und die sie aktualisieren können. Die Baumstruktur für die lokale Umgebung kann auch zum Definieren von Zieladressen (die für den Nachrichtenfluss intern oder extern sind) verwendet werden, an die eine Nachricht gesendet wird. WebSphere Message Broker speichert in einigen Fällen auch Informationen in der lokalen Umgebung und referenziert sie für den Zugriff auf Werte, die Sie möglicherweise für Zieladressen festgelegt haben. Vergleichen Sie hierzu die Baumstruktur 'Environment', die vom Broker nur in bestimmten Fällen verwendet wird (siehe Abschnitt Umgebungsbaumstruktur).
Die folgende Abbildung zeigt ein Beispiel der Baumstruktur für die lokale Umgebung. Die untergeordneten Elemente von 'Destination' sind protokollabhängig.
In der gezeigten Baumstruktur hat 'LocalEnvironment' mehrere untergeordnete Elemente:
Variablen in der lokalen Umgebung können von jedem nachfolgenden Nachrichtenverarbeitungsknoten geändert werden; sie bleiben so lange bestehen, bis der Knoten, von dem sie erstellt wurden, seine Arbeit beendet.
Die Variablen in dieser Baumstruktur sind nur innerhalb einer einzelnen Instanz eines Nachrichtenflusses permanent. Wenn mehrere Instanzen einer Nachricht durch den Nachrichtenfluss transportiert werden und zwischen diesen Instanzen Informationen ausgetauscht werden müssen, müssen Sie eine externe Datenbank verwenden.
Transportinformationen werden von einigen Empfangs- und Sendeknoten wie z. B. Email, File, FTE, HTTP, JMS, MQ, SOAP und TCPIP verwendet.
LocalEnvironment.Destination.CICS
Sie können auch LocalEnvironment-Werte für CICS-Kanäle und -Container festlegen. Der Abschnitt Kommunikationsbereichs- oder Kanaldatenstrukturen enthält weitere Informationen hierzu.
LocalEnvironment.Destination.CORBA
$LocalEnvironment/Destination/CORBA/Request/OperationName
Weitere Informationen zum Operationsnamen finden Sie unter CORBARequest-Knoten.LocalEnvironment.Destination.Email
Wenn der Nachrichtenfluss einen EmailOutput-Knoten enthält, können Sie die SMTP-Serververbindungsdaten und Anhänge jeder E-Mail, die von diesem Knoten gesendet wird, durch die Informationen in dieser untergeordneten Baumstruktur definieren oder überschreiben. Es können auch mehrere Anhänge bzw. deren Namen, Inhalt und Typ angegeben werden. Weitere Informationen hierzu finden Sie unter EmailOutput-Knoten.
LocalEnvironment.Destination.File
Wenn der Nachrichtenfluss einen FileOutput-Knoten enthält, können Sie dessen Verzeichnis- und Namenseigenschaften durch Elemente dieser untergeordneten Baumstruktur überschreiben. Weitere Informationen hierzu finden Sie unter Variablen der lokalen Umgebung mit Dateiknoten verwenden.
LocalEnvironment.Destination.FTE
Wenn der Nachrichtenfluss einen FTEOutput-Knoten enthält, können Sie dessen Eigenschaften durch Elemente in dieser untergeordneten Baumstruktur überschreiben. Weitere Informationen hierzu finden Sie unter Variablen der lokalen Umgebung mit Dateiknoten verwenden.
LocalEnvironment.Destination.HTTP
Wenn der Nachrichtenfluss mit einem HTTPInput-Knoten beginnt, wird ein einzelnes HTTP-Namenselement zu 'Destination' hinzugefügt. Das Element 'HTTP.RequestIdentifier' wird erstellt und initialisiert, sodass es von einem HTTPReply-Knoten verwendet werden kann. Sie können auch andere Felder in der HTTP-Struktur erstellen, die vom HTTPRequest-Knoten verwendet werden, z. B. für die URL des Service, an den die Anforderung gesendet wird. Die Abschnitte zu den einzelnen Knoten enthalten weitere Informationen zum Inhalt von 'Destination' für das WebSphere MQ Web Services Transport-Protokoll.
LocalEnvironment.Destination.JMSDestinationList
Ein JMSOutput-Knoten kann so konfiguriert werden, dass er Nachrichten an mehrere JMS-Warteschlangen sendet bzw. in mehrere JMS-Themen veröffentlicht, die in der lokalen Umgebung in einer von einem Transformation-Knoten erstellten Zielliste festgelegt sind.
Der JMSOutput-Knoten sucht in der lokalen Umgebung unter dem Ordner 'Destination.JMSDestinationList' nach Datenelementen mit der Bezeichnung 'DestinationData'. Der Knoten sendet die JMS-Nachricht an jedes DestinationData-Ziel, das er in diesem Ordner findet. Ein Beispiel hierfür finden Sie unter Zieladresse in der Baumstruktur für die lokale Umgebung mit Daten füllen.
LocalEnvironment.Destination.MQ
Enthält der Nachrichtenfluss einen MQOutput-Knoten, ist jedes Element ein Namenselement: MQ (es existiert eine veraltete Alternative namens MQDestinationList. Verwenden Sie MQ für alle neuen Nachrichtenflüsse). Falls mehr als ein Element vorhanden ist, wird jedes nacheinander vom Knoten verarbeitet. Ein Beispiel hierfür finden Sie unter Zieladresse in der Baumstruktur für die lokale Umgebung mit Daten füllen.
Sie können MQOutput-Knoten konfigurieren, um die Liste der Zieladressen auszuwerten und die Nachricht an diese Zieladressen zu senden, indem Sie die Eigenschaft Zielmodus auf Zieladressenliste setzen. Hierzu müssen Sie diese untergeordnete Baumstruktur und deren Inhalt erstellen, um diese Zieladressen zu definieren, und ihr den Namen 'Destination' geben. Tun Sie dies nicht, kann der MQOutput-Knoten die Nachrichten nicht zustellen.
Falls es Ihnen lieber ist, können Sie den MQOutput-Knoten auch so konfigurieren, dass er Nachrichten an eine einzelne feste Zieladresse sendet, indem Sie die Eigenschaft Zielmodus auf Name der Warteschlange oder Warteschlange für Antwortnachrichten setzen. Wählen Sie eine dieser festen Optionen aus, hat die Zieladressenliste keine Wirkung auf Brokeroperationen, und Sie müssen diese untergeordnete Baumstruktur nicht erstellen.
Sie können die MQ-Elemente so anlegen, dass sie ein einzelnes optionales Defaults-Element enthalten. Das Defaults-Element, falls es erstellt wird, muss das erste untergeordnete Element sein und einen Satz mit Namenswertelementen enthalten, die Standardwerte für die Nachrichtenzieladresse und den PUT-Optionen für das übergeordnete Element ausgeben.
Sie können auch eine Reihe von Elementen mit der Bezeichnung 'DestinationData' in MQ erstellen. Jedes dieser Elemente kann mit einer Gruppe von Name/Wert-Elementen konfiguriert werden, die ein Nachrichtenziel und die PUT-Optionen definiert.
Der Elementsatz, der eine Zieladresse definiert, wird in Datentypen für Elemente in der untergeordneten MQ-Baumstruktur für Zieldaten (DestinationData) beschrieben.
Der Inhalt von jeder Instanz von 'DestinationData' ist der gleiche wie bei 'Defaults' für jedes Protokoll und kann verwendet werden, um die Standardwerte in 'Defaults' zu überschreiben. Sie können 'Defaults' so konfigurieren, dass Werte enthalten sind, die für alle Zieladressen einheitlich sind, und nur die eindeutigen Werte in jeder untergeordneten Baumstruktur 'DestinationData' einstellen. Wenn Sie weder in 'DestinationData' noch in 'Defaults' einen Wert angeben, wird der Wert verwendet, den Sie für die entsprechende Knoteneigenschaft festgelegt haben. Ebenso wird ein Feldname mit einer falschen Schreibweise oder falscher Groß-/Kleinschreibung ignoriert und stattdessen der Wert verwendet, den Sie für die entsprechende Knoteneigenschaft festgelegt haben.
Welche Informationen in 'DestinationData' eingefügt werden, hängt von den Merkmalen der entsprechenden Knoteneigenschaft ab. Eine Beschreibung dieser Informationen finden Sie im Abschnitt Zugriff auf die Baumstruktur für die lokale Umgebung.
LocalEnvironment.Destination.SOAP
Sie können abgehende WS-Addressing-Headerdaten in die lokale Umgebung stellen, um die von dem SOAPReply-, SOAPRequest- oder SOAPAsyncRequest-Knoten generierten Standardwerte zu überschreiben. Weitere Informationen hierzu finden Sie unter WS-Adressierungsdaten in der lokalen Umgebung.
Wenn der Nachrichtenfluss einen SOAPRequest- oder SOAPAsyncRequest-Knoten enthält, können Sie dessen HTTP-Transport- und JMS-Transport-Eigenschaften in dieser untergeordneten Baumstruktur überschreiben. Weitere Informationen finden Sie unter SOAPRequest-Knoten, SOAPAsyncRequest-Knoten und Überschreibungen für den SOAPRequest-Knoten in der lokalen Umgebung.
Wenn der Nachrichtenfluss einen SOAPAsyncRequest-Knoten enthält, können Sie Status- und Korrelationsdaten über diese untergeordnete Baumstruktur an einen SOAPAsyncResponse-Knoten in einem anderen Nachrichtenfluss übergeben. Weitere Informationen hierzu finden Sie unter WS-Adressierung mit den Knoten SOAPAsyncRequest und SOAPAsyncResponse.
Wenn der Nachrichtenfluss einen SOAPReply-, SOAPRequest- oder SOAPAsyncRequest-Knoten enthält, können Sie dessen Verwendung abgehender MTOM-Nachrichten in dieser untergeordneten Baumstruktur überschreiben. Weitere Informationen hierzu finden Sie unter SOAP MTOM in Verbindung mit den SOAPReply-, SOAPRequest- und SOAPAsyncRequest-Knoten verwenden.
LocalEnvironment.Destination.TCPIP
Wenn der Nachrichtenfluss einen TCPIPClientOutput- oder TCPIPServerOutput-Knoten enthält, können Sie dessen TCPIP-Verbindung durch Elemente dieser untergeordneten Baumstruktur überschreiben. Weitere Informationen hierzu finden Sie unter TCPIPClientOutput-Knoten und TCPIPServerOutput-Knoten.
Das untergeordnete Element von 'Destination' heißt RouterList. Es besitzt ein einzelnes untergeordnetes Element mit dem Namen DestinationData, das wiederum einen einzelnen Eintrag mit dem Namen 'labelName' (Zieladressenbezeichnung) enthält. Bei Verwendung eines Szenarios mit dynamischem Routing, in das der Knoten 'RouteToLabel' und der Label-Knoten einbezogen sind, müssen Sie die untergeordnete Baumstruktur 'Destination' mit einem RouterList-Element, das die Referenzzieladressen enthält, konfigurieren.
Für den FileInput-Knoten können Sie ein Dateinamensmuster mit Platzhalterzeichen festlegen.
Im Abschnitt Variablen der lokalen Umgebung mit Dateiknoten verwenden finden Sie weitere Informationen zu den Daten, die in der untergeordneten Baumstruktur gespeichert sind.
Das jeweilige Thema für die einzelnen Knoten, die Informationen des Typs 'WrittenDestination' unterstützen, enthält nähere Informationen zu den enthaltenen Daten.
Die Bindungen für EIS-Ereignisse oder Geschäftsmethoden werden vom Assistenten für Adapterverbindungen erstellt.
Für einen WebSphere Adapters-Anforderungsknoten gilt Folgendes:
MethodName ist der Name der Geschäftsmethode, die der Anforderungsknoten verwenden muss.
Im Abschnitt Variablen der lokalen Umgebung mit Dateiknoten verwenden finden Sie weitere Informationen zu den Daten, die in diesen untergeordneten Baumstrukturen gespeichert sind.
Die untergeordnete Baumstruktur LocalEnvironment.Database.Input.Event.Usr enthält benutzerdefinierte Daten, die einem Ereignis zugeordnet sind. Sie wird in der Prozedur ReadEvents des ESQL-Moduls, das dem DatabaseInput-Knoten zugeordnet ist, initialisiert.
LocalEnvironment.Database.Input.Event.Key enthält einen eindeutigen Schlüssel für ein Ereignis. Er wird in der Prozedur ReadEvents des ESQL-Moduls, das dem DatabaseInput-Knoten zugeordnet ist, festgelegt.
LocalEnvironment.Database.Input.Event.FailureCount enthält einen Wert für die Anzahl der fehlgeschlagenen Versuche zur Verarbeitung eines Ereignisses. Dieser Zähler schließt alle nicht behandelten Ausnahmen ein, die entweder im ESQL-Modul oder im Nachrichtenfluss auftreten.
In diesen Informationen wird die Datei beschrieben, außerdem enthält sie Daten zum aktuellen Datensatz.
Im Abschnitt Variablen der lokalen Umgebung mit Dateiknoten verwenden finden Sie weitere Informationen zu den Daten, die in der untergeordneten Baumstruktur gespeichert sind.
Im Abschnitt Variablen der lokalen Umgebung mit Dateiknoten verwenden finden Sie weitere Informationen zu den Daten, die in diesen untergeordneten Baumstrukturen gespeichert sind.
Wenn der Nachrichtenfluss einen JMSReceive-Knoten enthält, können Sie dessen JMS-Verbindungseigenschaften durch Elemente in dieser untergeordneten Baumstruktur überschreiben.
Im Abschnitt Überschreibungen für den JMSReceive-Knoten in der lokalen Umgebung finden Sie weitere Informationen zu diesen Informationen, die in der untergeordneten Baumstruktur gespeichert sind.
Enthält Ihr Nachrichtenfluss einen Mapping-Knoten, können Sie die Zuordnungsroutine, mit der eine Nachrichteninstanz umgewandelt wird, ändern, indem Sie im Feld MappingRoutine eine andere Zuordnungsroutine angeben. Diese neue Zuordnungsroutine muss in der untergeordneten LocalEnvironment.Mapping-Baumstruktur angegeben werden, die dem Mapping-Knoten, der geändert werden muss, vorgeordnet ist.
In den Abschnitten Suchkriterien dynamisch definieren, Ausgabe des EndpointLookup-Knotens und Ausgabe des RegistryLookup-Knotens finden Sie weitere Informationen zu den Daten, die in dieser untergeordneten Baumstruktur gespeichert sind.
Im Abschnitt WS-Adressierungsdaten in der lokalen Umgebung finden Sie weitere Informationen zu den Daten, die in der untergeordneten Baumstruktur gespeichert sind.
Im Abschnitt WS-Adressierung mit den Knoten SOAPAsyncRequest und SOAPAsyncResponse finden Sie weitere Informationen zu den Daten, die in der untergeordneten Baumstruktur gespeichert sind.
Wenn der Nachrichtenfluss einen TCPIPClientReceive- oder TCPIPServerReceive-Knoten enthält, können Sie dessen TCPIP-Verbindung durch Elemente dieser untergeordneten Baumstruktur überschreiben. Weitere Informationen hierzu finden Sie unter TCPIPClientReceive-Knoten und TCPIPServerReceive-Knoten.
Diese untergeordnete Baumstruktur enthält Informationen, die von den TCPIPClientInput-, TCPIPClientReceive-, TCPIPServerInput- und TCPIPServerReceive-Knoten gespeichert werden.
Die Informationen beschreiben die vom Knoten verwendete Verbindung.
Weitere Informationen zu den Daten, die in dieser untergeordneten Baumstruktur gespeichert sind, finden Sie in den Abschnitten TCPIPClientInput-Knoten, TCPIPClientReceive-Knoten, TCPIPServerInput-Knoten und TCPIPServerReceive-Knoten.
Sobald die Verarbeitung des Nachrichtenflusses abgeschlossen ist, wird die Baumstruktur für die lokale Umgebung gelöscht.
Informationen zu Beispielen können nur bei Verwendung des in das WebSphere Message Broker Toolkit integrierten bzw. online verfügbaren Information Center angezeigt werden. Muster können nur ausgeführt werden, wenn das im WebSphere Message Broker Toolkit integrierte Information Center verwendet wird.