[Log_File]

Use the [Log_File] section to control the various options for the log file that is created in the logs subdirectory of the working directory for a data source.

Note: Do not confuse the data source log file with the Client Configuration log file, which is located in the Logs subdirectory of the working directory. If you initiate client runs from the Client Console, the Client Configuration log file includes all service activity.

Parameter

Description

file_name_prefix

Default: "db"
Range: 1 to 20 characters
Recommended value: data source name

Use this parameter to change the prefix of the log files for this data source. We recommend using the name of the data source as the prefix as this ensures that log files created on the same date but for different data sources have unique names. The log files have names in the form dbyyyymmdd.log or when necessary, dbyyyymmdd_hhmiss.log. (This command allows you to replace the prefix "db" by any character string, provided that it results in a legal file name.)

logsw_on_newday

Default: False
Range: True or False

This parameter determines whether or not the client uses a new log file, when the date changes. You may want to set this parameter to False, if your log files are small and use the logsw_on_size parameter to manage the log files.

logsw_on_size

Default: False
Range: True or False
Recommended value: True (when running real/time)

Use this parameter to control whether or not the client should check the log file size to see if it has reached the size defined by the max_file_size parameter. If the size of the log file exceeds this parameter the log file is closed and a new one is opened. If the current date is different that the creation date of the old file, which is part of its name, the new log file will be of the form dbyyyymmdd.log otherwise the time component will be added to the file name to ensure that the name is unique.

max_file_size

Default: 0
Range: numeric value, optionally followed by K, M, or G
Recommended value: 1M

Use this parameter to limit the size of log files. The default value of 0 indicates that no limit is imposed on the size of log file. The suffixes of K, M and G allow you to specify the maximum file size in kilobytes, megabytes, or gigabytes. A value on the order of 1 MB is a reasonable value to use. The file size is always checked when you start the client regardless of the setting of the logsw_on_size parameter. When the logsw_on_size parameter is set, the log file size is also checked when the Client starts processing a new audit file.

newfile_on_newday

Default: True
Range: True or False

This parameter determines whether the Client uses a new log file and when that new file is created if the log file was created on an earlier date. You may want to set this parameter to False, if your log files are small and use the logsw_on_size parameter to manage the log files.

single_line_log_msgs

Default: False
Range: True or False

The single_line_log_msgs parameter tells the client to make all of its log file output messages single-line messages. When this parameter is set to True, the end-of-line character of all multi-line outputs are replaced by a space. This parameter exists to assist some log file analysis programs that fail to parse multi-line output messages.