View source for MAILOPEN()

==Purpose==
Function to connect to the specified mail server


==Syntax==
MAILOPEN(<expC1>, <expC2>, <expC3> [, <expC4>])


==See Also==
[[CLOSEMAIL()]], [[COUNTMAIL()]], [[DELETEMAIL()]], [[MAILATTACH()]], [[MAILCLOSE()]], [[MAILCOUNT()]], [[MAILDELETE()]], [[MAILERROR()]], [[MAILHEADER()]], [[MAILNODENAME()]], [[MAILREAD()]], [[MAILSAVEAS()]], [[MAILSEND()]], [[MAILUSERNAME()]], [[OPENMAIL()]], [[READMAIL()]], [[SENDMAIL()]]


==Description==
The MAILOPEN() function is used to connect to the specified mail server.  The mail type POP3 should be used for reading mail, and SMTP used for sending mail.


{| class="wikitable"
!Parameters||Required||Default||Description
|-
|<expC1>||Yes||None||The node name or IP address of the mail server
|-
|<expC2>||Yes||None||The user name with which to connect to the mail server
|-
|<expC3>||Yes||None||The password for the user name
|-
|<expC4>||No||POP3||The mail protocol type.  POP3 and SMTP are the currently supported protocols.
|-
|}


If successful the MAILOPEN() will return .T., otherwise .F..  The MAILERROR() function can be used to return the error message if the MAILOPEN() fails.


==Example==
<code lang="recital">
// Open POP3 for reading mail
m_open = mailopen("mailserver.company.com", "username", "password", "POP3")
if not m_open
    dialog box mailerror()
    endif
mailclose()

// Open SMTP for sending
m_open = mailopen("mailserver.company.com","username","password", "SMTP")
if not m_open
    dialog box mailerror()
    endif
mailclose()
</code>


==Products==
Recital Server, Recital 
[[Category:Documentation]]
[[Category:Functions]]
[[Category:Mail]]
[[Category:Mail Functions]]