EMS Manual

EMS Programs
EMS Manual—426909-005
13-39
EMSDIST—Distributor Program
For example, you can specify the time of day as 11:05:59 or 23:05.
If the TIME option is omitted and the STOP time is smaller than the most
current event, the distributor terminates.
The STOP feature is available only as an option for the EMSDIST program,
and not as a programmatic option. It is available exclusively for the printing and
forwarding distributors, and not for the consumer distributor.
To terminate a printing or forwarding distributor in collector mode after an EOF
is encountered, specify STOP EOF instead of STOP time. This assumes that
a TIME option was also given. To terminate a printing or forwarding distributor
if either a specified time or an EOF is encountered, specify both STOP time
and STOP EOF. In this case, STOP time must be specified first.
DELAY { time }
delays by time 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. time is given in seconds/100.
A delay after end of file (EOF) detection and before reading the 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.
SBUF { ON | OFF }
selects or deselects sequential block buffering for all log files except the
current log file associated with a collector. The default is ON.
AUTOSTOP { time }
specifies how long a consumer distributor stays alive after the last opener has
closed it. time is given in seconds.
If time is omitted or set to zero, the distributor terminates when it receives a
close message from the last opener. When set to any value greater than zero,
termination is delayed by that value (maximum is 9999 seconds). If it is set to -
1, the delay is assumed to be infinite. When the distributor is opened again by
any process before the timeout occurs, the timeout is canceled.