Mail

ITP/Server will send an e-mail message with optional attached documents to any valid recipient.

The SMTP host must support the minimum requirements as described in RFCs 821 and 822.

ITP/Server will use MIME enhancements if the e-mail contains 8-bit characters.

Attachments are sent using MIME enhancements.

MIME-types for attachments are read from the Registry. If the mime type cannot be read from the Registry, the file will be sent binary with application/octet-stream as mime type.

In general any Internet e-mail gateway can be used as an SMTP host.

Refer to Sending e-mail of this manual for guidelines on constructing a valid e-mail message.

Syntax
Mail
File(<text>)
Host(<text>) 
From(<text>) 
To(<text>) 
Attachments(<text>) 
Preformatted(<True or False>) 
Port(<text>); 

Parameters

File: Required.
The header and MIME body of the e-mail message.

The header in this file is the human readable header of the mail. Advisable is to include Subject:, To: and Reply-to: in this header. Refer also to Sending e-mail of this manual for more information.

The body of this file is also sent, but will be shown if the recipient has an e-mail client that does not support MIME-enhancements or when no Attachments parameter is passed. It is customary that this file should contain a message informing the recipient that he/she will need MIME support to access the attachments.

Host: Required.
The SMTP host that ITP/Server will use to send the e-mail.

From: Required.
The User Name that will be used to transmit the e-mail. This user name must be specified in user@hostname.domain format. ITP/Server needs this user name to authenticate the sender to the SMTP host.

To: Required.
A string containing a comma (,) separated list of recipients of the e-mail. Every recipient must be specified in user@hostname.domain format.

Attachments: Optional.
A string containing a comma (,) separated list of documents that ITP/Server will attach to the e-mail message as MIME attachments. The first two of these attachments are the alternative bodies of the e-mail using the following rules:

 

File extension first file

File extension second file

Body alternative sent: TXT/HTML*

TXT

HTML

Body alternative sent: TXT/HTML*

HTML

TXT

Body alternative sent: TXT

TXT

Not Html

* Which of the provided alternative bodies is shown depends on the setting of the mail client.

Refer to section Sending e-mail with attachments or MIME enhanced e-mailchapter in this manual for more information.

Inline image in HMTL Body
Inline images are supported (Content_ID header support). For a discussion, refer to chapter HTML inline images (Content-ID MIME header support).

Preformatted: Optional.
If this parameter is set to "Y", the document provided with the File (<text>) parameter is considered to contain a complete, formatted, e-mail, including all headers and attachments. The value of the parameter Attachments (<text>) is ignored in this case.

Port: Optional.
The number or symbolic name of the port that ITP/Server will connect to on the host. If this parameter is not specified ITP/Server will use the standard SMTP port (port 25).

Note

The command SimpleMail offers a simpler interface for producing elementary e-mail. Refer to SimpleMail for more information.