EVL – ETL Tool

Products, services and company names referenced in this document may be either trademarks or registered trademarks of their respective owners.

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts.

Mail

(since EVL 2.1)

When no <email> is specified, the default (comma separated list of) recipients are taken from environment variable ‘EVL_MAIL_TO’.

When environment variable ‘EVL_MAIL_SEND’ is set to 0, then no e-mails are sent by this command. Useful to be set for non-production environments.

‘Mail’ command will call command from environment variable ‘EVL_MAIL’ which suppose to be standard Unix command mail with possible other parameters.

Mail: is to be used either in EVL Job or in EVL Workflow structure definition file, i.e. in ‘evs’ or ‘ews’ file.
evl mail: is intended for standalone usage, i.e. to be invoked from command line.

EVS is EVL job definition file and EWS is EVL Workflow definition file, for details see man evl-evs(5) or ewf-ews(5).

Synopsis

Mail
  <subject> <message> [ <email>[,...] ]
  [-a <attachment>]... [-c <cc_email>[,...]] [-b <bcc_email>[,...]]

evl mail
  <subject> <message> [ <email>[,...] ]
  [-a <attachment>]... [-c <cc_email>[,...]] [-b <bcc_email>[,...]]

evl mail
  ( --help | --usage | --version )

Options

-a <attachment>: attach the given file to the message, can be used several times to add more files
-b <bcc_email>[,...]: send blind carbon copies
-c <cc_email>[,...]: send carbon copies

Standard options:

--help: print this help and exit
--usage: print short usage information and exit
--version: print version and exit

Examples

Following setting will e-mail carbon copy of every e-mail to ‘admin@server’:

export EVL_MAIL='mail -c "admin@server"'

Following invocation of "Mail":

Mail "Job Failed" "Job extract_file_billing failed."

will actually run:

echo "Job extract_file_billing failed." | \
    mail -c "admin@server" -s "Job Failed" "$EVL_MAIL_TO"

and log appropriate information into EVL or EWF log.

For non-production environment it worth to set:

export EVL_MAIL_SEND=0

so then in example 1. you will obtain only such a warning in a log file: