MACROMEDIA COLDFUSION MX 61-CFML Reference page 243

Attribute Req/Opt Default
port Optional
mailerID Optional
timeout Optional
spoolEnable Optional
Usage
Sends a mail message to the specified address. Mail messages can include attachements. The tag
body can include CFML code to generate mail output. The
can only be used in the cfmail tag body.
Mail messages can be single or multipart. If you send a multi-part mail message, all message
content must be in
in tags.
cfmailpart
Note: The cfmail tag does not make copies of attachments when spooling mail to disk. If you use
the cfmail tag to send a message with an attachment with spooling enabled and you use the cffile
tag to delete the attachment file, ColdFusion might not send the mail because the mailing process
might execute after the file was is deleted. (When this happens, the mail log includes a FileNotFound
exception and the e-mail is not sent.) You can prevent this problem by setting SpoolEnable="No" in
the attribute or disabling spooling in the ColdFusion MX Administrator. Disabling spooling causes the
e-mail to be delivered immediately.
Mail addressing
Mail addresses can have any of the following forms:
Format
user@server
<user@server>
DisplayName <user@server>
"DisplayName" <user@server>
user@server (DisplayName)
Description
TCP/IP port on which SMTP server listens for requests
(normally 25). A value here overrides the Administrator.
ColdFusion Mailer ID to be passed in X-Mailer SMTP header, which
MX identifies the mailer application.
Application
Server
Number of seconds to wait before timing out connection to
SMTP server. A value here overrides the Administrator.
Specifies whether to spool mail or always send it
Immediately. Overrides the ColdFusion MX Administrator
Spool mail messages to disk for delivery setting.
• Yes: Saves a copy of the message until the sending
• No: Queues the message for sending, without storing a
tags; ColdFusion ignores multipart message text text that is not
cfmailpart
operation is complete. Pages that use this option might
run slower than those that use the
copy until the operation is complete. If a delivery error
occurs when this option is
Application exception and logs the error to the mail.log
file.
cfmailparam and cfmailpart
Example
rsmith@company.com
<rsmith@company.com>
Rob Smith <rsmith@company.com>
"Rob Smith" <rsmith@company.com>
rsmith@company.com (Rob Smith)
option.
No
, ColdFusion generates an
No
cfmail
tags
243