Specify E-Mail Custom Header

$email_header headername headervalue|[none]

This command specifies a custom header line to be used for this e-mail item. You may use multiple commands in the same FS file.

Typical uses for this command would be to supply a "reply-to" address for the e-mail item, or to supply some references which will help you identify returned items from their headers. You can also override the X-Mailer: header which CopiaFacts automatically adds. See the examples below.

The parameters on this command are used as follows:

headername The name of the custom header. If you are adding a header other than one of those listed in RFC822, the name should start with 'X-'. If you do not include a colon at the end, one will be added. The 'us-ascii' character set should be used.
headervalue The text which you wish to add in the header. Words in the text which contain characters not in the ASCII character set will be encoded as described in RFC2047.
noneA keyword which will cause the X-Mailer header to be suppressed.  For any other header name, the literal 'none' would be used in the header.

Note that double-quotes must be used if the headervalue contains embedded blanks. This command is not treated specially and any double-quotes required in the quoted text must be written as two double-quotes. For compatibility with earlier releases, an embedded double quote may also be written as `".

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

Default: no special headers are added other than an X-Mailer: header.


$email_header X-Complaints-To: nobody@sender.com

$email_header X-Errors-To: `FSNUM@sender.com

$email_header X-JobID: `JOB_INSTANCE

$email_header Comment: "This is a comment"

$email_header Reply-To: """Steve Hersee"" <steve@copia.com>"