EMDIS Communication System (ECS)
================================

This is a Perl implementation of ECS, the EMDIS Communication System.
Details regarding ECS and EMDIS are available from the ZKRD web site
(http://www.zkrd.de/).


INSTALLATION

To install this package type the following:

   perl Makefile.PL
   make
   make test
(sudo)   make install
   (make clean)

After the ECS package is installed, run the ecs_setup program to help
create the ECS configuration file:

   mkdir ecs
   ecs_setup ecs/ecs.cfg

The ECS configuration file can also be edited manually, using a text
editor.

Here's an example showing how to set up and install Perl ECS.

$ mkdir ecshome
$ cd ecshome
(ecshome)$ tar xzf ~/EMDIS-ECS-0.36.tar.gz
(ecshome)$ cd EMDIS-ECS-0.36
(ECS-0.35)$ perl Makefile.PL
(ECS-0.35)$ make
(ECS-0.35)$ make test
(ECS-0.35)$ sudo make install
(ECS-0.35)$ cd ..
(ecshome)$ ecs_setup

Alternatively, because "make install" typically requires root
privileges, it may be more convenient to install Perl ECS and related
modules into a local directory, e.g. using cpanminus.

$ mkdir locallib
$ cpanm --local-lib locallib Net::SMTP~3.05
$ cpanm --local-lib locallib Mail::IMAPClient~3.18
$ cpanm --local-lib locallib Net::POP3~3.06
$ cpanm --local-lib locallib IO::Socket::SSL~2.007
$ cpanm --local-lib locallib EMDIS-ECS-0.36.tar.gz

The ecs_setup script asks a series of questions and creates an ecs.cfg
file based on the answers given.  If needed, it can also create the
required ECS_DAT_DIR subdirectories.  The directory structure and script
names are similar to those described in the EMDIS ECS specification.
Of course, Perl ECS can also run under Windows, using Strawberry Perl
or ActivePerl.

Note:  For Strawberry Perl (on MS Windows), the sequence of commands
to extract, build, and install the Perl ECS code is slightly different
from that shown above.  Here's a brief example which uses the ptar and
dmake commands provided by Strawberry Perl:

  ptar xzf EMDIS-ECS-0.36.tar.gz
  cd EMDIS-ECS-0.36
  perl Makefile.PL
  dmake
  dmake test
  dmake install


DEPENDENCIES

ECS requires the following modules and libraries.  Most of these are
included with Perl 5.8:

  CPAN::Version
  Data::Dumper
  Fcntl
  File::Basename
  File::Copy
  File::Spec
  File::Temp
  Getopt::Long
  IO::File
  IO::Handle
  IPC::Open2
  Mail::IMAPClient (optional)
  Net::POP3
  Net::SMTP
  SDBM_File
  Text::ParseWords

In addition to the above, ECS requires the use of an encryption
program such as PGP (http://www.pgp.com/, http://www.pgpi.org/) or
GnuPG (http://www.gnupg.org/) to send and receive encrypted data.

Effort was made to avoid dependency on modules not part of the
standard Perl distribution.  This software was originally developed
and tested using Perl 5.6.1 (ActivePerl build 632) on Solaris.


SEE ALSO

Further information regarding this ECS implementation is available from
the POD documentation and/or man pages (e.g. "perldoc ECS", "man ECS").
The original EMDIS Communication System specification is available
from ZKRD (http://www.zkrd.de/).


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-2016 National Marrow Donor Program. All rights reserved.

See LICENSE file for license details.

Note:  The ECS logo is used with permission.  Flag images included in this
package were copied from Wikipedia, and are in the public domain.  Other
images are based on public domain content obtained from openclipart.org.