Specify E-Mail Address

$email_address address_part [address_part ...]

This command specifies the address to be used for an e-mail broadcast item. When this command is used, the $fax_phone and $voice_phone commands are normally omitted from the FS file.

Each e-mail FS file results in a transmission to a single recipient. However it is possible to send CopiaFacts e-mail which appears to each recipient to have been sent to other people also. The basic (manual) method of doing this is to set the variables EMAILTO_LIST or EMAILCC_LIST to with values containing one or more e-mail addresses; these variables can also be set automatically from Job Administration broadcast lists.  See the topic Sending E-Mail to Multiple Recipients for more information.

If both this command and a fax or voice phone command is given, then both methods of transmission will be attempted in turn. If $email_options "second" is given, then the e-mail will be tried only if the fax/voice outbound operation fails. Otherwise, the e-mail will be attempted first and only if it fails will the fax/voice operation be tried. This feature would allow an e-mailed WAV file to replace a voice outbound call, or an e-mailed DOC attachment to replace a faxed document converted to faxable TIFF.

The parameter on this command is used as follows:

address_part components of a single e-mail address in the format described below

The supplied address parts are combined on the e-mail 'To:' header, separated by space characters. Double-quote characters have no special significance and are passed to the e-mail header line exactly "as-is". For compatibility with earlier releases, double-quote characters may also be preceded by the macro-expansion character (default `).

If you use a display-name preceding a <mailbox@domain> address, it must be enclosed in double-quotes if it contains any of the characters ()<>[];:,." in the display-name text.  If you have e-mail destinations where this is not the case, then you can use the $email_options sanitize keyword to fix this in most cases.  However this option does not insert 'escapes' (a preceding \ character) where the syntax requires this, and mail fail to parse the display-name as a result.  So embedded " characters in a quoted string must be written as \", even if the double-quote has been expanded from a variable.
The use of angle-brackets to enclose the actual address is required if you also supply other text such as a display-name element. The $email_options sanitize keyword will fix this provided that the display-name element is valid, and will also eliminate blank spaces immediately adjacent to the @.
Double-quotes in or surrounding the actual e-mail address are accepted but deprecated. If double-quotes surround the whole actual e-mail address, no other address parts must be included (but the $email_options sanitize keyword will normally fix this).  Other than this, text enclosed inside double-quotes and inside parentheses is treated as a comment and discarded.

Unquoted words outside the actual e-mail address which contain characters not in the ASCII character set will be encoded as described in RFC2047.

The default macro-expansion character on all $email... commands is an ASCII grave accent character (`).

Default: none (required command for e-mail)

Examples:

$email_address steve@copia.com

$email_address "Steve Hersee" <steve@copia.com>

$email_address <steve@copia.com> (Steve Hersee)

$email_address "`BCF2" <`BCF1>

$email_address <"steve"@copia.com>   ; deprecated

$email_address "steve@copia.com"     ; deprecated

$email_address steve@copia.com <steve@copia.com>  ; deprecated

See also these examples for sending to CC and BCC recipients.