ESQL-Editor

Der ESQL-Editor ist der Standardeditor in der Ansicht 'Brokeranwendungsentwicklung' für das Bearbeiten von ESQL-Dateien (.esql).

Der Editor wird im Editorbereich geöffnet, wenn Sie für einen Rechen-, Datenbank-, oder Filterknoten den Menüpunkt ESQL öffnen auswählen oder wenn Sie in der Navigatoransicht doppelt auf eine ESQL-Datei klicken.

Ansichten für den ESQL-Editor

Der ESQL-Editor enthält folgende Ansichten:

Ansicht 'Ressourcennavigator'
In der Navigatoransicht werden alle Ressourcen Ihres Arbeitsbereiches angezeigt, also alle Ressourcen der Nachrichtengruppen und alle Ressourcen der Nachrichtenflüsse, einschließlich ESQL-Dateien.
Editoransicht
In der Editoransicht werden die Inhalte der aktuell geöffneten Ressource angezeigt. Außerdem wird für jede geöffnete Ressource eine Registerkarte angezeigt, so dass Sie sich schnell zwischen den Ressourcen bewegen können.
Entwurfsansicht
In der Entwurfsansicht werden alle Schemas, definierten Konstanten, Module und Routinen angezeigt, auf die in dieser ESQL-Datei verwiesen wird.
Tasks-Ansicht
In der Tasks-Ansicht werden die Warnungs- und Fehlernachrichten angezeigt, die von der Editorauswertung generiert werden, wenn Sie eine ESQL-Datei speichern. Wenn Sie doppelt auf einen Fehler klicken, zeigt der Editor dessen Position an, indem er den entsprechenden ESQL-Code hervorhebt.

Funktionen des ESQL-Editors

Der ESQL-Editor umfasst:

  • Eine kontextabhängige Inhaltshilfe. Sie können die Inhaltshilfe vom Menü 'Bearbeiten' aus aufrufen oder auf einigen Systemen auch durch Drücken der Steuerungs- und Leertaste (falls diese Kombination nicht einer anderen Funktion zugeordnet wurde).

    Die Inhaltshilfe unterstützt Sie, wenn Sie Verweise auf den Inhalt des Eigenschaftenordners erstellen möchten. Wenn Sie den ESQL-Editor mit vordefinierten Nachrichten verwenden, unterstützt die Hilfe Sie auch beim Erstellen von Feldverweisen.

    Wenn Sie den ESQL-Editor mit den Definitionen des Datenbankschemas verwenden, unterstützt die Inhaltshilfe Sie auch beim Erstellen von Schemas, Tabellen und Spaltenverweisen. Sie können mit dem ESQL-Editor auch benutzerdefinierte Zuordnungen aufrufen.

    Wenn Sie in der ESQL-Datei Funktionen und Prozeduren erstellen, dürfen die von Ihnen definierten Namen nicht mit den Zeichen "IBM_" (IBM Unterstrich) beginnen.

  • Automatische Code-Formatierung

Klicken Sie mit der rechten Maustaste in die Editoransicht, um auf folgende zusätzliche Funktionen zugreifen zu können:

  • Rückgängig machen und Zurücksetzen. Wenn Sie Ihre Änderung an einer ESQL-Datei wieder rückgängig machen möchten, klicken Sie auf Rückgängig machen. Wenn Sie eine Änderung rückgängig gemacht haben, können Sie diese wieder wiederherstellen, indem Sie auf Zurücksetzen klicken.
  • Ausschneiden, Kopieren und Einfügen. Dies sind standardmäßige Bearbeitungsfunktionen.
  • Nach rechts verschieben und Nach links verschieben. Dies sind standardmäßige Bearbeitungsfunktionen.
  • Speichern. Klicken Sie auf diese Option, um Ihre Änderungen zu speichern.
  • Kommentarzeichen setzen und Kommentarzeichen entfernen. Klicken Sie auf Kommentarzeichen setzen, um eine Zeile eines ESQL-Codes in Kommentarzeichen zu setzen. Klicken Sie auf Kommentarzeichen entfernen, um die Kommentarzeichen aus der Zeile eines ESQL-Codes zu entfernen.
  • Format. Diese Funktion formatiert alle ausgewählten Zeilen eines Codes (nicht bei unvollständig markierten Zeilen; diese werden ignoriert) bzw. formatiert die gesamte Datei (und korrigiert dabei Ausrichtung und Einrückung), falls keine Zeilen ausgewählt wurden.
  • Schemapfade organisieren und Schemapfad hinzufügen. Diese Funktionen helfen Ihnen bei der Verwaltung von Brokerschemas.

    Wenn Sie auf Schemapfad organisieren klicken, wird jedes Brokerschema, das von der ESQL-Datei aufgerufene Prozeduren oder Funktionen enthält, automatisch der PATH-Anweisung hinzugefügt (falls dies noch nicht geschehen ist). Diese Funktion durchsucht die ESQL-Dateien nach Prozeduren oder Funktionen, die sich in Schemas befinden, die in der Datei noch nicht vollständig qualifiziert wurden.

    Klicken Sie auf Schemapfad hinzufügen, wenn Sie den Aufruf einer Prozedur oder Funktion codieren wollen, die sich in einem Brokerschema befindet, das noch nicht in der PATH-Anweisung enthalten ist, um dieses Schema zur PATH-Anweisung hinzuzufügen. Vergewissern Sie sich, dass der Cursor auf dem Namen der von Ihnen aufgerufenen Prozedur steht.

Benutzervorgaben des ESQL-Editors

Sie können die Einstellungen, die die Art und Weise beeinflussen, wie der ESQL-Code behandelt wird, ändern:

  • Einstellungen für die Codegenerierung (Art des generierten Laufzeit-Codes):
    Für Zugriff auf RDB-Tabellen verwendeter Schemaname
    Wählen Sie eines der folgenden Optionsfelder aus, um das Schema anzugeben, mit dem ein Verweis auf eine Datenbanktabelle in Ihrem ESQL eingeschlossen werden soll:
    Standardlaufzeitschema für diese Datenquelle verwenden
    Bei Auswahl dieser Option wird das Standardschema der Datenquelle verwendet.
    Schemaname aus Tabellendefinition verwenden
    Bei Auswahl dieser Option wird das Schema verwendet, das Sie bei Erstellung der Tabellendefinition angegeben haben.
    Angegebenen Namen verwenden
    Bei Auswahl dieser Option wird der Schemaname verwendet, den Sie im zugeordneten Texteingabefeld eingegeben haben.
    Standardmäßige Kompatibilitätsstufe
    Sie können aus der Dropdown-Liste entweder 5.0 oder 2.1 auswählen:
    5.0
    Wenn Sie diesen Wert auswählen, kann ein kompilierter Nachrichtenfluss nur für Broker der Version 5.0 implementiert werden, da der generierte ESQL-Laufzeitcode nicht mit früheren Versionen kompatibel ist. Wenn Sie für den ESQL-Code innerhalb Ihrer Nachrichtenflüsse Debugs ausführen möchten, ist diese Einstellung erforderlich. Sie wird darüber hinaus benötigt, wenn Ihr Nachrichtenfluss Knoten enthält, die über Zuordnungsdateien (.mfmap) verfügen. Wenn Sie diesen Wert setzen und eine BAR-Datei, die einen Nachrichtenfluss mit ESQL-Laufzeitcode der Version 5.0 enthält, für einen Broker der Version 2.1 implementieren, wird vom Broker ein Fehler generiert, sobald er den Nachrichtenfluss startet.

    Dies ist die Standardeinstellung.

    2.1
    Diesen Wert müssen Sie auswählen, wenn Sie Ihren Nachrichtenfluss für Broker der Version 2.1 implementieren möchten. Sie können diese Nachrichtenflüsse auch für Broker der Version 5.0 implementieren. Sie dürfen jedoch keinen Inhalt einfügen, der sich speziell auf Version 5.0 bezieht (z. B. eine Zuordnungsdatei oder eine BROKER SCHEMA-Anweisung). Wenn Sie diesen Wert gesetzt haben und eine BAR-Datei implementieren, die einen Nachrichtenfluss mit ESQL-Laufzeitcode der Version 5.0 enthält, schlägt dies fehl.

    Wird diese Einstellung von 5.0 in 2.1 oder umgekehrt geändert, müssen alle Nachrichtenflussprojekte in Ihrem Arbeitsbereich erneut erstellt werden. Wird dies unterlassen, werden bei der Implementierung einer BAR-Datei, die einen oder mehrere dieser Nachrichtenflüsse enthält, unter Umständen Fehler ausgegeben.

  • Editoreinstellungen (Darstellung des Codes in der Editoransicht):
    • Schriftart des Textes
    • Angezeigte Tabellenbreite (Standardwert 4)
    • Hintergrund- und Vordergrundfarben (für Kommentarzeichen, Anweisungen usw.)
  • Überprüfungseinstellungen (die beim Speichern der Datei ausgeführte Überprüfungsebene):

    Bei der Gültigkeitsprüfung werden vier mögliche Probleme erkannt:

    Unaufgelöste IDs
    Das Prüfprogramm versucht, alle Kennungen aufzulösen, auf die Sie verwiesen haben (z. B. ein Nachrichtenfeld).
    Abweichungen zwischen Nachrichtenverweisen und Nachrichtendefinition
    Falls eine Nachrichtendefinition existiert (nur Nachrichten in der MRM-Domäne), überprüft das Prüfprogramm, ob die Verwendung des Verweises konsistent mit der zugehörigen Definition ist (dass z. B. eine Aktion für ein numerisches Feld auch eine gültige numerische Aktion ist).
    Abweichungen zwischen Datenbankverweisen und dem Datenbankschema
    Das Prüfprogramm überprüft, ob die Verwendung des Verweises konsistent mit dem Datenbankschema ist (dass z. B. eine Aktion für ein numerisches Feld auch eine gültige numerische Aktion ist).
    Verwendung veralteter Schlüsselwörter
    Das Prüfprogramm überprüft, ob Sie Schlüsselwörter verwendet haben, die in diesem Release veraltet sind.

    Sie können in jeder dieser Situationen eine der folgenden Einstellungen für die Gültigkeitsprüfung wählen:

    Ignorieren
    Es wird keine Gültigkeitsprüfung ausgeführt.
    Warnung
    Das Prüfprogramm schreibt für jedes festgestellte mögliche Problem Warnungen in die Tasks-Ansicht. Dies ist die Standardeinstellung.
    Fehler
    Das Prüfprogramm schreibt für jedes festgestellte mögliche Problem Fehlernachrichten in die Tasks-Ansicht.

    Die Gültigkeitsprüfung überprüft nicht, ob die von Ihnen definierten Namen der vorgegebenen Groß-/Kleinschreibung entsprechen. Bei Namen von Modulen, Funktionen und Prozeduren muss die Groß-/Kleinschreibung im Gegensatz zu allen anderen Namen (Schemas, Konstanten, Variablen und Beschriftungen) nicht beachtet werden. Überprüfen Sie, ob die von Ihnen verwendeten Namen den Angaben zu diesen Namen entsprechen, da der Broker bei diesen Namen die Groß-/Kleinschreibung beachtet und bei Nichtübereinstimmung einen Laufzeitfehler generiert.

Weitere Informationen, wie Sie diese Einstellungen ändern können, finden Sie unter ESQL-Einstellungen ändern.

Funktionsleiste des ESQL-Editors

Im ESQL-Editor gibt es keine weiteren Symbole oder Aktionen in der Funktionsleiste.

Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2005 Letzte Aktualisierung: 9 Nov 2005
ab00083_