Mit dem Tool „wrkmle“ (work message log entry) betrachten bzw. löschen Sie die Einträge der Meldungsprotokolle. Sie benötigen das zur Ablaufverfolgung bestimmter Dienste und Hintergrund-Anwendungen, zur Fehler-Analyse oder zur der Bereinigung von Datenbanken.
1 Zielgruppe
- System-Administratoren
- Technische Berater
2 Begriffsbestimmung
Die Meldungen des Systems haben zwei Funktionen. Einerseits bestätigt eine Meldung die gerade durchgeführte Aktion, wie zum Beispiel: Beschaffungsauftrag 4711 wurde geladen. Andererseits weisen Meldungen auf fehlende Eingaben hin. Meldungen umfassen auch Warnungen, die den Benutzer über den Systemzustand informieren. Meldungen und Warnungen sind typisiert, um einen Schweregrad der Meldung oder Warnung zu kennzeichnen. Damit der Benutzer den Schweregrad leicht erkennt, sind alle Meldungstypen mit einem Bildsymbol (Piktogramm) versehen.
Meldungsprotokoll
Im Meldungsprotokoll werden Meldungen protokolliert, die in einer Session auftreten. Die Meldungsprotokoll-Einträge enthalten neben der eigentlichen Meldung Kontextinformationen, wie den aktiven Benutzer und die aktive Anwendung. Ob und wann Meldungen protokolliert werden, ist abhängig von der Schwere der Meldung, der Anwendungslogik und vom Ein-/Ausgabekanal. Meldungsprotokolle existieren auf der Repository-Datenbank und auf jeder OLTP-Datenbank.
Meldungstyp
Meldungen werden einem Meldungstyp zugeordnet, um einen Schweregrad der Meldung zu kennzeichnen. Damit der Benutzer den Schweregrad leicht erkennt, sind alle Meldungstypen mit einem Bildsymbol (Piktogramm) versehen. Eine Meldung in Form eines Hinweises gibt Auskunft über eine abgeschlossene Transaktion, wie zum Beispiel: Der Auftrag 4711 wurde geladen. Meldungen in Form von Warnungen geben Auskunft über fehlende oder falsche Angaben, die für einen erfolgreichen Abschluss einer Transaktion zu beheben sind.
3 Beschreibung
Das Tool dient zum Anzeigen bzw. Löschen der Einträge der Meldungsprotokolle auf einer oder mehreren Datenbanken.
3.1 Befehl
Nachfolgend finden Sie den Befehl inklusive aller möglichen Parameter.
| wrkmle | [-display] [-delete] [-user:<str-1> …
-user:<str-n>] [-svm:<str-1> … -svm:<str-n>] [-system] [-repository] [-oltp:<str-1> … -oltp:<str-n>] [-all] |
3.2 Parameter
Die Parameter des Befehls werden in der folgenden Tabelle erläutert. Die in eckigen Klammern gesetzten Parameter sind optional, die anderen hingegen sind Pflichtparameter. Für einige Parameter kann ein Stern (*) als Platzhalter angegeben werden, um damit alle möglichen Werte ausgeben zu können. Nicht alle Parameter können mehrfach genannt werden, nur die, die folgenden Zusatz an den Parametervariablen aufweisen, sind für die Mehrfachnennung zugelassen: „<str-1> … <str–n>“.
| Parameter | Erläuterung |
| [-display] | Ausgewählte Meldungsprotokoll-Einträge anzeigen. |
| [-delete] | Ausgewählte Meldungsprotokoll-Einträge löschen. |
| [-all] | Alle Meldungsprotokoll-Einträge auf allen Datenbanken auswählen. |
| [-system] | Meldungsprotokoll-Einträge auswählen, die im Systemprotokoll auf der Repository-Datenbank gespeichert sind. |
| [-repository] | Meldungsprotokoll-Einträge auswählen, die im Anwendungsprotokoll auf der Repository -Datenbank gespeichert sind. |
| [-oltp:<str-1> …
-oltp:<str-n>] |
Meldungsprotokoll-Einträge auswählen, die im Anwendungsprotokoll auf dieser OLTP-Datenbank gespeichert sind. |
| [-user:<str-1> …
-user:<str-n>] |
Meldungsprotokoll-Einträge auf den angegebenen Datenbanken auswählen, die für diesen Benutzer erzeugt wurden. |
| [-svm:<str-1> …
-svm:<str-n>] |
Meldungsprotokoll-Einträge auf den angegebenen Datenbanken auswählen, die auf diesem Application Server erzeugt wurden. |
3.3 Berechtigungen
Das Berechtigungskonzept sowie die generellen anwendungsbezogenen und Entity-bezogenen Berechtigungen können Sie in der Technischen Dokumentation im Dokument Berechtigungen nachlesen.
Für das Löschen der Meldungsprotokoll-Einträge ist das folgende Business Entity relevant
com.cisag.sys.kernel.obj.MessageLogEntry
Um Meldungsprotokoll-Einträge die von anderen Benutzern erstellt wurden Anzuzeigen oder zu Löschen benötigen Sie folgende speziellen Fähigkeiten:
- cisag.sys.kernel.messagelog.DisplayOtherUsersEntries
„Meldungsprotokoll-Einträge anderer Benutzer anzeigen“
- cisag.sys.kernel.messagelog.DeleteOtherUsersEntries
„Meldungsprotokoll-Einträge anderer Benutzer löschen“