ESQL-Datei erstellen

Wenn Sie einen Knoten in Ihren Nachrichtenfluss einschließen, der ESQL zur Anpassung seiner Funktion erfordert (die Knoten Rechen, Datenbank, DatabaseInput und Filter), 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.

Vorbereitungen:

Hintergrundinformationen finden Sie im Abschnitt Übersicht zu ESQL.

Es muss ein Nachrichtenflussprojekt vorhanden sein, das die ESQL-Datei enthalten soll.

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 die Tastenkombination Strg+N drücken. Daraufhin wird ein Dialogfenster angezeigt, in dem Sie den Assistenten für die Erstellung eines neuen Objekts auswählen können. Klicken Sie auf 'Nachrichtenbroker'. Daraufhin wird eine Liste mit Objekten angezeigt, die Sie für WebSphere Message Broker erstellen können. Klicken Sie auf ESQL-Nachrichtenflussdatei und dann auf Weiter.

    Der Assistent Neue Nachrichtenfluss-ESQL-Datei wird geöffnet.
  2. 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 das Dialogfenster 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 Dialogfenster die Fehlernachricht Das angegebene Projekt ist nicht vorhanden angezeigt. Sie können erst fortfahren, wenn Sie einen gültigen Projektnamen eingegeben haben.

  3. 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. (Wenn das standardmäßige Brokerschema das einzige Schema ist, das in diesem Projekt definiert ist, ist Durchsuchen inaktiviert.)
  4. 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.

  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.

Eine ESQL-Datei kann auch automatisch für Sie erzeugt werden. Sie können mit der rechten Maustaste auf einen Rechen, 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 Projektabhängigkeiten aktualisieren, indem Sie das Projekt auswählen, auf Eigenschaften klicken und die Abhängigkeiten im Dialogfenster 'Eigenschaften' auf der Seite 'Projektverweis' aktualisieren.

Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
        Letzte Aktualisierung
        
        Letzte Aktualisierung : 2012-08-06 17:57:43


TaskthemaTaskthema | Version 7.0.0.5 | ak09031_