The log records are stored in the file syslog.Lyymmdd.Lhhmmss. This file is located in the log directory of the relevant openFT instance. yymmdd is the date (year, month, day) and hhmmss the time (hour, minute, second for GMT) at which the file was created.
Displaying log records
You can use the ftshwl command to view all log records in the system. Using the polling options -po and -pnr provided by ftshwl, you can also repeat the output of new log records at regular intervals.
The output of a log record contains an RC column which indicates either 0000 (positive acknowledgment ) or the cause of rejection or abort of the request by means of a 4-digit reason code. You can use the fthelp command to determine the meaning of the reason codes.
You can also view log records in the openFT Explorer. To do this, click on Logging under Administration in the navigation area.
Switching log file and administering offline logging
You can change the log file with the ftmodo -lf=c command
This closes the current log file which is nevertheless retained as an offline log file. For the following log records, a new log file is created with the current date in the suffix. You can change the log file as often as you wish and therefore manage multiple offline log files.
You can display the names of all log files via ftshwl -llf (current log file and offline log files).
In the openFT Explorer, you can also see all the offline log files and associated log records (Administration subtree - Logging - Offline Logging).
Modifying log settings
You can modify the following log settings:
The scope of logging (FT, FTAC and administration function as well as the logging for directory transfer). To do this, use the ftmodo command (options -lt, -lc, -la and -ltd (directory transfer)).
Following installation, full logging is set.
The intervals for the automatic deletion of log records. To do this, use the ftmodo command (options -ld, -lda, -ldd and -ldt) or the Logging tab in the openFT Explorer under Administration - Operating Parameters.
This setting deletes log records as of a defined minimum age at regular intervals and at a specified time. This automatic delete function is only active if openFT is started. If openFT is not started at a scheduled delete time then the delete operation is not performed on the next start-up.
Following installation, the automatic deletion of log records is disabled. You should only enable this function if you do not require the uninterrupted recording of log records.
In the openFT Explorer use or the Logging tab under Administration - Operating Parameters.
Saving of log records in files and deleting log records
All log records may be deleted by the openFT administrator, the FTAC administrator and the ADM administrator. To do this, use the ftdell command or the openFT Explorer (Logging object window, context menu command Delete Log Records). Deleting log records causes the size of the log file to change since the storage space is immediately free upon deletion.
Saving log records
Redirect the output of ftshwl to a file as follows:
If you want to back up current log records, call ftshwl without specifying -lf, -tlf or -plf. When you do this, select the log records that you want to back up. Then remove these log records from the current log file by calling ftdell with the appropriate selection criteria.
If you want to back up offline log records, call ftshwl -nb=@a and specify -lf, -tlf or -plf. These options allow you to specify the offline log files. Next, delete the log file or files by calling ftdell with the option -tlf.