SENDMAIL        Send e-mail message to one or more recipients

 Top  Previous  Next

Syntax:

SENDMAIL

[ server ] [ to name ] [ to email ] [ /options ]

Arguments:

[ server ]

Variable or string defining the server URL or IP address (e.g., smtp.mail.server or 209.198.128.17) of a SMTP mail server; the server port is always set to 25

 

[ to name ]

Variable or string defining the optional name(s) of recipients; this argument is required in the command even if you do not specify a recipient name - in this case be sure to specify an empty string (e.g., ""); to list multiple names, separate each name with a comma

 

[ to email ]

Variable or string defining e-mail address(es) of recipients; to list multiple e-mail addresses, separate each address with a comma

Options:

/pw=xx

Define optional password to use when logging on to the mail server (omit if not required by the SMTP server)

 

/user=xx

Define optional user name to use when logging on to the mail server (omit if not required by the SMTP server)

 

/stoponerror

When sending to multiple recipients, use this option to stop sending to any additional e-mail addresses when there is any error on the current message.

 

/timeout=nn

Time-out, in seconds, to wait for message to be sent (if omitted the time-out is set to 30 seconds)

 

 

This command sends an e-mail message previously created with the CREATEMAIL command via a SMTP e-mail server to one or more recipients. All of the arguments to this command are required, however [ to name ] may be an empty string.

 

The same message is sent each time SENDMAIL is called unless CREATEMAIL is called again to change the message.

 

Consider the following example where an e-mail message is created and then sent.

 

;; create the message

SET from = "Acme Widget Co. Sales"

SET email = "[email protected]"

SET subj = "Thanks for your order!"

SET body = "We appreciate your business."

SET attach = ""

CREATEMAIL from email subj body attach

;; send the message

SENDMAIL "120.33.13.10" "Joe Blow" "[email protected]"

 

Consider the following example where authentication is required on the SMTP server (not all mail servers will require authentication.)

 

SET server = "smtp.mail.server"

SET to = "Ray Johnson"

SET email = "[email protected]"

SENDMAIL server to email /user=smtpid /pw=smtppw

 

Consider the following example where the same message is sent to three recipients.

 

SET server = "smtp.mail.server"

SET to = "Ray Johnson,Dick Martin,Dan Rowan"

SET email = "[email protected],[email protected],[email protected]"

SENDMAIL server to email

 

When multiple messages are sent in this way, each message is sent separately. Do not confuse this with sending CC or BCC copies.

 

Related Command(s): CREATEMAIL, GETMAIL, MAILTO