ESQL-Datei erstellen

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

Vorbereitungen

Zur vollständigen Ausführung dieser Task muss die folgende Task abgeschlossen worden sein:

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

So erstellen Sie eine ESQL-Datei:

  1. Wechseln Sie zur Ansicht 'Brokeranwendungsentwicklung'.
  2. Klicken Sie auf Datei > Neu > ESQL-Nachrichtenflussdatei.

    Sie können auch Strg+N drücken. Dies ruft einen Dialog auf, in dem Sie den Assistenten zum Erstellen eines neuen Objekts auswählen können. Klicken Sie in der linken Ansicht auf 'Nachrichtenbroker'; in der rechten Ansicht wird eine Liste mit Objekten angezeigt, die Sie für WebSphere Message Broker erstellen können. Klicken Sie in der rechten Ansicht auf 'ESQL-Nachrichtenflussdatei' und dann auf Weiter.

    Es wird der Assistent Neue ESQL-Nachrichtenflussdatei aufgerufen.
  3. Geben Sie den Namen des Nachrichtenflussprojekts ein, in dem die ESQL-Datei erstellt werden soll. Sie müssen den Namen eines vorhandenen Nachrichtenflussprojekts eingeben. Es wird der Dialog mit dem aktuellen Projektnamen aufgerufen, der im Projektnamensfeld eingegeben wurde. Sie können diesen Wert annehmen oder ihn ändern, um ein anderes Projekt anzugeben. Sie können auch auf Durchsuchen klicken, um eine Liste mit gültigen Projekten (Projekte, die in der Navigatoransicht definiert und angezeigt werden) anzuzeigen und den entsprechenden Wert in der Liste auswählen.

    Wenn Sie den Namen eines Projekts eingeben, das nicht existiert, wird im Dialog die Fehlernachricht Das angegebene Projekt ist nicht vorhanden angezeigt. Sie können erst fortfahren, wenn Sie einen gültigen Projektnamen eingegeben haben.

  4. Soll die ESQL-Datei in einem bestimmten Brokerschema definiert werden, geben Sie den Namen des Brokerschemas im entsprechenden Eingabefeld ein, oder klicken Sie auf Durchsuchen, um das Brokerschema aus der Liste gültiger Brokerschemas für dieses Projekt auszuwählen. (Falls nur das standardmäßige Brokerschema in diesem Projekt definiert ist, ist Durchsuchen inaktiviert.)
  5. 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 im Dialog die Fehlernachricht Die Ressource '<Name>.esql' ist bereits vorhanden angezeigt. Sie können erst fortfahren, wenn Sie einen gültigen Namen angegeben haben.

    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.

Eine ESQL-Datei kann auch automatisch für Sie erzeugt werden. Wenn Sie mit der rechten Maustaste auf einen Rechen-, Datenbank- oder Filterknoten klicken, im daraufhin angezeigten Menü die Option 'ESQL öffnen' wählen und das Modul, das von der entsprechenden Eigenschaft identifiziert wird, noch nicht im Brokerschema vorhanden ist, wird automatisch ein Modul für Sie erstellt. Dieses Modul wird in der Datei <Nachrichtenflussname>.esql im gleichen Brokerschema innerhalb des gleichen Projekts der Datei <Nachrichtenflussname>.msgflow erstellt. Falls diese ESQL-Datei noch nicht vorhanden ist, wird sie ebenfalls für Sie erzeugt.

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. Geben Sie hierfür an, dass das Projekt, das die Subroutinen aufrufen will, von dem Projekt abhängt, in dem die ESQL-Datei, die sie enthält, definiert ist. Sie können dies bei der Erstellung des zweiten Projekts angeben, oder Sie können Projektabhängigkeiten aktualisieren, indem Sie das Projekt auswählen, auf Eigenschaften klicken und die Abhängigkeiten im Dialog 'Eigenschaften' auf der Seite 'Projektverweis' aktualisieren.

Zugehörige Konzepte
Projektverweise
Entwicklungsrepository
Nachrichtenflüsse - Übersicht
Nachrichtenzuordnungen - Übersicht
Brokerschemas
ESQL-Module
Zugehörige Tasks
Nachrichtenflüsse entwickeln
Zugehörige Verweise
Integrierte Knoten
ESQL-Referenz
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
ak09031_