Difference between revisions of "SENDMAIL()"

From Recital Documentation Wiki
Jump to: navigation, search
(Example)
 
(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 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","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 for sending
+
// 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