NAME

ecs_chk_com - ECS communication status monitoring daemon

SYNOPSIS

ecs_chk_com

ecs_chk_com --config /opt/ecs/ecs.cfg

ech_chk_com --nodaemon

ecs_chk_com --once

DESCRIPTION

This program monitors ECS communication status with remote nodes. It periodically checks the following for each node:

  • If T_CHK * 0.9 has elapsed since the last message was sent to the remote node, send an READY meta-message to that node.

  • If T_CHK * 2.2 has elapsed since the last message was received from the remote node and notification has not been sent within the past T_ADM_REMIND seconds, send email notification to local administrator.

  • If the last message received from the remote node has not yet been acknowledged, send a MSG_ACK meta-message to that node.

OPTIONS

--config ecs_config_file

Specify the location of the ECS configuration file. By default, the program looks for the file specified by the ECS_CONFIG_FILE environment variable; if that environment variable is not set, it looks for a file named "ecs.cfg" in the current directory.

--daemon

Spawn background process to continuously monitor remote node communication status. This option is enabled by default.

--nodaemon

Do not spawn a background process. Instead, use the foreground process process to continuously monitor remote node communication status.

--once

Perform one processing iteration and then exit. Implies --nodaemon.

--help

Show embedded POD documentation

RETURN VALUE

Returns a non-zero exit code if a configuration error is detected.

BUGS

Possibly.

NOTES

To safely terminate this program, please use "kill -15" (not "kill -9").

SEE ALSO

EMDIS::ECS, ecs_scan_mail, ecs_setup, ecstool

AUTHOR

Joel Schneider <jschneid@nmdp.org>

COPYRIGHT AND LICENSE

THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.

Copyright (C) 2002-2020 National Marrow Donor Program. All rights reserved.

See LICENSE file for license details.

HISTORY

ECS, the EMDIS Communication System, was originally designed and implemented by the ZKRD (http://www.zkrd.de/). This Perl implementation of ECS was developed by the National Marrow Donor Program (http://www.marrow.org/).

2004-03-12 Canadian Blood Services - Tony Wai Added MS Windows support for Windows 2000 and Windows XP Added "DIRECTORY" inBox Protocol. This can interface with any mail system that can output the new messages to text files.

2007-08-01 ZKRD - emdisadm@zkrd.de Added environment variable ECS_CONFIG_FILE -> ecs.cfg Added new report management. Besides the LOG_LEVEL there is now a MAIL_LEVEL. If there is a difference between these levels, not every log message will be reported as email to admin. Furthermore only the filename and path of non ECS messages will be documented (not the whole message).