### To create a JavaMail session

1. Expand Resources node and select JavaMail Sessions.

2. On the JavaMail Sessions page, click New.

3. Define the following General settings:

   - 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.

4. Define the 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. See To Configure Log Levels for information about setting the log level.

   - Additional Properties: Click Add Property to create properties required by applications, such as a protocol-specific host or username property. For a list of the available properties, see JavaMail API documentation.

5. Click OK to save the session.

##### More Information
Equivalent asadmin command

`create-javamail-resource`

##### See Also

- To create a JavaMail session

- To edit a JavaMail session

- To delete a JavaMail session