Navigation:  Commands > Fax to Send File [FS] > $email_address [FS]

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.

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:

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 `).

The use of angle-brackets to enclose the actual address is required if you also supply other text such as a name. If there is a right angle-bracket '>' in the string, the text preceding it and the following the preceding left angle-bracket '<' is taken as the effective e-mail address when looking up the mail server for the domain. Otherwise, the tokens on either side of the '@' are used as the address.  Blank spaces immediately adjacent to the '@' are eliminated.

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 should be included.  Other than this, text enclosed inside double-quotes and inside parentheses is treated as a comment and discarded.

The supplied text is assumed to be encoded as ISO-8859-1 unless this has been overridden with $email_charset. 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 IB Küster & Partner <fax.voice@ibkp.de>

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

$email_address "steve@copia.com"     ; deprecated

 

---

Topic url: http://www.copia.com/support/refmanual/index.html?$email_address.htm