Parameter values for the statistics file writer component
The statistics file writer component controls how accounting and statistics records are written when the output format has been set to csv by the mqsichangeflowstats command.
mqsichangeproperties integrationNodeName -e integrationServerName -o ComIbmStatsFileWriter -n property_name -v property_value
Use these properties to control the collection of accounting and statistics data, as described in Starting collection of message flow statistics and accounting data.
You can change the following properties and values for the statistics file writer component:
- -n filePath -v value
- This property specifies the directory where the accounting and
statistics records will be written. The filename of the records is
calculated automatically using the format
integrationNodeName_integrationServerName_thread|node|flowStats.csv
.On UNIX systems, the files are written to the /var/mqsi/common/stats directory by default. On other platforms there is no default location, and the filePath property must be specified. The specified directory must exist when the statistics are enabled by using the mqsichangeflowstats command, and the integration node's user ID must have permission to write to this directory.
- -n averages -v value
- This property controls whether the mean average values for each statistic are included in the written output. This value must be set to either true or false. The default value is true.
- -n numberOfFiles -v value
- This property controls the number of files that are used for each
type of statistics report (thread, node, or flow data) and for each
integration server. The value set for this property must be a positive
integer, and the default value is 4.
When a file is full, the file writer moves on to the next file, up to the specified maximum. When the last file has been filled, it starts overwriting data in the first file. This cycle of writing continues, ensuring that the newest data is retained.
- -n sizeOfFile -v value
- This property controls the size, in megabytes, that each file
is allowed to reach before it is rolled over onto another file. This
property must be set to a positive integer, and the default value
is 25.
For example, if the statistics file writer is configured with the numberOfFiles set to 3, the sizeOfFile set to 10, and both node and flow data is configured, the total size required by accounting and statistics files would be
3 * 10 * 2 = 60Mb
for each integration server. If this space is not available, an error is logged.