Skip navigation.
Downloads | Product Documentation | Support

Administration Console Online Help

# Mail

[Attributes and Console Screen Reference for Mail Sessions]

WebLogic Server includes the JavaMail API version 1.1.3 reference implementation from Sun Microsystems. Using the JavaMail API, you can add email capabilities to your WebLogic Server applications. JavaMail provides access from Java applications to IMAP- and SMTP-capable mail servers on your network or the Internet. It does not provide mail server functionality; so you must have access to a mail server to use JavaMail.

To configure JavaMail for use in WebLogic Server, you create a Mail Session in the WebLogic Server Administration Console. This allows server-side components and applications to access JavaMail services with JNDI, using Session properties you preconfigure for them. For example, by creating a Mail Session, you can designate the mail hosts, transport and store protocols, and the default mail user in the Administration Console so that components that use JavaMail do not have to set these properties. Applications that are heavy email users benefit because WebLogic Server creates a single Session object and makes it available via JNDI to any component that needs it.

# Tasks

## Configuring a New Mail Session

To configure a new mail session, proceed as follows:

1. Start the WebLogic Server Administration Console.
2. In the left pane of the Console, select Services > Mail.
3. In the right pane of the Console, click the Configure a New Mail Session option. A dialog displays in the right pane showing the tabs associated with configuring a new mail session.
4. Using the available tabs, enter the following information:

- Configuration—Enter values in the Name, JNDI Name, and Properties attribute fields.
- Targets—Indicate the Targets-Server for this configured mail session by moving the server from the Available list to the Chosen list.
- Notes—Enter notes related to the mail session.

5. Click Apply to create a mail session instance with the name you specified in the Name field. The new instance is added under the Mail node in the left pane.

## Cloning a Mail Session

1. Under Services, click the Mail node. The Mail table displays in the right pane showing all the mail sessions defined in your domain.
2. Click the Clone icon (to the left of the Delete icon) in the row of the mail session you want to clone. A dialog displays in the right pane showing the tabs associated with cloning a mail session.
3. Using the available tabs, enter the following information:

- Configuration—Enter values in the Name, JNDI Name, and Properties attribute fields.
- Targets—Indicate the Targets-Server for this configured mail session by moving the server from the Available list to the Chosen list.
- Notes—Enter notes related to the mail session.

4. Click Clone to create a mail session instance with the name you specified in the Name field. The new instance is added under the Mail node in the left pane.

## Deleting a Mail Session

1. Under Services, click the Mail node. The Mail table displays in the right pane showing all the mail sessions defined in your domain.
2. Click the Delete icon in the row of the mail session you want to delete. A dialog displays in the right pane asking you to confirm your deletion request.
3. Click Yes to delete the mail session. The mail session icon under the Mail node is deleted.

## Assigning a Mail Session

1. Click the instance node in the left pane for the Mail Session you want to assign. A dialog displays in the right pane showing the tabs associated with this instance.
2. Click the Targetand Deploy tab.
3. Complete the following steps for the Target and Deploy tab:

1. Select one or more targets to which you wish to assign mail.
2. Click Apply to save your assignments.