Logging messages from the filter server

About this task

You can specify that the filter server log messages to a file by following these steps:

Procedure

  1. Log in as the user informix.
  2. Set the environment variable ETX_FILTER_FILE to the full path name of the filter log file.
    The informix user must be able to write to this file.
    For example, the following UNIX™ C shell command sets the ETX_FILTER_FILE environment variable to the file /tmp/filterserver.log: 
    setenv ETX_FILTER_FILE "/tmp/filterserver.log"
  3. Restart the database server with the oninit utility.

Results

The filter server writes to the filter log file when the database server instructs the filter server to start, shut down, or report connection problems with the database server. If more than one filter server is running at one time, all filter servers write to the same filter log file. A filter server writes a timestamp, the process ID, and a message to a log file, which appears similar to the following example: 
Mon Mar  8 16:33:57 11613: _________________________________
Mon Mar  8 16:33:57 11613: FilterServer process starting up.
Mon Mar  8 16:33:57 11613: Successfully connected to Informix server.
Mon Mar  8 16:33:57 11613: Connected to port 34459  Send/recv on socket 4
Mon Mar  8 17:10:55 24086: _________________________________
Mon Mar  8 17:10:55 24086: FilterServer process starting up.
Mon Mar  8 17:10:55 24086: Successfully connected to Informix server.
Mon Mar  8 17:10:55 24086: Connected to port 35840  Send/recv on socket 4
Tue Mar  9 14:26:11 11613: GOODBYE. Lost connection to Informix server...
Tue Mar  9 14:26:11 24086: GOODBYE. Lost connection to Informix Server...

The final two messages occur when you shut down the database server with the onmode -k utility.