Logging

The LOGGING section of the configuration file lets you specify how you want to receive messages.

LOG_FILE

Specifies where InterChange Server writes messages.

Messages can be logged to standard output (STDOUT) or to a file whose path you specify. If you specify STDOUT, messages appear in the command prompt window in which the server starts up.

If you do not specify a value for this parameter, InterChange Server writes messages to the file InterchangeSystem.log, in the ProductDir directory.

Example:

LOG_FILE = test.log (in the ProductDir directory)

Default

LOG_FILE = STDOUT

MESSAGE_RECIPIENT

Provides one or more e-mail addresses to which InterChange Server sends Error and Fatal Error messages, in addition to writing them to the log file. If an e-mail domain is omitted, InterChange Server defaults to the default POP mail domain.

For more details on e-mail notification, refer to the System Administration Guide.

Examples:

MESSAGE_RECIPIENT = troubleshooters

The preceding example shows how you would set up e-mail notification to a distribution list called troubleshooters. If the e-mail domain is omitted, InterChange Server uses the default POP mail domain.

MESSAGE_RECIPIENT = dave,dana@myhome.com

The preceding shows how to set up e-mail notification to two user addresses, dave and dana@myhome.com, if the e-mail program uses a comma to separate multiple addresses.

Default

There is no default value for this parameter.

MIRROR_LOG_TO_STDOUT

This optional parameter allows you to send logging messages to standard output and a log file. If the LOG_FILE parameter has been specified to a valid file and is not set to STDOUT (standard output), then setting MIRROR_LOG_TO_STDOUT = TRUE mirrors the log output to the standard output as well. This parameter is ignored if LOG_FILE = STDOUT is set.

Due to the performance overhead of log file mirroring, this parameter should only be set to true during development and debugging. It is recommended to either specify false or not specify it at all (in which case it defaults to false) during production.

Default

The default value for this parameter is false (off).

MAX_LOG_FILE_SIZE

This optional parameter limits the size of the log file to the specified size. The size units can be in KB (kilobytes), MB (megabytes), or GB (gigabytes). If no unit is specified, then the unit defaults to bytes.

Examples are:

MAX_LOG_FILE_SIZE = 100 KB 
 
MAX_LOG_FILE_SIZE = 5 MB 
 
MAX_LOG_FILE_SIZE = 1 GB 
 
MAX_LOG_FILE_SIZE = 8192

If a MAX_LOG_FILE_SIZE parameter is specified, then log archival is implicitly enabled.

Unless overridden by the parameter NUMBER_OF_ARCHIVE_LOGS, the default number of archives is 5, if MAX_LOG_FILE_SIZE is set to a value other than UNLIMITED.

Default

The default value for this parameter is UNLIMITED.

NUMBER_OF_ARCHIVE_LOGS

This optional parameter specifies the number of archive logs to maintain. The names for the archive files is derived from the specified value of LOG_FILE. This parameter is ignored if the parameter MAX_LOG_FILE_SIZE is not specified or if LOG_FILE=STDOUT is set.

Example, if:

LOG_FILE = logs/InterchangeSystem.log in the ProductDir directory and NUMBER_OF_ARCHIVE_LOGS = 3

the archive logs are named as follows (in the ProductDir directory):

logs/InterchangeSystem_Arc_01.log 
logs/InterchangeSystem_Arc_02.log
logs/InterchangeSystem_Arc_03.log

Default

The default value for this parameter is 5.

Copyright IBM Corp. 1997, 2004