Specify E-Mail Alternate Body Text File
This command specifies the filename of the text that is to form an alternate body for the e-mail message. The e-mail is built as a MIME message with Content-Type multipart/alternative.
The parameter on this command is used as follows:
|filename||The filename to be used as alternate body text. The file should be a text file and will normally have a file extension of .TXT, .HTM, or .HTML.|
|origin||A keyword JOBTYPE, OWNER, or SYSTEM which is used to allow separate sets of alternate body and/or text commands in Job Type, Owner and System job properties to override each other correctly. This keyword is added automatically in job instance creation and should NOT be applied manually.|
The default macro-expansion character on all $email... commands is an ASCII grave accent character (`). The file is processed in the same way as a CopiaFacts cover sheet with macro-expansion of ` variables. Files may be included using the syntax `!filename as a line of the text. The expansion of variables may be suppressed by $email_options "nomacro".
The file is assumed to be in the system default encoding unless it either has a Unicode BOM or the CP_EMAILBODY variable is defined. The file is scanned for characters not in the ASCII character set, and if any are found the file will be encoded either as 'quoted-printable' or (if specified on $email_charset) as base64. Otherwise the file will be sent as 'us-ascii' with 7bit encoding. This processing may be modified by the options specified on an $email_options command.
The $email_alttext and $email_altbody commands can be mixed in the same FS file and the alternate body text will be built from lines and files in the order they are specified.
When the email derives from the job administration system, if any alternate text and body commands originate from the Job Type properties, those originating in Owner and System properties will be ignored, and if any originate from Owner properties, those originating from System properties will be ignored.
If only a single $email_altbody command is given, the content type (text/plain or text/html) will be inferred from the file extension, the latter being used if the extension is .HTM or .HTML. If multiple commands are given, or if any $email_alttext commands are also used, the content type will be set to text/plain unless a string <html is detected in the first three lines of the combined text, in which case it will be set to text/html.
CopiaFacts always places the body before the altbody in the message. To conform with RFC2046 section 5.1.4 it is strongly recommended that when both plain and html text are present, the $email_text/$email_body commands are used for the text/plain part and the $email_alttext/$email_alt_body commands are used for the text/html part.
Default: no alternate message body is included