Zum Hauptinhalt springen

DbaLog

DbaLog(int1, logic2, alpha3)​

Ausführbar von Clients mit grafischer Oberfläche Ausführbar vom Server Ausführbar von Clients mit Programmierschnittstelle Ausführbar von der Web-Schnittstelle Ausführbar vom Druckprozessor Ausführbar von der ODBC-Schnittstelle Ausführbar vom SOA-Service

Benutzerlog schreiben

Details

Mit diesem Befehl wird ein Benutzerlog für die Datenbank geschrieben. Beim ersten Aufrufen dieses Befehls wird im Verzeichnis der Datenbank eine Datei mit dem Namen der Datenbank und der Dateierweiterung lgu angelegt (zum Beispiel CodeLibrary.lgu). In dieser Datei können Log-Einträge durch den Benutzer/Programmierer vorgenommen werden.

Die Benutzereinträge werden in drei Klassen unterschieden, die in (int1) angegeben wird:

  • _LogInfo Diese Einträge sollten nur informativen Charakter besitzen.
  • _LogWarning Der Eintrag kennzeichnet einen Warnzustand.
  • _LogError Der Eintrag kennzeichnet einen Fehlerzustand.

Zusätzlich können die Klassifizierungen _LogWarning und _LogError mit der Option _LogAlert kombiniert werden, um den eingefügten Log-Eintrag als Alert-Mail (siehe automatische E-Mail-Benachrichtigung ), an die in AlertMailTo definierte E-Mail-Adresse, zu versenden. Der Betreff für die Alert-Mail lautet "CONZEPT 16 Application alert: <Datenbankname>". Der Versand erfolgt asynchron.

Die unterschiedlichen Klassen werden bei der Anzeige des Protokolls mit dem Log-Viewer durch entsprechende Symbole gekennzeichnet. Neben den übergebenen Parametern wird in der Log-Datei das Datum und die Uhrzeit festgehalten. Mit dem Parameter (logic2) wird definiert, ob es sich bei dem Eintrag um einen Systemeintrag (true) handelt, oder nicht (false). Systemeinträgen wird in der Log-Datei eine höhere Priorität bei der Langzeitspeicherung gewährt (siehe Benutzerlogs ). Die Benutzer-ID wird nur dann eingetragen, wenn es sich bei dem Log-Eintrag nicht um einen System-Eintrag (logic2 = false) handelt.

info

Das Benutzerlog hat eine Auflösung von 10 Millisekunden. Bei einer zu großen Anzahl an Einträgen verschiebt sich der Zeitpunkt in die Zukunft.

Im Parameter (alpha3) wird der zu speichernde Meldungstext angegeben. Es ist darauf zu achten, dass die Größe der Log-Datei mit der Länge der hier übergebenen Zeilen zusammenhängt und daher bei zu langen Inhalten schnell steigen kann.

Mögliche Laufzeitfehler: