Mail session 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

Configuration tab

Scope

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

Provider

Specifies the mail provider that WebSphere Application Server uses for this mail session. When creating a mail session: If you previously defined one or more mail providers at the relevant scope, you see a list from which you can select an existing mail provider for your 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 session > 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. Remember: 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.

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.

Mail transport host

Server that is accessed when sending mail.

Mail transport protocol

Timeransport protocol that is used when sending mail.

Mail transport user ID

User ID when the mail transport host 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.

Mail transport password

Password when the mail transport host 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.

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 e-mail address. If you select this setting, your JavaMail component adheres to RFC 822 syntax and rejects recipient addresses that do not parse into valid e-mail addresses (as defined by the specification). If you do not select this setting, your JavaMail 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 following Web address for the World Wide Web Consortium (W3C): http://www.w3.org/Protocols/rfc822/.

Mail from

Specifies the mail originator.

This value represents the Internet e-mail address that, by default, displays in the received message, as either the From or the Reply-To address. The recipient's reply comes to this address.

Mail store host

Server that is accessed when receiving the mail.

This setting, combined with the mail store user ID and password, represents a valid mail account. For example, if the mail account is john_william@my.company.com, then the mail store host is my.company.com.

Mail store protocol

Protocol that is used when receiving mail; it can be Internet Message Access Protocol (IMAP), Post Office Protocol 3 (POP3), or any store protocol for which an administrator has installed a provider.

Mail store user ID

User ID for the given mail account.

For example, if the mail account is john_william@my.company.com then the user is john_william.

Mail store password

Password for the given mail account .

For example, if the mail account is john_william@my.company.com then enter the password for ID john_william.

Enable debug mode

Toggles debug mode on and off for this mail session.

Related tasks

Reference topic