EVL

Table of Contents


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

Copyright © 2017–2020 EVL Tool, s.r.o.

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

When no <email> is specified, the default (comma separated list of) recipients are taken from environment variable ‘EVL_EMAIL_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

  1. 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.

  1. 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:

EVL_MAIL_SEND is set to 0, so no e-mail was sent to \
   "$EVL_MAIL_TO" with subject "Job Failed".