WebSphere Message Broker Version 8.0.0.5 Betriebssysteme: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Sehen Sie sich die Informationen zur aktuellen Produktversion im IBM Integration Bus Version 9.0 an.

Baumstruktur für die lokale Umgebung

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.

Die Baumstruktur für die lokale Umgebung ist wie folgt aufgebaut:

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.

Diagramm zeigt eine Baumstruktur für die lokale Umgebung, erstellt von einem mitgelieferten Empfangsknoten und Parser

In der gezeigten Baumstruktur hat 'LocalEnvironment' mehrere untergeordnete Elemente:

LocalEnvironment.Variables
Diese untergeordnete Baumstruktur ist optional. Wenn Sie Variablen für die lokale Umgebung erstellen, speichern Sie diese in einer untergeordneten Baumstruktur mit dem Namen 'Variables'. Sie stellt einen Arbeitsbereich zur Verfügung, den Sie zum Austausch von Informationen zwischen Knoten nutzen können. Diese untergeordnete Baumstruktur wird niemals von einem der mitgelieferten Knoten überprüft oder geändert.

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.

LocalEnvironment.Destination
Diagramm zeigt die untergeordnete Baumstruktur des Zielverzeichnisses, die durch den folgenden Text erläutert wird
Diese untergeordnete Baumstruktur besteht aus mehreren untergeordneten Elementen, die die Transporttypen (Transport-IDs) bezeichnen, an die die Nachricht geleitet wird, oder die Ziel-Label, die vom RouteToLabel-Knoten verwendet werden.
  • Transportinformationen

    Transportinformationen werden von einigen Empfangs- und Sendeknoten wie z. B. Email, File, FTE, HTTP, JMS, MQ, SOAP und TCPIP verwendet.

    LocalEnvironment.Destination.CICS

    Wenn der Nachrichtenfluss einen CICSRequest-Knoten enthält, können Sie die folgenden Eigenschaften durch Elemente dieser untergeordneten Baumstruktur überschreiben:
    • Programmname
    • Länge des Kommunikationsbereichs
    • Spiegeltransaktions-ID
    • Nur EIBTRNID definieren
    • Nachrichtendomäne
    • Nachrichtengruppe
    • Nachrichtenart
    • Nachrichtenformat
    • ID des codierten Nachrichtenzeichensatzes
    • Nachrichtenverschlüsselung
    Der Abschnitt Überschreibungen für den CICSRequest-Knoten in der lokalen Umgebung enthält weitere Informationen hierzu.

    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

    Wenn der Nachrichtenfluss einen CORBARequest-Knoten enthält, können Sie dessen Eigenschaft Operationsname überschreiben, indem Sie an folgendem Standort einen Wert angeben:
    $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.

  • Route-Informationen

    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.

LocalEnvironment.Wildcard
Diese untergeordnete Baumstruktur enthält Informationen zu Platzhalterzeichen, die vom FileInput-Knoten gespeichert werden.

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.

LocalEnvironment.WrittenDestination
Diagramm zeigt die untergeordnete Baumstruktur des Zielverzeichnisses mit den Adressen, die im nachfolgenden Text beschrieben wird.
Diese untergeordnete Baumstruktur enthält die Adressen, an welche die Nachricht geschrieben wurde. Ihr Name ist festgelegt und sie wird vom Nachrichtenfluss erzeugt, wenn eine Nachricht durch das Ausgangsterminal eines Anforderungs-, Sende- oder Antwortknotens weitergegeben wird. Die untergeordnete Baumstruktur enthält transportspezifische Informationen (z. B. ob die Ausgabenachricht in eine WebSphere MQ-Warteschlange eingereiht wurde, ob es Warteschlangenmanager und Warteschlangennamen enthält).
Mit einer der folgenden Methoden können Sie Informationen zu den Details einer Nachricht abrufen, nachdem diese von den Knoten gesendet wurde:
  • Verbinden Sie einen Transformation-Knoten mit dem Ausgangsterminal.
  • Konfigurieren Sie einen Benutzerexit für die Verarbeitung eines Callback-Ereignisses für Ausgabenachrichten. Eine entsprechende Beschreibung finden Sie im Abschnitt Benutzerexits nutzen.

Das jeweilige Thema für die einzelnen Knoten, die Informationen des Typs 'WrittenDestination' unterstützen, enthält nähere Informationen zu den enthaltenen Daten.

LocalEnvironment.Adapter
Diese untergeordnete Baumstruktur enthält Informationen, die von den WebSphere Adapter-Knoten gespeichert werden.
Für einen WebSphere Adapter-Empfangsknoten gilt Folgendes:
  • MethodName ist der Name der Geschäftsmethode, die dem EIS-Ereignis (Enterprise Information System) entspricht, das diese Nachrichtenübermittlung ausgelöst hat.

    Die Bindungen für EIS-Ereignisse oder Geschäftsmethoden werden vom Assistenten für Adapterverbindungen erstellt.

  • Type beschreibt den Typ des verwendeten Adapters:
    • SAP
    • Siebel
    • PeopleSoft
    • JD Edwards

Für einen WebSphere Adapters-Anforderungsknoten gilt Folgendes:

MethodName ist der Name der Geschäftsmethode, die der Anforderungsknoten verwenden muss.

LocalEnvironment.CD und LocalEnvironment.CD.Transfer
Diese untergeordneten Baumstrukturen enthalten Informationen, die vom CDInput-Knoten gespeichert werden. Die untergeordnete Baumstruktur LocalEnvironment.CD enthält Informationen zum aktuellen Datensatz. Die untergeordnete Baumstruktur LocalEnvironment.CD.Transfer enthält Informationen über die Datei, die von der IBM® Sterling Connect:Direct empfangen wurden.

Im Abschnitt Variablen der lokalen Umgebung mit Dateiknoten verwenden finden Sie weitere Informationen zu den Daten, die in diesen untergeordneten Baumstrukturen gespeichert sind.

LocalEnvironment.Database
Diese untergeordnete Baumstruktur enthält Informationen, die vom DatabaseInput-Knoten weitergegeben werden.

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.

LocalEnvironment.File
Diese untergeordnete Baumstruktur enthält Informationen, die vom FileInput-Knoten gespeichert werden.

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.

LocalEnvironment.FTE und LocalEnvironment.FTE.Transfer
Diese untergeordneten Baumstrukturen enthalten Informationen, die vom FTEInput-Knoten gespeichert werden. Die untergeordnete Baumstruktur LocalEnvironment.FTE enthält Informationen zum aktuellen Datensatz. Die untergeordnete Baumstruktur LocalEnvironment.FTE.Transfer enthält Informationen zur Datei, die von der WebSphere MQ File Transfer Edition empfangen wurden.

Im Abschnitt Variablen der lokalen Umgebung mit Dateiknoten verwenden finden Sie weitere Informationen zu den Daten, die in diesen untergeordneten Baumstrukturen gespeichert sind.

LocalEnvironment.JMS
Diese untergeordnete Baumstruktur enthält Informationen, die vom JMSReceive-Knoten gespeichert werden.

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.

LocalEnvironment.Mapping
Diese untergeordnete Baumstruktur enthält Informationen, die vom Mapping-Knoten gespeichert werden.

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.

LocalEnvironment.ServiceRegistry
Diese untergeordnete Baumstruktur enthält Informationen für Abfragen von den EndpointLookup- und RegistryLookup-Knoten.

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.

LocalEnvironment.SOAP
Diese untergeordnete Baumstruktur enthält Informationen, die von den SOAPInput-,SOAPAsyncResponse- oder SOAPRequest-Knoten gespeichert werden.

Im Abschnitt WS-Adressierungsdaten in der lokalen Umgebung finden Sie weitere Informationen zu den Daten, die in der untergeordneten Baumstruktur gespeichert sind.

Wenn der Nachrichtenfluss einen SOAPAsyncResponse-Knoten enthält, können Sie Status- und Korrelationsdaten, die von einem SOAPAsyncRequest-Knoten aus einem anderen Nachrichtenfluss übergeben wurden, über diese untergeordnete Baumstruktur empfangen.

Im Abschnitt WS-Adressierung mit den Knoten SOAPAsyncRequest und SOAPAsyncResponse finden Sie weitere Informationen zu den Daten, die in der untergeordneten Baumstruktur gespeichert sind.

LocalEnvironment.TCPIP

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.

Die folgenden Beispielprogramme veranschaulichen, wie Sie Nachrichten auf Grundlage der Zieladressenliste mithilfe der lokalen Umgebung dynamisch weiterleiten: Die folgenden Mustercodes verwenden die Baumstruktur für die lokale Umgebung, um Informationen zu speichern, die später zu der vom Nachrichtenfluss erstellten Ausgabenachricht hinzugefügt werden:

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.

Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Letzte Aktualisierung:
        
        Letzte Aktualisierung: 2015-02-28 16:19:49


KonzeptthemaKonzeptthema | Version 8.0.0.5 | ac00520_