Show TOC

Background documentationConfiguring the JavaMail Client Service Locate this document in the navigation structure

 

The JavaMail Client Service owns a set of properties that allow you to configure the behavior of the service. Using each property is described further in this chapter. Here, they are listed together only as a reference.

You can change these properties using the SAP NetWeaver Administrator.

More information: Java System Properties

JavaMail Client Service Properties

Property

Default Value

Description

mail.from

mymail@sap.com

Specifies the sender of the mail message, that is, the value of the mail from header.

sslCertificate

default

Specifies the SSL certificate to be used for authentication if the connection is secure.

The certificate must already be available in the Key Store.

mail.debug

false

Specifies if the Session object bound to the naming system has the debug option enabled.

If you set this property to true, the JavaMail Client Service logs debug information.

mail.host

localhost

Specifies the default host name for sending and receiving mail. This default value is used if the mail.<protocol>.host property is not set.

mail.store.protocol

pop3

Specifies the default store protocol.

The method getStore() of the Session object returns a Store object which implements this protocol.

mail.transport.protocol

smtp

Specifies the default transport protocol.

The method getTransport() of the Session object returns a Transport object which implements this protocol.

mail.user

Default user name for connecting to the mail server.

Used if there are no user names set for the specific protocols (mail.<protocol>.user).

mail.password

Default password for connecting to the mail server.

Used if there are no passwords set for the specific protocols (mail.<protocol>.password).

mail.imap.user

Specifies the user name to be used for connecting to the Internet Message Access Protocol (IMAP) server.

mail.imap.password

Specifies the password to be used for connecting to the Internet Message Access Protocol (IMAP) server.

mail.imap.host

Specifies the host name of the Internet Message Access Protocol (IMAP) server.

mail.imap.port

143

Used if the connect() method does not specify a port explicitly.

If this property is not set, the default IMAP port applies.

mail.imap.proxyauth.user

If the IMAP server supports the PROXYAUTH extension, this property specifies a user name to be used with the PROXYAUTH command.

mail.imap.starttls.enable

false

If set to true, the property enables the use of the STARTTLS command (if supported by the server) to switch the connection to a TLS-protected connection, before issuing any login commands.

Note Note

An appropriate trust store must be configured so that the client trusts the certificate of the server.

End of the note.

mail.imaps.user

Specifies the user name to be used for connecting to the secure Internet Message Access Protocol (IMAPS) server.

mail.imaps.password

Specifies the password to be used for connecting to the secure Internet Message Access Protocol (IMAPS) server.

mail.imaps.host

Specifies the host name of the secure Internet Message Access Protocol (IMAPS) server.

mail.imaps.port

993

Used if the connect() method does not specify a port explicitly.

If this property is not set, the default IMAPS port applies.

mail.imaps.proxyauth.user

If the IMAPS server supports the PROXYAUTH extension, this property specifies a user name to be used with the PROXYAUTH command.

mail.imaps.starttls.enable

false

If set to true, the property enables the use of the STARTTLS command (if supported by the server) to switch the connection to a TLS-protected connection, before issuing any login commands.

Note Note

An appropriate trust store must be configured so that the client trusts the certificate of the server.

End of the note.

mail.pop3.user

Specifies the user name to be used for connecting to the Post Office Protocol version 3 (POP3) server.

mail.pop3.password

Specifies the password to be used for connecting to the Post Office Protocol version 3 (POP3) server.

mail.pop3.host

Specifies the host name of the Post Office Protocol version 3 (POP3) server.

mail.pop3.port

110

Used if the connect() method does not specify a port explicitly.

If this property is not set, the default POP3 port applies.

mail.pop3s.user

Specifies the user name to be used for connecting to the secure the secure Post Office Protocol version 3 (POP3S) server.

mail.pop3s.password

Specifies the password to be used for connecting to the secure the secure Post Office Protocol version 3 (POP3S) server.

mail.pop3s.host

Specifies the host name of the secure Post Office Protocol version 3 (POP3S) server.

mail.pop3s.port

995

Used if the connect() method does not specify a port explicitly.

If this property is not set, the default POP3S port applies.

mail.smtp.user

Specifies the user name to be used for connecting to the Simple Mail Transfer Protocol (SMTP) server.

mail.smtp.password

Specifies the password to be used for connecting to the Simple Mail Transfer Protocol (SMTP) server.

mail.smtp.host

Specifies the host name of the Simple Mail Transfer Protocol (SMTP) server.

mail.smtp.port

25

Used if the connect() method does not specify a port explicitly. If this property is not set, the default SMTP port applies.

mail.smtp.auth

false

If set to true, use the AUTH command for authentication.

mail.smtp.submitter

Specifies the responsible submitter of the mail message.

mail.smtps.user

Specifies the user name to be used for connecting to the secure Simple Mail Transfer Protocol (SMTPS) server.

mail.smtps.password

Specifies the password to be used for connecting to the secure Simple Mail Transfer Protocol (SMTPS) server.

mail.smtps.host

Specifies the host name of the secure Simple Mail Transfer Protocol (SMTPS) server.

mail.smtps.port

465

Used if the connect() method does not specify a port explicitly. If this property is not set, the default SMTPS port applies.

mail.smtps.auth

false

If set to true, use the AUTH command for authentication.

mail.smtps.submitter

Specifies the responsible submitter of the mail message.

mail.nntp.user

Specifies the user name for connecting to the Network News Transfer Protocol (NNTP) server.

mail.nntp.password

Specifies the password for connecting to the Network News Transfer Protocol (NNTP) server.

mail.nntp.host

Specifies the host name of the Network News Transfer Protocol (NNTP) server.

mail.nntp.port

119

Used if the connect() method does not specify a port explicitly.

If this property is not set, the default NNTP port applies.