EMS Manual

EMS Programs
EMS Manual—426909-005
13-31
EMSDINFO—Distributor Information Utility
STATE
One of these collector states: DISCONNECTED, WRITE
PENDING, IDLE, or RETRYING ON ERROR.
LOGFILE
If present, name of the log file that is currently the sole source of
event messages examined by this distributor.
EOFDELAY
Amount of time delay (in seconds/100) after detection of end of
file (EOF) before reading the log again. If an EOF is received
again, the message is sent to the collector to ask for the next
event.
Having a delay after end of file (EOF) detection and before
readingthe log again improves distributor efficiency. This delay
reduces interprocess communication with the collector, and
results in lower CPU usage. This delay significantly decreases log
file access when combined with sequential block buffering at
medium to high event rates (5 or more events per second). At
lower event rates, the delay improves efficiency when used
without sequential buffering. The delay should be at least equal
to, and preferably larger than, the average event interval. The
default is 500 ms.
To select the delay feature, include the parameter DELAY sec/100
in the distributor command line, or use the SPI CONTROL
command with the token ZEMS^TKN^SET^EOFDELAY. You can
choose a delay value from zero (0) through 9999; selecting a
delay of zero turns the delay function off. If a delay is not
specified in the command line, the distributor selects 500 ms.
SEQUENTIAL
BLOCKING
Indicates if sequential block buffering has been selected (ON) or
deselected (OFF) for all log files except the current log file
associated with a collector.
CURRENT POSITION
Log time (in local civil time) of the event message last examined
by the distributor.
LAST POSITION
SET
Log time (in local civil time) set by the last positioning command
or by the TIME option on distributor startup. This line specifies the
first event message with a log time stamp at or after the given
time. The line occurs only if such a log time was given. (You must
use the distributor control command to give positioning
commands after distributor startup; see
Section 15, EMS
Procedures.)
SOURCE
COLLECTORS
Precedes the description of zero or more source collectors. These
are the collectors whose log files serve as the source of event
messages for the distributor to examine. The same sequence of
terms occurs once for each source collector:
NAME
The process name of a source collector.
Term Description (page 2 of 3)