Message Structure

Message is composed of 3 parts:

The message address is mandatory. The message body and message attachment can be independently selected and added to the content of the message.

Message Address

The message address is a plain text file placed in the /home directory. Valid names for message address are address.number where the number is in range 1..32768 (e.g. address.13). The specified information must be placed within the first line! The format is similar to the mailto: scheme (RFC 2368). Recognized attributions are as following:

Example:

	 
mailto:Person <somebody@dot.com>?subject=test&Reply-To=Me <me@mydot.com>&from=<WebEmbed@dot.com>

Note: Size of message address file is limited to 512 bytes. Larger files are internally truncated by WCA.

Message Body

The message body is a plain text file placed in the /home directory. Valid names for message body are body.number where the number is in range 1..32768 (e.g. body.123). The message body file can also contain the placeholders of type &IOString(regname) to present the current state of any WESCL-register in the e-mail. It works in the same manner as sending a p-HTML file to the Browser through the WESCL-machine (see also: WESCL to HTML-browser communication).

Note: Size of message body file is limited only by the capacity of the File System.

Message Attachment

The message attachment is a plain text file placed in the /home directory. Valid names for message attachment are attachment.number where the number is in range 1..32768 (e.g. body.123). The message attachment file contains templates, how to format data on the circular buffer before sending it over e-mail.

There is one template for timestamp %t. This template is optional, but if exists, it must be placed at the first position. Up to 8 templates for each registers stored in the record can be placed next. Any combination of %d, %u, %x or %X can be specified (the usage of the formatting tags is the same as for printf() ANSI C library function).

Message attachment examples:

with timestamp and 3 formatted registers:

%t: %d %002d %u

with timestamp and 8 formatted registers:

%t.%d: %d,%d,%d,%d,%d,%d,%d

without timestamp (1 formatted register):

%05u

Note: Size of message attachment file is limited to 512 bytes. Larger files are internally truncated by WCA.