ftdell

Note on usage

Function: Delete log record or offline log file

User group: FT, FTAC or ADM administrator.

Functional description

With ftdell, you can delete log records for all login names if you are FT, FTAC or ADM administrator. This function is not permitted for FT users.
You can also delete offline log files that you no longer need. You can delete up to 1024 log files with each ftdell command. If you want to delete more files then you must repeat the command.

Store the log records by redirecting the output of ftshwl to a file or to the printer.

Deleting log records changes the size of the file since the storage space is freed immediately after deletion.

The time by which the log records are to be deleted can be entered either as a fixed time with date and time or as a relative time; for example: all records before 10 days ago.

You can also automate the deletion of log records by using the ftmodo command to set the corresponding options (-ld, -lda, -ldd, -ldt) in the operating parameters. This is recommended if you only want to retain logging information of up to a given age. However, you should not use this method if you want to maintain a continuous longterm archive of the log records

Format

ftdell

-h | [ -rg=[[[yyyy]mm]dd]hhmm | -rg=#1..999999999999 | -rg=0..999 ] | [ -tlf=yyyymmdd[hh[mm[ss]]] ]

Description

-h

Displays the command syntax on the screen. Entries after the -h are ignored.

-rg=[[[yyyy]mm]dd]hhmm

You use -rg to specify the end of a logging interval.

When selecting the time, this is interpreted as follows:

• a 4-digit specification is interpreted as the time expressed in hours and minutes,

• a 6-digit specification as the day (date) and time in hours and minutes,

• an 8-digit specification as the month, day, and time in hours and minutes,

• a 12-digit specification as the year, month, day, and time in hours and minutes.

The largest possible value that can be specified as the date is 20380119 (January 19, 2038). openFT then deletes all log records which are older that the specified time. The optional data ([...]) is automatically replaced by current values.

-rg=#1..999999999999

Here you use -rg to specify the end log ID. It is identified by a leading # character, followed by the 1-12-digit ID. openFT then deletes all log records which belong to this log ID or which belong to a smaller log ID.

-rg=0..999

Here you use -rg to specify a time interval (relative to the current date and time) as a multiple of 24 hours, i.e. number of days. openFT then deletes all log records which are older than the specified time. This means you are looking back in time. If you specify -rg=2, for example, all log records which are older than two days (48 hours) are deleted.

-rg not specified

The range is not a selection criterion, i.e. all log records are to be deleted by 00:00 hours of the current date.

-tlf=yyyymmdd[hh[mm[ss]]]

-tlf deletes all the offline log files that were switched offline on or before the specified time (local time!). This ensures that only log files that are at least as old as the specified time are deleted.

You must always specify the date as an 8-digit value indicating the year month and day. The year must be greater than or equal to 2000. You can specify the time (hhmmss) partially or not at all if you wish. "00" is added to replace any missing specifications.

If you enter the current date or a date in the future then all the existing offline logging records are deleted.

The options -rg and -tlf must not be specified simultaneously!

Examples

1. As the FT or FTAC administrator, you wish to delete all FT log records written up to 00:00 hours of the current date.

   ftdell

2. As the FT or FTAC administrator, you wish to delete all FT log records written up to the current time:

   ftdell -rg=0

3. As the FT or FTAC administrator, you wish to delete all log records written before the last 7-day period (7 times 24 hours before the current time):

   ftdell -rg=7

4. As the FT or FTAC administrator, you wish to delete all log records from the beginning to the record with the log ID 1450:

   ftdell -rg=#1450

5. As the FT or FTAC administrator, you want to delete all the offline log files that were set offline before 01.04.2016:

   ftdell -tlf=20160331235959