[Contents] [Previous] [Next] [Index]

SendMail

Sends an email message.

Server-side object

Implemented in

Netscape Server 3.0

The To and From attributes are required. All other properties are optional.

Created by

The SendMail constructor:

new SendMail(); 

Parameters

None.

Description

Whatever properties you specify for the SendMail object are sent in the header of the mail message.

The SendMail object allows you to send either simple text-only mail messages or complex MIME-compliant mail or add attachments to your message. To send a MIME message, set the Content-Type property to the MIME type of the message.

You can use the prototype property of the SendMail object to add a property to all SendMail instances. If you do so, that addition applies to all SendMail objects running in all applications on your server, not just in the single application that made the change. This allows you to expand the capabilities of this object for your entire server.

Property Summary

Bcc
Comma-delimited list of recipients of the message whose names should not be visible in the message.

Body
Text of the message.

Cc
Comma-delimited list of additional recipients of the message.

Errorsto
Address to which to send errors concerning the message. Defaults to the sender's address.

From
User name of the person sending the message.

Organization
Organization information.

prototype
Allows the addition of properties to a SendMail object.

Replyto
User name to which replies to the message should be sent. Defaults to the sender's address.

Smtpserver
Mail (SMTP) server name. Defaults to the value specified through the setting in the Administration server.

Subject
Subject of the message.

To
Comma-delimited list of primary recipients of the message.

Method Summary

errorCode
Returns an integer error code associated with sending this message.

errorMessage
Returns a string associated with sending this message.

send
Sends the mail message represented by this object.

Examples

Example 1: The following script sends mail to vpg and gwp, copying jaym, with the specified subject and body for the message:

<server>
SMName = new SendMail();
SMName.To = "vpg@co1.com, gwp@co2.com"
SMName.From = "me@myco.com"
SMName.Cc = "jaym@hisco.com"
SMName.Subject = "The State of the Universe"
SMName.Body = "The universe, contrary to what you may have heard, is in none too shabby shape. Not to worry! --me"
SMName.send()
</server>
Example 2: The following example sends an image in a GIF file:

sm = new SendMail(); 
sm.To = "satish";
sm.From = "satish@netscape.com";
sm.Smtpserver = "fen.mcom.com";
sm["Errors-to"] = "satish";
sm["Content-type"] = "image/gif";
sm["Content-Transfer-Encoding"] = "base64";
file = new File("/u/satish/LiveWire/mail/banner.gif");
openFlag = file.open("r");
if ( openFlag ) {
   len = file.getLength();
   str = file.read(len);
   sm.Body = str;
}
sm.send();
Example 3: The following example sends a multipart message:

sm = new SendMail(); 
sm.To = "chandra@cs.uiowa.edu, satish@netscape.com";
sm.From = "satish@netscape.com";
sm.Smtpserver = "fen.mcom.com";
sm.Organization = "Netscape Comm Corp";
sm["Content-type"] = "multipart/mixed; boundary=\"------------8B3F7BA67B67C1DDE6C25D04\"";
file = new File("/u/satish/LiveWire/mail/mime");
openFlag = file.open("r");
if ( openFlag ) {
   len = file.getLength();
   str = file.read(len);
   sm.Body = str;
}
sm.send();
The file mime has HTML text and an Microsoft Word document separated by the specified boundary. The resulting message appears as HTML text followed by the Microsoft Word attachment.

Properties

Bcc

Comma-delimited list of recipients of the message whose names should not be visible in the message.

Property of

SendMail

Implemented in

Netscape Server 3.0

Body

Text of the message.

Property of

SendMail

Implemented in

Netscape Server 3.0

Cc

Comma-delimited list of additional recipients of the message.

Property of

SendMail

Implemented in

Netscape Server 3.0

Errorsto

Address to which to send errors concerning the message. Defaults to the sender's address.

Property of

SendMail

Implemented in

Netscape Server 3.0

From

User name of the person sending the message.

Property of

SendMail

Implemented in

Netscape Server 3.0

Organization

Organization information.

Property of

SendMail

Implemented in

Netscape Server 3.0

prototype

Represents the prototype for this class. You can use the prototype to add properties or methods to all instances of a class. For information on prototypes, see Function.prototype.

Property of

SendMail

Implemented in

LiveWire 1.0

Replyto

User name to which replies to the message should be sent. Defaults to the sender's address.

Property of

SendMail

Implemented in

Netscape Server 3.0

Smtpserver

Mail (SMTP) server name. Defaults to the value specified through the setting in the Administration server.

Property of

SendMail

Implemented in

Netscape Server 3.0

Subject

Subject of the message.

Property of

SendMail

Implemented in

Netscape Server 3.0

To

Comma-delimited list of primary recipients of the message.

Property of

SendMail

Implemented in

Netscape Server 3.0

Methods

errorCode

Returns an integer error code associated with sending this message.

Method of

SendMail

Implemented in

Netscape Server 3.0

Syntax

public errorCode();

Returns

The possible return values and their meanings are as follows:

0
Successful send.

1
SMTP server not specified.

2
Specified mail server is down or doesn't exist.

3
At least one receiver's address must be specified to send the message.

4
Sender's address must be specified to send the message.

5
Mail connection problem; data not sent.

errorMessage

Returns a string associated with sending this message.

Method of

SendMail

Implemented in

Netscape Server 3.0

Syntax

public errorMessage();

Returns

An error string.

send

Sends the mail message represented by this object.

Method of

SendMail

Implemented in

Netscape Server 3.0

Syntax

public send ();

Returns

This method returns a Boolean value to indicate whether or not the mail was successfully sent. If the mail was not successfully sent, you can use the errorMessage and errorCode methods to determine the nature of the error.

This method returns a string indicating the nature of the error that occurred sending the message.



[Contents] [Previous] [Next] [Index]

Last Updated: 10/31/97 16:37:22


Copyright © 1997 Netscape Communications Corporation