Show TOC

Configuring the JavaMail Client ServiceLocate this document in the navigation structure

Use

The JavaMail Client Service owns a set of properties that allow you to configure the behavior of the service.

Note

The JavaMail Client Service properties starting with mail. define settings for communication with the mail server and you can use them in any mail application. If these properties are set, you do not need to specify this configuration further in the application code.

You can change these properties using SAP NetWeaver Administrator.

More information: Java System 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

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

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

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

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.