DELETE-FT-LOGGING-RECORDS

Einsatzhinweis

Funktion: Logging-Sätze oder Offline-Logging-Dateien löschen

Benutzergruppe: FT-Verwalter, FTAC-Verwalter

Aliasname: FTDELLOG

Funktionsbeschreibung

Mit dem Kommando DELETE-FT-LOGGING-RECORDS können Sie als FT- oder FTAC-Verwalter Logging-Sätze aller Benutzerkennungen und aller Satztypen (FT, FTAC, ADM) aus der aktuellen Logging-Datei löschen.

Außerdem können Sie nicht mehr benötigte Offline-Logging-Dateien löschen. Offline-Logging-Dateien können nur als Ganzes gelöscht werden, das Löschen einzelner Logging-Sätze aus einer Offline-Logging-Datei ist nicht möglich.

Im Prinzip schreibt openFT beliebig viele Logging-Sätze. In regelmäßigen Zeitabständen - bei hohem Auftragsvolumen zum Beispiel wöchentlich - sollten Sie als FT-Verwalter die vorhandenen Logging-Sätze sichern, zum Beispiel auf Band oder als Datei im CSV-Format, und anschließend ältere Logging-Sätze löschen. Dadurch bleiben zum einen die Logging-Sätze für eine lückenlose Dokumentation über einen längeren Zeitraum erhalten, zum anderen wird nicht unnötig Speicherplatz belegt.

Die Logging-Sätze sichern Sie beispielsweise, indem Sie die Ausgabe des Kommandos SHOW-FT-LOGGING-RECORDS (Logging-Sätze anzeigen) im CSV-Format in eine Datei umleiten:

/ASSIGN-SYSLST LOGGING-DATEI

/SHOW-FT-LOGGING-RECORDS...,NUMBER=*ALL,OUTPUT=*SYSLST(*CSV)

Für das Sichern der Logging-Sätze ist das CSV-Format dem Standard-Format vorzuziehen, da dort alle Informationen in „einer Zeile“ gesichert werden und die Informationen mit verschiedenen Tools weiterverarbeitet werden können.

Beim Löschen von Logging-Sätzen wird kein von der Logging-Datei belegter Plattenspeicher freigegeben. Der freie Platz innerhalb der Datei wird aber zur Aufnahme neuer Sätze benutzt.

Bei sehr großen Logging-Dateien dauert das Löschen von Logging-Sätzen eventuell mehrere Minuten! Ein Abbruch mit der K2-Taste ist wegen möglicher Inkonsistenzen nicht zulässig.

Hier empfiehlt sich folgende Vorgehensweise:

• Logging-Datei wechseln mit MODIFY-FT-OPTIONS LOGGING=*CHANGE-FILES. Die aktuelle Logging-Datei wird "offline". Neue Logging-Sätze werden nun in eine neue Logging-Datei geschrieben.

• Nach einem gewissen Zeitabstand alle Logging-Sätze der Offline-Logging-Datei auswerten und archivieren mit SHOW-FT-LOGGING-RECORDS.

• Offline-Logging-Datei löschen mit DELETE-FT-LOGGING-RECORDS.

Die Standardeinstellung des Kommandos DELETE-FT-LOGGING-RECORDS hat sich in der openFT 11.0 geändert. Geben Sie das Kommando ohne Parameter an, wird der Standardwert *PARAMETERS() statt wie bisher *ALL verwendet, d.h. es werden alle Logging-Sätze gelöscht, die bis 00:00 Uhr des aktuellen Tages geschrieben wurden. Damit bleibt das Kommando vom Verhalten her abwärtskompatibel.

Format

DELETE-FT-LOGGING-RECORDS / FTDELLOG

SELECT = *ALL / *OWN / *PAR AMETERS(...) / *LOGGING-FILES (...)

*PARAMETERS(...)

OWNER-IDENTIFICATION = *ALL / *OWN / <name 1..8>

,LOGGING-DATE = *TODAY / *TOMORROW / <date 8..10>

,LOGGING-TIME = 00:00 / <time 1..8>

,RECORD-TYPE = *ALL / *PARAMETERS(...)

*PARAMETERS(...)

FT = *ALL / *NONE

,FTAC = *ALL / *NONE

,ADM = *ALL / *NONE

,LOGGING-ID = *ALL / <alphanum-name 1..12>

*LOGGING-FILES(...)

BEFORE = *TIME (...)

*TIME = (...)

DATE = <date 8..10>

,TIME = 00:00 / <time1..8>

Beschreibung der Operanden

SELECT =

Wählt eine Gruppe von Logging-Sätzen aus.

SELECT = *ALL

Löscht alle Logging-Sätze.

SELECT = *OWN
Löscht alle Logging-Sätze der eigenen Kennung.

SELECT = *PARAMETERS(...)

OWNER-IDENTIFICATION =

Benutzerkennung, deren Logging-Sätze gelöscht werden.

OWNER-IDENTIFICATION = *ALL
Die Benutzerkennung ist nicht Auswahlkriterium.

OWNER-IDENTIFICATION = *OWN
Löscht die Logging-Sätze der eigenen Kennung.

OWNER-IDENTIFICATION = <name 1..8>
Benutzerkennung, deren Logging-Sätze gelöscht werden.

LOGGING-DATE =
Datum, bis zu dem die Logging-Sätze gelöscht werden.

LOGGING-DATE = *TODAY
Wenn mit LOGGING-TIME eine Uhrzeit explizit angegeben wurde, werden alle Log-ging-Sätze, die bis zu dieser Uhrzeit geschrieben wurden, gelöscht. Wenn keine Uhrzeit angegeben wurde, löscht openFT alle Logging-Sätze, die bis einschließlich gestern 24:00 Uhr geschrieben wurden.

LOGGING-DATE = *TOMORROW
Löscht alle Logging-Sätze, die bis zum Zeitpunkt der Kommandoeingabe erzeugt wurden.

LOGGING-DATE = <date 8..10>
Datum im Format yyyy-mm-dd oder yy-mm-dd, z.B. 2016-12-24 bzw. 16-12-24 für den 24.12.2016. openFT löscht dann nur die Logging-Sätze, die bis zu dem mit LOGGING-TIME und LOGGING-DATE spezifizierten Zeitpunkt geschrieben wurden.

LOGGING-TIME =
Löscht Logging-Sätze, die bis zu dem angegebenen Zeitpunkt geschrieben wurden.

LOGGING-TIME = 00:00
Wenn mit LOGGING-DATE ein Datum explizit angegeben wurde, löscht openFT alle Logging-Sätze, die vor dem mit LOGGING-DATE angegebenen Datum geschrieben wurden. Wenn kein Datum angegeben wurde, löscht openFT alle bis einschließlich gestern geschriebenen Logging-Sätze.

LOGGING-TIME = <time 1..8>

Zeitpunkt für den mit LOGGING-DATE spezifizierten Tag. openFT löscht alle Logging-Sätze, die bis zu diesem Zeitpunkt geschrieben wurden. Den Zeitpunkt geben Sie im Format hh:mm:ss, z.B. 14:30:10, an.

RECORD-TYPE =
Satztyp, zu dem die Logging-Sätze gelöscht werden.

RECORD-TYPE = *ALL
Der Satztyp ist nicht Auswahlkriterium.

RECORD-TYPE = *PARAMETERS(...)
Typ des Logging-Satzes.

FT = *ALL / *NONE
Gibt an, ob FT-Logging-Sätze gelöscht werden oder nicht.

FTAC = *ALL / *NONE
Gibt an, ob FTAC-Logging-Sätze gelöscht werden oder nicht.
Hierbei ist zu beachten, dass FTAC-Logging-Sätze nur vom FTAC-Verwalter gelöscht werden können.

ADM = *ALL / *NONE
Gibt an, ob ADM-Logging-Sätze gelöscht werden oder nicht.

LOGGING-ID =
Wählt Logging-Sätze entsprechend der Logging-ID aus.

LOGGING-ID = *ALL
Die Logging-ID ist nicht Auswahlkriterium.

LOGGING-ID = <alphanum-name 1..12>
Löscht alle Logging-Sätze, deren Logging-ID kleiner oder gleich dem angegebenen Wert ist.

SELECT = *LOGGING-FILES(...)
Steuert das Löschen von Offline-Logging-Dateien. Offline-Logging-Sätze können nicht einzeln, sondern nur als ganze Dateien gelöscht werden.

BEFORE = *TIME (...)
Löscht alle Offline-Logging-Dateien, die an oder vor dem angegebenen Zeitpunkt (Ortszeit!) durch Umschalten der Logging-Datei auf offline gesetzt wurden. Damit werden nur Logging-Sätze gelöscht, die garantiert mindestens so alt sind wie der angegebene Zeitpunkt.

Wenn Sie das aktuelle Datum oder ein Datum in der Zukunft angeben, dann werden alle vorhandenen Offline-Logging-Dateien gelöscht.

DATE = <date 8..10>

Erstellungsdatum im Format yyyy-mm-dd oder yy-mm-dd, z.B. 2016-03-31 bzw. 12-03-31 für den 31.03.2016.

TIME = 00:00 / <time 1..8>
Uhrzeit für das mit DATE spezifizierte Datum. Den Zeitpunkt geben Sie im Format hh:mm:ss, z.B. 14:30:10, an.

Pro Aufruf können maximal 1024 Logging-Dateien gelöscht werden. Wenn mehr Dateien gelöscht werden sollen, wiederholen Sie den Aufruf.

Eine soeben in eine Offline-Logging-Datei umgeschaltete Logging-Datei kann nach einem Wechsel unter Umständen nicht sofort gelöscht werden, solange synchrone Aufträge die Datei noch geöffnet haben.

Kommando-Returncodes

(SC2)	SC1	Maincode	Bedeutung
0	0	CMD0001	Keine Logging-Sätze zum Auswahlkriterium gefunden.
83	32	CMD0221	Interner Fehler.
34	64	FTR1034	Kommando nur für FT- oder FTAC-Verwalter erlaubt.
35	64	FTR1035	Benutzer hat keine Berechtigung für dieses Kommando.
36	64	FTR1036	Benutzer nicht für andere Kennung berechtigt.
SC1/2 = Subcode 1/2 in Dezimal-Darstellung Zusätzliche Informationen finden Sie im Abschnitt „Kommando-Returncodes“.

Beispiel

Der FT-Verwalter will alle vorliegenden FT-Logging-Sätze aus der aktuellen Logging-Datei löschen, nicht aber FTAC- und ADM-Logging-Sätze (sofern vorhanden):

/DELETE-FT-LOGGING-RECORDS    SELECT=*PARAMETERS(LOGGING-DATE=*TOMORROW, -

/ RECORD-TYPE=*PARAMETERS(FTAC=*NONE,ADM=*NONE))