Logging

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

LOG_FILE

The destination 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

The 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

This example shows how to 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

This example 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 destination for sending logging messages to standard output and to a log file. If the LOG_FILE parameter has been set 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.

Due to the performance overhead of log file mirroring, set this parameter to true only during development and debugging. Set it to either false or do not set 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

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

Examples:

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 value for this parameter is specified, then log archival is implicitly enabled.

Default

The default value for this parameter is UNLIMITED.

NUMBER_OF_ARCHIVE_LOGS

The number of archive logs to maintain. The names for the archive files are 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 number of archives is 5, unless this parameter is overridden by the parameter NUMBER_OF_ARCHIVE_LOGS, or unless MAX_LOG_FILE_SIZE is set to a value other than UNLIMITED.

Copyright IBM Corp. 1997, 2004