Sun Microsystems 820433510 manual Creating a JavaMail Session

Creating a JavaMail Session

To create a JavaMail session using the Admin Console, select Resources —> JavaMail Sessions. Specify the JavaMail settings as follows:

■JNDI Name: The unique name for the mail session. Use the naming sub-context prefix mail/

for JavaMail resources. For example: mail/MySession.

■Mail Host: The host name of the default mail server. The connect methods of the Store and Transport objects use this value if a protocol-specific host property is not supplied. The name must be resolvable to an actual host name.

■Default User: The user name to provide when connecting to a mail server. The connect methods of the Store and Transport objects use this value if a protocol-specific username property is not supplied.

■Default Return Address: The email address of the default user, in the form: username@host.domain.

■Description: Provide a descriptive statement for the component.

■Session: Deselect the Enabled checkbox if you do not want to enable the mail session at this time.

Additionally, define the following Advanced settings only if the mail provider has been re-configured to use a non-default store or transport protocol:

■Store Protocol: Defines the Store object communication method to be used. By default, the Store Protocol is imap.

■Store Protocol Class: Provides the Store communication method class that implements the desired Store protocol. By default, the Store Protocol Class is com.sun.mail.imap.IMAPStore.

■Transport Protocol: Identifies the transport communication method. By default, the Transport Protocol is smtp.

■Transport Protocol Class: Defines the communication method for the transport class. By default, the Transport Protocol Class is com.sun.mail.smtp.SMTPTransport.

■Debug: Select this checkbox to enable extra debugging output, including a protocol trace, for this mail session. If the JavaMail log level is set to FINE or finer, the debugging output is generated and is included in the system log file.

■Additional Properties: Create properties required by applications, such as a protocol-specific host or username property. Ensure that every property name you define start with a mail- prefix. If the name of the property does not start withmail-, the property is ignored.

76 Sun GlassFish Enterprise Server 2.1 Administration Guide • December 2008