Difference between revisions of "SENDMAIL()"

From Recital Documentation Wiki
Jump to: navigation, search
 
 
(7 intermediate revisions by 3 users not shown)
Line 1: Line 1:
=SENDMAIL()=
 
 
 
==Class==
 
Mail
 
 
 
 
==Purpose==
 
==Purpose==
 
Function to send mail
 
Function to send mail
Line 15: 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 45: Line 38:
  
 
==Example==
 
==Example==
// Open SMTP for sending
+
<code lang="recital">
 +
// 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
dialog box mailerror()
+
    dialog box mailerror()
return
+
    return
 
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"
 
ccnames = "bert@recital.co.uk;linda@recital.co.uk"
 
ccnames = "bert@recital.co.uk;linda@recital.co.uk"
 
subject = "For your information"
 
subject = "For your information"
message = "Dear All" + chr(10) + "Here are the files you asked for." + chr(10) + ;
+
msg = "Dear All" + chr(10) + "Here are the files you asked for.";
"Best regards" + chr(10) + "Sam"
+
+ chr(10) + "Best regards" + chr(10) + "Sam"
 
attachments = "info.doc, info.xls"
 
attachments = "info.doc, info.xls"
mailsend(fromname,tonames,ccnames,subject,message,attachments)
+
mailsend(fromname, tonames, ccnames, subject, msg, attachments)
 +
 
 +
// close the connection to the mail server
 
mailclose()
 
mailclose()
  
// Open SMTP for sending
+
// 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")
 
if not m_open
 
if not m_open
dialog box mailerror()
+
    dialog box mailerror()
return
+
    return
 
endif
 
endif
  
 +
// sendmail() and mailsend() are functionally identical
 
fromname = "info@recital.com"
 
fromname = "info@recital.com"
 
tonames = "fred@recital.com"
 
tonames = "fred@recital.com"
 
ccnames = ""
 
ccnames = ""
 
subject = "For your information"
 
subject = "For your information"
message = "email.htm"
+
msg = "email.htm"
 
attachments = ""
 
attachments = ""
content = "test/html"
+
content = "text/html"
sendmail(fromname,tonames,ccnames,subject,message,attachments,.F.,content)
+
sendmail(fromname, tonames, ccnames, subject, msg, attachments, .F., content)
 +
 
 +
// close the connection to the mail server
 
mailclose()
 
mailclose()
 
</code>
 
</code>
 
  
 
==Products==
 
==Products==
Recital Database Server, Recital Mirage Server, Recital Terminal Developer
+
Recital, Recital Server
 
[[Category:Documentation]]
 
[[Category:Documentation]]
 
[[Category:Functions]]
 
[[Category:Functions]]
 +
[[Category:Mail]]
 +
[[Category:Mail Functions]]

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