Measures

Each measure needs to have a unique name, which defines a section in the ini-file for that measure. The name needs to be put inside []-characters. The name doesn't matter as long as you don't use it anywhere else in the same ini-file. Do not use spaces in the names. The meters use the section names to bind to the measures. Check the supplied ini-files for examples.

General settings for all measures

Measure
This defines what is measured. The valid values are:

InvertMeasure
If set to 1,
the measured value is inverted. E.g. you can measure allocated disk space instead of free space.

IfAboveAction
A bang or command that is executed when the measure goes above the value defined in IfAboveValue. The action is executed only when the measure exceeds the value, so it needs to go below the defined value before the action is executed again.

IfAboveValue
The value for
IfAboveAction.

IfBelowAction
A bang or command that is executed when the measure goes below the value defined in IfBelowValue. The action is executed only when the measure falls below the value, so it needs to go above the defined value before the action is executed again.

IfBelowValue
The value for
IfBelowAction.

Disabled
If set to 1, the measure is disabled at start.

UpdateDivider
This value determines how often the measures are updated. This is bound to the Update value. For example if the Update is set to 1000 and the UpdateDivider is 30, the measure is updated every 30 seconds. The default value is 1.

MaxValue
The maximum value the measure can have.

MinValue
The minimum value the measure can have.

Substitute
A list of comma separated value pairs that can be used to change certain value to another. You must use quotes around the values! E.g. Substitute="cat":"dog" would change all cats to dogs in the measured value.

AverageSize
Defines the window size of average measuring. E.g. if this is set to 10 the returned value is average of last ten values.


NetIn

NetInSpeed
The maximum speed of your network connection input. The value is given in bits per second. If this value is omitted or set to zero, the maximum value is determined from the input. Watch out for peaks.

TrafficAction
Action to be executed when a certain amount of data has been downloaded.

TrafficValue
The value for the TrafficAction.

Interface
The index of the measured NIC. If this is set to 0 (default) all interfaces are added together. Value 1 means the fisrt NIC, 2 the second, etc.

Cumulative
If set to 1, the measure gathers cumulative value (i.e. adds the measured values together). This can be used to measure the total amount of transferred data during certain timeperiod.


NetOut

NetOutSpeed
The maximum speed of your network connection output. The value is given in bits per second. If this value is omitted or set to zero, the maximum value is determined from the input.

TrafficAction
Action to be executed when a certain amount of data has been uploaded.

TrafficValue
The value for the TrafficAction.

Interface
The index of the measured NIC. If this is set to 0 (default) all interfaces are added together. Value 1 means the fisrt NIC, 2 the second, etc.

Cumulative
If set to 1, the measure gathers cumulative value (i.e. adds the measured values together). This can be used to measure the total amount of transferred data during certain timeperiod.


NetTotal

NetTotalSpeed
The maximum speed of your total network connection. The value is given in bits per second. If this value is omitted or set to zero, the maximum value is determined from the input.

TrafficAction
Action to be executed when a certain amount of data has been uploaded and downloaded.

TrafficValue
The value for the TrafficAction.

Interface
The index of the measured NIC. If this is set to 0 (default) all interfaces are added together. Value 1 means the fisrt NIC, 2 the second, etc.

Cumulative
If set to 1, the measure gathers cumulative value (i.e. adds the measured values together). This can be used to measure the total amount of transferred data during certain timeperiod.


FreeDiskSpace

Drive
This is the drive which diskspace is measured. E.g. "C:\"

Total
If set to 1, this returns the total size of the disk.


Plugin

Plugin
This defines the name of the plugin that handles the actual measuring.


Registry

RegKey
The name of the registry key.

RegHKey
The name of the HKEY. Possible values are: HKEY_CURRENT_CONFIG, HKEY_CURRENT_USER, HKEY_LOCAL_MACHINE, HKEY_CLASSES_ROOT, HKEY_PERFORMANCE_DATA and HKEY_DYN_DATA.

RegValue
The name of the registry keys value. Only string and long values are supported.


Time

Format
The format how the time is written. E.g. "%H:%M:%S". You can find out all the format codes from here: http://msdn.microsoft.com/library/default.asp?url=/library/en-us/vclib/html/_crt_strftime.2c_.wcsftime.asp

TimeZone
The timezone value (e.g. +2.0). You can use also fractional values. If this is not given the localtime is used.

DaylightSavingTime
If set to 1, the daylight saving time is applied to the time (it depends on your local time). This is only used if the TimeZone has been set.


Calc

Formula
This defines the calculated formula. You can use other measures as variables. There is also a special variable called Counter, which is increased on every update. The variables are update only after all other measures are updated, so the values are one update cycle behind. Note that everything is case sensitive and the functions must be in all capital letters (e.g. SIN(10 * PI)). More info about the formulas can be found from here: http://www.sama.ru/~despair/ccalc/reference.html