trace.ini

The trace.ini file is found in the <node>/conf directory.

# kpsa Trace File Writer Configuration File
#
# $Revision: 1.1.2.13 $ $Date: 2011-04-21 12:47:55 $
# this cfg_name is used in provhead - so do not change cfg_name
# feel free to change the remaining non key config parameters
#
[ traceFileWriter : logservice::FileWriterConfig ]
cfg_name=orderTracing
cfg_fileCount=0
cfg_maxFileSize=10000
cfg_maxFileCount=0
cfg_maxFileTime=0
cfg_flushFrequency=100
cfg_outputDir=./

The following table describes the parameters that can be used in the trace.ini file.

parameter Description
cfg_fileCount A number optionally used in filename, and automatically incremented with each use. See FileWriterImpl::newFileName for a description on how the filename is constructed. The default value on creation is zero.
cfg_flushFrequency Number of write calls made before the buffered data is written to the file system. It controls buffering of messages. A higher flushFrequency may improve overall performance. Default value on creation is 100 if no config file exists. If a zero is entered in the file, then the default value in the code is used.
cfg_maxFileCount Maximum number of files that the filewriter will leave on the file system. If the count of files created, exceeds this count, the oldest file created by this FileWriter is deleted from the file system. A value of zero indicates no maximum will be enforced. The default value on creation is zero.
cfg_maxFileSize Maximum file size in kilobytes. When appending a record if the file size exceeds maximum file size, the file is closed. The next write opens a new file. A value of zero indicates no maximum will be enforced. The default value on creation is zero.
cfg_maxFileTime Maximum file time in seconds. When a file is opened, a recurring timer with frequency of the value contained in GFileTimerFrequency starts. When the accumulated time exceeds cfg_maxFileTime, the file is closed. The next write opens a new file. A value of zero indicates no maximum will be enforced. The default value on creation is zero.
cfg_name Name of this FileWriter instance to which the configuration object refers. This is the primary key.
cfg_outputDir Output directory for the FileWriter instance. The outputDir is prefixed to the name to fully specify the file. A directory separator is inserted, if needed. See FileWriterImpl::newFileName for a description of how the filename is constructed. Default value is "./".