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.

To change the properties for the statistics file writer component, run the mqsichangeproperties command and specify the integration node name, integration server name, the name of the statistics file writer, and the properties and values that you want to set by using the -n and -v parameters. You must set the component (by using the -o parameter) to ComIbmStatsFileWriter. For example:
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.