Logging/Tracing - Client Log

Use this page to configure the settings for the client log files. The Client programs create log files in the "logs" subdirectory of the working directory for the corresponding data source. Both client programs (DBClient and dbutility) use the main log file, which is named prefixYYYYMMDD[_HHMMSS].log. The time part is only included in the name when a log switch occurs and the new and old file names are the same.

The DBClntCfgServer program uses a different log file that has "_cfg" appended to the prefix. The makefilter utility also uses a different log file that has "_flt" appended to the prefix.

Log file parameters are included below with the following_font.

Generate single line output messages in log file

Parameter: single_line_log_msgs

This option causes the client to generate all log output as single-line messages. This option exists to assist some log file analysis programs that fail to parse multi-line output messages.

Start new log on new day

Parameter: newfile_on_newday

This option makes the Client create a new log file upon start up if the last log file was created on an earlier date.

Switch log daily

Parameter: logsw_on_newday

This option makes the Client switch to using a new log file if the date changes while it is running.

Switch log on size

Parameter: logsw_on_size

This option makes the Client switch to using a new log file if the current log file reaches the specified size limit. If new and old log files have the same creation date, a time stamp is included in the filename to ensure that it is identifiable.

Maximum file size

Parameter: max_file_size

Specifies the size limit of Client log files. Enter a number with a suffix of K, M and G to indicate the unit of measure (kilobyte, megabyte, or gigabyte). When enabled, an input field will be available to enter the desired size limit.

File name prefix (20 characters or less)

Parameter: file_name_prefix

This option specifies a string (up to 20 characters in length) that replaces the default prefix "db" for future log files. This can help you manage your log files if you have multiple data sources. The specified prefix is applied to both Client log files and DBClntCfgServer log files. It is recommended to use the data source name as the prefix for the log files, as it makes managing log files when working with multiple data sources easier.