Mail session configuration settings
Configure mail sessions.
We 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
Scope of the mail provider that implements the JavaMail API for this mail session. Only applications that we installed within this scope can use this mail session.
Provider
Mail provider that the application server uses for this mail session.
When we create a mail session, if we previously defined one or more mail providers at the relevant scope, we will see a list from which we 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 we create a new provider. After clicking OK to save our settings, we 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.
After creating a mail session, we cannot change the provider of that mail session.
Name
Administrative name of the JavaMail session object.
JNDI name
JNDI name for the resource, including any naming subcontexts.
This name provides the link between the platform binding information for resources 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 our 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 we 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 we 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. We can view the RFC 822 specification at the World Wide Web Consortium website.
Outgoing Mail Properties
Server
Server that is accessed when sending mail.
Protocol
Protocol to use when sending mail. Actual protocol values are defined in the protocol providers that we configured for the current mail provider.
User
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 we use a mail server that requires a user ID and password.
Password
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 we use a mail server that requires a user ID and password.
Verify Password
Verify the password.
Return email address
Internet email address 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
Server that is accessed when receiving mail.
Protocol
Protocol to use when receiving mail. Actual protocol values are defined in the protocol providers that we configured for the current mail provider.
User
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 we use a mail server that requires a user ID and password.
Password
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 we use a mail server that requires a user ID and password.
Verify Password
Verify the password.
Enable J2EE applications to use mail resources with JavaMail Configure mail providers and sessions Mail session configuration settings Mail service providers and mail sessions RFC 822 protocol specifications