PRINT FROM SAP HELP PORTAL

Document:
Configuring the JavaMail Client Service

URL:
http://help.sap.com/saphelp_nw73ehp1/helpdata/en/b0/51ad27728a497d8640ff3319e714c5/frameset.htm

Date created:
August 02, 2013

© 2013 SAP AG or an SAP affiliate company. All rights reserved. No part of this publication may be reproduced or transmitted in any form or for any purpose without the express
permission of SAP AG. The information contained herein may be changed without prior notice. Some software products marketed by SAP AG and its distributors contain proprietary
software components of other software vendors. National product specifications may vary. These materials are provided by SAP AG and its affiliated companies ("SAP Group") for
informational purposes only, without representation or warranty of any kind, and SAP Group shall not be liable for errors or omissions with respect to the materials. The only
warranties for SAP Group products and services are those that are set forth in the express warranty statements accompanying such products and services, if any. Nothing herein
should be construed as constituting an additional warranty. SAP and other SAP products and services mentioned herein as well as their respective logos are trademarks or
registered trademarks of SAP AG in Germany and other countries. Please see www.sap.com/corporate-en/legal/copyright/index.epx#trademark for additional trademark information
and notices.

Note
This PDF document contains the selected topic and its subtopics (max. 150) in the selected structure.
Subtopics from other structures are not included.

PUBLIC Page 1 of 5
© 2013 SAP AG or an SAP affiliate company. All rights reserved.
 Configuring the JavaMail Client Service
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

PUBLIC Page 2 of 5
© 2013 SAP AG or an SAP affiliate company. All rights reserved.
 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
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

PUBLIC Page 3 of 5
© 2013 SAP AG or an SAP affiliate company. All rights reserved.
 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.

PUBLIC Page 4 of 5
© 2013 SAP AG or an SAP affiliate company. All rights reserved.
 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.

PUBLIC Page 5 of 5
© 2013 SAP AG or an SAP affiliate company. All rights reserved.