Specify E-Mail Body Text File

$email_body filename [origin]

This command specifies the filename of the text that is to form the body of the e-mail message.

The parameters on this command are used as follows:

filename The filename to be used as body text. The file should be a text file and will normally have a file extension of .TXT, .HTM, or .HTML.
originA keyword JOBTYPE, OWNER, or SYSTEM which is used to allow separate sets of 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_text and $email_body commands can be mixed in the same FS file and the 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 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_body 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_text 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 message body is included


$email_body "`FFJOBS\00001234\messages\JOB12345.TXT"