|
$email_header [FS] |
![]() ![]()
|
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. |
| none | A 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.
Example:
$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>"
Topic url: http://www.copia.com/support/refmanual/index.html?%24email_header.htm