JavaMail Properties
E-mail Server uses the JavaMail API library 1.4. JavaMail can make use of numerous properties, which are documented at the following locations:
- Environment properties: http://www.oracle.com/technetwork/java/javamail-1-149769.pdf (Appendix A: Environment Properties)
- JavaMail Session properties: https://javamail.java.net/nonav/docs/api/
- JavaMail Session properties for IMAP: https://javamail.java.net/nonav/docs/api/com/sun/mail/imap/package-summary.html
- JavaMail Session properties for POP3: https://javamail.java.net/nonav/docs/api/com/sun/mail/pop3/package-summary.html
These properties are treated in different ways in eServices, depending on
- Whether they are set internally by E-mail Server.
- Whether they can be modified by users.
These two parameters define three different categories of property:
- Set internally and not user-modifiable
- Set internally and user-modifiable
- Not set internally and user-modifiable
The next three sections list the properties in each category and describe how to set the ones in user-modifiable categories.
Set Internally, Not User-Modifiable
- mail.pop3.class
- mail.imap.class
Set Internally, User-Modifiable
- mail.debug
- mail.pop3.host
- mail.pop3.user
- mail.pop3.port
- mail.pop3.connectiontimeout
- mail.pop3.timeout
- mail.pop3.socketFactory.class
- mail.pop3.socketFactory.fallback
- mail.pop3.socketFactory.port
- mail.pop3.socks.host
- mail.pop3.socks.port
- mail.imap.host
- mail.imap.user
- mail.imap.port
- mail.imap.connectiontimeout
- mail.imap.timeout
- mail.imap.socketFactory.class
- mail.imap.socketFactory.fallback
- mail.imap.socketFactory.port
- mail.imap.socks.host
- mail.imap.socks.port
- mail.smtp.socks.host
- mail.smtp.socks.port
You can modify these using existing configuration options in the [pop-client] and [smtp-client] sections, as shown in the following table. In this table, <protocol> is either POP3 or IMAP; for example, mail.<protocol>.timeout covers mail.pop3.timeout and mail.imap.timeout. JavaMail Properties Controlled by Configuration Options
| JavaMail Property | Configuration Option |
|---|---|
| mail.debug | enable-debug |
| mail.<protocol>.connectiontimeout | connect-timeout |
| mail.<protocol>.timeout | protocol-timeout |
| mail.<protocol>.user | mailbox |
| mail.<protocol>.host | server |
| mail.<protocol>.port mail.<protocol>.socketFactory.port |
port |
| mail.<protocol>.socketFactory.class mail.<protocol>.socketFactory.fallback |
enable-ssl |
See the eServices Options Reference for complete information on these options.