Product Documentation

Database Administrator's Guide

Previous Topic

Next Topic

Server System Event Log Keywords

FairCom DB optionally maintains a system event log, SYSLOG. This is maintained in two system files: SYSLOGDT.FCS and SYSLOGIX.FCS. These files comprise a FairCom DB data file and index pair with a record for each recordable system event. Unlike the text based CTSTATUS.FCS, SYSLOG can be encrypted such that entries cannot be added, deleted, or modified with a simple text editor, and vendors can log application specific entries.

The System Event Log contents are controlled by SYSLOG configuration keywords in ctsrvr.cfg, the ctsrvr.set settings file, or from the command line. They are entered as pairs in the form of: SYSLOG <keyword>. As many of these pairs as desired may be used at the discretion of your application vendor.

Current SYSLOG options include:

ADMIN_API

Only allow users in the ADMIN group to use the SystemLog() function to create vendor-defined entries in the log.

CTSTATUS

Log each entry to CTSTATUS.FCS in the System Event Log, except for those entries which occur before or after the system logging monitor is in operation.

DELETE_FILE

Log file deletes and restores.

DISABLE_API

Do not allow any calls to the SystemLog() function for user defined entries.

DYNAMIC_DUMP

Log the beginning and end of dynamic dumps and a result for each file dumped.

ENCRYPT

Encrypt the SYSLOG files.

USER_INFO

Log all logons, logoffs, and changes to user logon profiles.

NONE

Used in a settings file to eliminate additional SYSLOG entries in a server configuration file.

LOGFAIL_PURGE

Causes an automatic purge of the oldest entries in the log if the system cannot add a record to SYSLOGDT.FCS. All the entries occurring on the oldest day are deleted unless there are only entries for the current day in which case no entries are purged. After a successful purge, an attempt is made to add the new entry that triggered the automatic purge. If this add succeeds, the system log operation continues in its usual fashion.

LOGFAIL_CTSTATUS

If there is no LOGFAIL_PURGE entry in the configuration file, or if the purge fails, the log entries will be rerouted to CTSTATUS.FCS if LOGFAIL_CTSTATUS is in the configuration file. This disables SYSLOG CTSTATUS; i.e, no more entries are made to the system log.

LOGFAIL_TERMINATE

If there is no automatic purge or it fails, and if there is no re-routing to CTSTATUS.FCS, either the system log will stop operation, or if LOGFAIL_TERMINATE is in the configuration file, the FairCom Server will shut down.

Note: USE LOGFAIL_TERMINATE WITH CAUTION!

SQL_STATEMENTS

Enables SQL statement logging to the SYSLOG audit logs.This information includes connection information, improved timing, and logging the statement before it is actually executed for a detailed audit trail of all SQL operations.

TOCIndex