Statistics Configuration

Dynamic statistics configuration is activated using the -statscfg startup option.

Configuration Reference

[stats] Section

enabled

The value may be "0" to disable statistics collection or "1" to enable it. The default is "0".

file

The name of the statistics file. If not fully qualified then the value of the _DEFAULTS define is used to complete the file name.

time

Specifies the time format for the statistics file entries. Available formats are:

GMT	Greenwich mean time (the default)
LST	Local standard time (local time without DST adjustment)
LCT	Local civil time (local time with DST adjustment)

flush-interval

Specifies how often statistics are written to the statistics file, specified in seconds, or as a CRON expression. The default value is 15 seconds. Valid values are 15 - 86400.

reset-interval

Specifies how often the process statistics counters are reset, specified in minutes, or as a CRON expression. The default value is 0, which indicates that the statistics are not automatically reset and continue to accumulate for the life of the process. Valid values are 0 - 10080.

on-reset

The action to take on the statistics file when a reset occurs. The available options are:

rollover	The current file is renamed according to the 'rollover-file' specification and a new file is opened.
purgedata	The current file data is purged with a call to CONTROL 20 and the current file remains open.
keep	No action is taken. Statistics continue to be written to the current file (the default).

Additionally, the Common Configuration Options may be included to specify file allocation and rollover options.

Example

TEXT

; Enable statistics collection.
[stats]
enabled=1
file=$data1.stats.zzstats
maxentents=200
time=lct

Defining Intervals Using CRON Expressions

CRON is a job scheduling service available on a number of platforms. Interval values may be specified as CRON expressions which provide finer grain control on interval expiration. Documenation and tools for creating and interpreting CRON expressions may be found here:

CRON Expressions at Wikipedia

CRON Expression Generator and Explainer at FREEFORMATTER.COM

Example

TEXT

; Enable statistics collection.
[stats]
enabled=1
file=$data1.stats.zzstats
maxentents=200
time=lct
;Flush every 2 minutes
flush-interval=0 */2 * ? * *
; Reset every 4 hours
reset-interval=0 0 */4 ? * *