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.

ESQL-Datei erstellen

Wenn Sie einen Knoten in Ihren Nachrichtenfluss einschließen, der ESQL zur Anpassung seiner Funktion erfordert (die Compute-, Datenbank-, DatabaseInput- und Filter-Knoten), müssen Sie die ESQL-Anweisungen, die die Anpassung bereitstellen, in einem ESQL-Modul in einer ESQL-Datei codieren. Sie können die gleiche ESQL-Datei für mehrere Module verwenden.

Bevor Sie beginnen:

Hintergrundinformationen finden Sie im Abschnitt Übersicht zu ESQL.

Sie können vor der Erstellung einer ESQL-Datei ein Anwendung, eine Bibliothek oder ein Nachrichtenbrokerprojekt erstellen. Ebenso können Sie das Projekt, das die ESQL-Datei enthalten soll, auch bei der Erstellung der ESQL-Datei erstellen.

ESQL-Dateien sind in einem Dateisystem oder in einem gemeinsamen Repository gespeichert. Wenn Sie ein Dateisystem verwenden, kann es sich hierbei um ein lokales Dateisystem oder ein gemeinsam genutztes Laufwerk handeln. Speichern Sie Dateien in einem Repository, können Sie jedes der verfügbaren Repositorys verwenden, die von Eclipse unterstützt werden, z. B. CVS.

Gehen Sie zum Erstellen einer ESQL-Datei wie folgt vor:

  1. Klicken Sie auf Datei > Neu > ESQL-Nachrichtenflussdatei.

    Sie können auch in der Ansicht Brokerentwicklung auf Neu und anschließend auf ESQL-Nachrichtenflussdatei klicken.

    Der Assistent Neue Nachrichtenfluss-ESQL-Datei wird geöffnet.
  2. Wählen Sie eine bereits vorhandene Anwendung oder Bibliothek bzw. ein vorhandenes Nachrichtenbrokerprojekt aus, in der bzw. in dem die ESQL-Datei erstellt werden soll, oder klicken Sie auf Neu, um einen neuen Container zu erstellen.
  3. Geben Sie einen Namen für die neue ESQL-Datei ein. Wenn Sie einen Namen eingeben, der bereits für eine andere ESQL-Datei in diesem Projekt verwendet wird, wird die Fehlernachricht Die Ressource '<Name>.esql' ist bereits vorhanden angezeigt und Sie müssen einen anderen Namen angeben.

    Bei der Erstellung von ESQL-Dateien darf die Gesamtlänge des Dateipfads 256 Zeichen nicht überschreiten. Dies ist auf eine Begrenzung des Windows-Dateisystems zurückzuführen. Falls Sie versuchen, einen Nachrichtenfluss einer Brokerarchivdatei mit ESQL- oder Zuordnungsdateien mit einer Pfadlänge von mehr als 256 Zeichen hinzuzufügen, wird der kompilierte Nachrichtenfluss nicht generiert und kann nicht eingesetzt werden. Aus diesem Grund sollten Sie sicherstellen, dass der Name Ihrer ESQL-Dateien, Zuordnungsdateien, Projekte und Brokerschemas so kurz wie möglich gehalten sind.

  4. Sie können die ESQL-Datei in einem bestimmten Brokerschema definieren, indem Sie Standardbrokerschema verwenden inaktivieren und entweder ein Brokerschema aus der Dropdown-Liste auswählen oder den Namen des Brokerschemas eingeben.
  5. Klicken Sie auf Finish (Fertigstellen).

Die ESQL-Datei wird im Editor geöffnet, in dem Sie die Datei bearbeiten und anschließend speichern können. Die ESQL-Datei wird in der Ansicht Brokerentwicklung unterhalb des ESQL-Ordners der Anwendung, der Bibliothek oder des Nachrichtenbrokerprojekts angezeigt, die bzw. das die ESQL-Datei enthält.

Eine ESQL-Datei kann auch automatisch für Sie erzeugt werden. Sie können mit der rechten Maustaste auf einen Compute-, Datenbank-, DatabaseInput- oder Filter-Knoten klicken und dann auf ESQL öffnen klicken. Falls das durch die entsprechende Eigenschaft identifizierte Modul noch nicht im Brokerschema vorhanden ist, wird automatisch ein Modul erstellt. Dieses Modul wird in der Datei <Nachrichtenflussname>.esql im selben Brokerschema im selben Projekt wie die Datei <Nachrichtenflussname>.msgflow erstellt. Falls diese ESQL-Datei noch nicht vorhanden ist, wird sie ebenfalls automatisch erstellt.

Der Inhalt einer einzelnen ESQL-Datei hat keine bestimmte Beziehung zu Nachrichtenflüssen und Knoten. Es hängt von Ihnen ab, welche Module in welchen Dateien erstellt werden (es sein denn, das durch das entsprechende Merkmal gekennzeichnete Modul wird, wie oben beschrieben, standardmäßig in der Datei <Nachrichtenflussname>.esql erstellt). Überwachen Sie die Größe und Komplexität des ESQL in jeder Datei und teilen Sie die Datei auf, falls sie unübersichtlich oder schwer zu verwalten ist.

Wenn Sie wiederverwendbare Subroutinen (auf Brokerschema-Ebene) in einer ESQL-Datei erstellen, können Sie darauf von ESQL-Modulen in einem anderen Projekt verweisen. Um auf die Routinen zu verweisen, müssen Sie angeben, dass das Projekt, das die Subroutinen ausführt, von dem Projekt abhängt, in dem die ESQL-Datei, die sie enthält, definiert ist. Sie können dieses Verhalten bei der Erstellung des zweiten Projekts angeben oder einen Projektverweis erstellen (siehe Bibliotheksreferenzen hinzufügen und entfernen).

Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

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

        
        Letzte Aktualisierung:
        
        Letzte Aktualisierung: 2015-02-28 16:21:37


TaskthemaTaskthema | Version 8.0.0.5 | ak09031_