Mail session configuration settings

Use this page to configure mail sessions.

You can access this administrative console page in one of two ways:
  • Resources > Mail > Mail sessions > mail_session
  • Resources > Mail > Mail Providers > mail_provider > Mail sessions > mail_session

Scope

Specifies the scope of the mail provider that implements the JavaMail API for this mail session. Only applications that you installed within this scope can use this mail session.

Provider

Specifies the mail provider that the application server uses for this mail session.

When you create a mail session, if you previously defined one or more mail providers at the relevant scope, you will see a list from which you can select an existing mail provider for the new mail session.

Create New Provider

Provides the option of configuring a new mail provider for the new mail session.

Create New Provider is displayed only when you click Resources > Mail > Mail sessions > New to create a new mail session.

Clicking Create New Provider triggers the console to display the mail provider configuration page, where you create a new provider. After you click OK to save your settings, you see the mail session collection page. Click New to define a new mail session for use with the new provider; the console now displays a configuration page that lists the new mail provider as the mail session Provider.

Avoid trouble: After you create a mail session, you cannot change the provider of that mail session.

Name

Specifies the administrative name of the JavaMail session object.

JNDI name

Specifies the Java™ Naming and Directory Interface (JNDI) name for the resource, including any naming subcontexts.

This name provides the link between the platform binding information for resources that are defined in the client application deployment descriptor and the actual resources bound into JNDI by the platform.

Important: Adhere to the following requirements for JNDI names:
  • Do not assign duplicate JNDI names across different resource types (such as mail sessions versus data sources).
  • Do not assign duplicate JNDI names for multiple resources of the same type in the same scope.

Description

Specifies an optional description for your administrative records.

Category

Specifies an optional collection for classifying or grouping sessions.

Enable debug mode

Toggles debug mode on and off for this mail session.

Enable strict Internet address parsing

Specifies whether the recipient addresses must be parsed in strict compliance with RFC 822, which is a specifications document issued by the Internet Architecture Board.

This setting is not generally used for most mail applications. RFC 822 syntax for parsing addresses effectively enforces a strict definition of a valid email address. If you select this setting, your mail component adheres to RFC 822 syntax and rejects recipient addresses that do not parse into valid email addresses (as defined by the specification). If you do not select this setting, the mail component does not adhere to RFC 822 syntax and accepts recipient addresses that do not comply with the specification. By default, this setting is not selected. You can view the RFC 822 specification at the World Wide Web Consortium website.

Outgoing Mail Properties

Server: outgoing

Specifies the server that is accessed when sending mail.

Protocol: outgoing

Specifies the protocol to use when sending mail. Actual protocol values are defined in the protocol providers that you configured for the current mail provider.

User: outgoing

Specifies the user of the mail account when the outgoing mail server requires authentication.

This setting is not generally used for most mail servers. Leave this field blank unless you use a mail server that requires a user ID and password.

Password: outgoing

Specifies the password to use when the outgoing mail server requires authentication.

This setting is not generally used for most mail servers. Leave this field blank unless you use a mail server that requires a user ID and password.

Verify Password: outgoing

Verify the password.

Return email address: outgoing

Specifies the Internet email address that is displayed in messages as the mail originator.

This value represents the Internet email address that, by default, displays in the received message in the From or the Reply-To address. The recipient's reply will come to this address.

Incoming Mail Properties

Server

Specifies the server that is accessed when receiving mail.

Protocol

Specifies the protocol to use when receiving mail. Actual protocol values are defined in the protocol providers that you configured for the current mail provider.

User

Specifies the user of the mail account when the incoming mail server requires authentication.

This setting is not generally used for most mail servers. Leave this field blank unless you use a mail server that requires a user ID and password.

Password

Specifies the password to use when the incoming mail server requires authentication.

This setting is not generally used for most mail servers. Leave this field blank unless you use a mail server that requires a user ID and password.