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 die Tastenkombination Strg+N drücken. Daraufhin wird ein Dialogfeld angezeigt, in dem Sie den Assistenten für die Erstellung 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. Beginn der ÄnderungGeben 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 das Dialogfeld 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. Die Liste wird so gefiltert, dass nur Projekte im aktiven Arbeitsbereich angezeigt werden.

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

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

    Aufgrund einer Begrenzung im Dateisystem unter Windows darf bei der Erstellung von ESQL-Dateien der gesamte Dateipfad nicht mehr als 256 Zeichen enthalten. Wenn Sie einen Nachrichtenfluss mithilfe von ESQL oder einer Zuordnungsdatei mit einem Pfad mit mehr als 256 Zeichen zu einer Brokerarchivdatei hinzufügen möchten, wird der kompilierte Nachrichtenfluss nicht generiert und kann nicht implementiert werden. Stellen Sie deshalb sicher, dass Sie die Namen Ihrer ESQL-Dateien, Zuordnungsdateien, Projekte und Brokerschemas möglichst kurz halten.

Eine ESQL-Datei kann auch automatisch erstellt werden. Durch Klicken mit der rechten Maustaste auf einen Rechen-, Datenbank- oder Filterknoten wird ein Menü angezeigt. Wenn Sie die Option 'ESQL öffnen' auswählen und das Modul, das durch das entsprechende Merkmal gekennzeichnet ist, ist noch nicht im Brokerschema vorhanden, wird automatisch ein Modul erstellt. Dieses Modul wird in der Datei <Nachrichtenflussname>.esql im gleichen Brokerschema innerhalb des gleichen Projekts der Datei <Nachrichtenflussname>.msgflow erstellt. Wenn diese ESQL-Datei noch nicht vorhanden ist, wird sie automatisch erstellt.

Die Inhalte einer einzelnen ESQL-Datei haben keine besondere 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 den Umfang der ESQL innerhalb jeder Datei und teilen Sie die Datei, falls die Anzeige oder Verwaltung schwierig wird.

Wenn Sie in einer ESQL-Datei auf der Ebene von Brokerschemas wiederverwendbare Unterroutinen erstellen, möchten Sie möglicherweise von ESQL-Modulen in einem anderen Projekt auf diese Routinen verweisen. Geben Sie dazu an, dass das Projekt, in dem die Unterroutinen aufgerufen werden sollen, von dem Projekt abhängt, in dem die ESQL-Datei mit den Unterroutinen 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 Dialogfeld '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 | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Letzte Aktualisierung : 2009-02-17 15:29:33

ak09031_