Difference between revisions of "SENDMAIL()"
From Recital Documentation Wiki
Barrymavin (Talk | contribs) (→Example) |
Yvonnemilne (Talk | contribs) |
||
| (One intermediate revision by one user not shown) | |||
| Line 8: | Line 8: | ||
==See Also== | ==See Also== | ||
| − | [[CLOSEMAIL()]], [[COUNTMAIL()]], [[DELETEMAIL()]], [[MAILCLOSE()]], [[MAILCOUNT()]], [[MAILDELETE()]], [[MAILERROR()]], [[MAILHEADER()]], [[MAILNODENAME()]], [[MAILOPEN()]], [[MAILREAD()]], [[MAILSEND()]], [[MAILUSERNAME()]], [[OPENMAIL()]], [[READMAIL()]] | + | [[CLOSEMAIL()]], [[COUNTMAIL()]], [[DELETEMAIL()]], [[MAILATTACH()]], [[MAILCLOSE()]], [[MAILCOUNT()]], [[MAILDELETE()]], [[MAILERROR()]], [[MAILHEADER()]], [[MAILNODENAME()]], [[MAILOPEN()]], [[MAILREAD()]], [[MAILSAVEAS()]], [[MAILSEND()]], [[MAILUSERNAME()]], [[OPENMAIL()]], [[READMAIL()]] |
| Line 39: | Line 39: | ||
==Example== | ==Example== | ||
<code lang="recital"> | <code lang="recital"> | ||
| − | // Open SMTP | + | // Open SMTP mail connection to the mail server |
m_open = mailopen("mailserver.company.com","username","password","SMTP") | m_open = mailopen("mailserver.company.com","username","password","SMTP") | ||
if not m_open | if not m_open | ||
| Line 46: | Line 46: | ||
endif | endif | ||
| + | // send the mail | ||
fromname = "info@recital.com" | fromname = "info@recital.com" | ||
tonames = "fred@recital.com;sue@recital.com" | tonames = "fred@recital.com;sue@recital.com" | ||
| Line 54: | Line 55: | ||
attachments = "info.doc, info.xls" | attachments = "info.doc, info.xls" | ||
mailsend(fromname, tonames, ccnames, subject, msg, attachments) | mailsend(fromname, tonames, ccnames, subject, msg, attachments) | ||
| + | |||
| + | // close the connection to the mail server | ||
mailclose() | mailclose() | ||
| − | // Open SMTP | + | // Open SMTP mail connection to the mail server |
m_open = mailopen("mailserver.company.com", "username", "password") | m_open = mailopen("mailserver.company.com", "username", "password") | ||
if not m_open | if not m_open | ||
| Line 72: | Line 75: | ||
content = "text/html" | content = "text/html" | ||
sendmail(fromname, tonames, ccnames, subject, msg, attachments, .F., content) | sendmail(fromname, tonames, ccnames, subject, msg, attachments, .F., content) | ||
| + | |||
| + | // close the connection to the mail server | ||
mailclose() | mailclose() | ||
</code> | </code> | ||
Latest revision as of 13:50, 4 July 2011
Purpose
Function to send mail
Syntax
SENDMAIL([<expC1>],<expC2>, [<expC3>], [<expC4>], <expC5> [,<expC6> [, <expL1>]] [,<expC7>])
See Also
CLOSEMAIL(), COUNTMAIL(), DELETEMAIL(), MAILATTACH(), MAILCLOSE(), MAILCOUNT(), MAILDELETE(), MAILERROR(), MAILHEADER(), MAILNODENAME(), MAILOPEN(), MAILREAD(), MAILSAVEAS(), MAILSEND(), MAILUSERNAME(), OPENMAIL(), READMAIL()
Description
The SENDMAIL() function is used for sending mail. If successful the SENDMAIL() will return .T. or .F. otherwise. The MAILERROR() function can be used to return the error message if the SENDMAIL() fails.
| Parameters | Required | Default | Description |
|---|---|---|---|
| <expC1> | No | Your node | The from name of the sender |
| <expC2> | Yes | None | A semi-colon separated list of recipient names to receive the message |
| <expC3> | Yes | None | A semi-colon separated list of cc recipient names to receive the message |
| <expC4> | No | None | The subject of the message |
| <expC5> | Yes | None | The message to be sent. This can be a character string, a variable containing a character string or a character string containing the name of a text file. |
| <expC6> | No | None | A comma separated list of names of files to be sent as attachments |
| <expL1> | No | None | Open VMS only. If <expL1> is .T. (true), any attachments will be sent as ASCII, not binary. If <expL1> is .F. or omitted, all attachments will be sent as binary 64 bit encoded. |
| <expC7> | No | text/plain | Content type |
Example
// Open SMTP mail connection to the mail server m_open = mailopen("mailserver.company.com","username","password","SMTP") if not m_open dialog box mailerror() return endif // send the mail fromname = "info@recital.com" tonames = "fred@recital.com;sue@recital.com" ccnames = "bert@recital.co.uk;linda@recital.co.uk" subject = "For your information" msg = "Dear All" + chr(10) + "Here are the files you asked for."; + chr(10) + "Best regards" + chr(10) + "Sam" attachments = "info.doc, info.xls" mailsend(fromname, tonames, ccnames, subject, msg, attachments) // close the connection to the mail server mailclose() // Open SMTP mail connection to the mail server m_open = mailopen("mailserver.company.com", "username", "password") if not m_open dialog box mailerror() return endif // sendmail() and mailsend() are functionally identical fromname = "info@recital.com" tonames = "fred@recital.com" ccnames = "" subject = "For your information" msg = "email.htm" attachments = "" content = "text/html" sendmail(fromname, tonames, ccnames, subject, msg, attachments, .F., content) // close the connection to the mail server mailclose()
Products
Recital, Recital Server
