SendMail

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();

<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

`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.

`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.

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.

SendMail

Parameters

Bcc

errorCode

Returns

Returns

Returns