12.4.22.12           MAIL body_add

Description:   Adds text to the "Body" of this email message. 

Syntax:

Tcl:             MAIL {body_add=text line 2}

JScript:        MAIL("body_add=text line 2");              

VB Script:      MAIL body_add=text line 2"  

 

Argument:     "body_add=", text string, new line character (/n)
 

See Also:       MAIL, MAIL "body"

 

Examples:      MAIL {body_add=\nWebAccess TCL Script example. \n}

MAIL {body_add=\nStart New Line. Then add text. }

MAIL {body_add=Add Text. Then start new line\n}

MAIL {body_add=\tSecond Line starts with a Tab. Start two new lines\n\n}

MAIL {body_add=Add a Slash to start\\stop.\n}

MAIL {body_add=\n}

MAIL {body_add=Add curly brackets for \{info\}\n\n}

MAIL {body_add=@MESSAGE1}

MAIL {body_add=\nThis is the current value of Tag ZT-184:}

MAIL {body_add=@ZT-184 }

MAIL {body_add=@ZT-184.ENUNIT}

MAIL {body_add=@ZT-184.ENUNIT}

MAIL "body_add= at [GETVAL %TTMTIME] on [GETVAL %TTMDATE]."

MAIL {body_add= \n\n}

MAIL {body_add=Regards,\n\n}

MAIL {body_add=\tTom Carter}

 

 

Follows a MAIL "body=" command to add additional text to the original BODY of the message.  The text value should be one line of text. It is optionally separated by newline (\n) characters from any following lines added  with MAIL "body_add=".  The user must perform all line wrapping. The text will be sent verbatim, line-by-line, except if longer than 998 characters. Lines longer than 998 characters will be split, not necessarily at word boundaries, to comply with RFC 821, so it's a really good idea to do line wrapping using the new line characters /n, before passing your text.

Must be specified before each MAIL "send" command. MAIL "send" clears the buffer of any previous MAIL "body=" and MAIL "body_add" entries.

It is recommended to use the curly brackets {} if possible avoid interpreter from misunderstanding punctuation. If the contents must be evaluated by Tcl, like $variable or [GETVAL tagname], then quote marks "" should be used as the delimiter.

Special formatting characters are:

\n - starts a new line
\t - tabs the line
\\ - includes a single back slash \ in the message
\{ - includes a single curly bracket { in the message
\} - includes a single curly bracket } in the message

This MAIL  package provides only the html and text transport mechanism -- no provisions have been made for attachments or other fancier email features.  Text is the default. SMTP is supported.  MIME and attachments are not supported. MAIL attempts to be as RFC-compliant as possible.