map# message
[-interval sec] [-health value]
The map# message command
creates a message which contains the given text. The message is kept in
memory until it expires.
Messages might be appended
to files if the message tag matches one of the patterns contained in the
value of the -store map option and if the value -f the -path map option
is not empty.
Messages are used to report
statistics or events. Every message is automatically augmented with a time-stamp.
However, many statistics or events are bound to a time interval.
The -interval option allows
specifying such a time interval in seconds. The interval value is set to
0 if this option is missing.
Messages can also be used
to influence the health of the map. The value of the -health option must
be in the range of -100..100 and indicates a negative or positive health
change.
The exact computation of
the health of the map uses these indications to derive a new health value
whenever the map ticks.
The health value is be set
to 0 if this option is missing.
|