Sun logo      Previous      Contents      Next     

Sun Java™ System Application Server Platform Edition 8 Administration Guide

Chapter 5
JavaMail Resources

This chapter briefly describes how to configure resources for applications that use the JavaMail API. It contains the following sections:

About JavaMail

The JavaMail API

The JavaMail API is a set of abstract APIs that model a mail system. The API provides a platform-independent and protocol-independent framework to build mail and messaging applications. The JavaMail API provides facilities for reading and sending email. Service providers implement particular protocols.

The JavaMail API is implemented as a Java platform optional package and is also available as part of the J2EE platform.

The Sun Java™ System Application Server Platform Edition 8 includes the JavaMail API along with a JavaMail service provider that allows an application component to send email notifications over the Internet and to read email from IMAP and POP3 mail servers.

For more information about the JavaMail API, go to the JavaMail website (http://java.sun.com/products/javamail/).

Admin Console Tasks for JavaMail

Creating a JavaMail Session

  1. In the tree component, select the Java Mail Sessions node.
  2. On the Java Mail Sessions page, click New. The Create Java Mail Session page appears.
  3. In the JNDI Name field, type the name of the session. For example:
    4. mail/MySession

    It is a recommended practice to use the naming subcontext prefix mail/ for JavaMail resources.

  4. In the Mail Host field, type the DNS 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.
  5. In the Default User field, type the username 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.
  6. In the Default Return Address field, type the email address of the default user, in the form username@host.domain.
  7. Deselect the Enabled checkbox if you do not want to enable the mail session at this time.
  8. In the Advanced area, change the field values only if you have reconfigured the Application Server’s mail provider to use a nondefault store or transport protocol. By default, the Store Protocol is imap; the Store Protocol Class is com.sun.mail.imap.IMAPStore; the Transport Protocol is smtp; and the Transport Protocol Class is com.sun.mail.smtp.SMTPTransport.

    9. Select the Debug 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 will be generated and will be included in the system log file. See Configuring Log Levels for information about setting the log level.

  9. In the Additional Properties area, click Add Property to add properties required by your application, such as a protocol-specific host or username property. The JavaMail API documentation lists the properties you might want to set (http://java.sun.com/products/javamail/javadocs/index.html).
  10. Click OK to save the session.

Equivalent asadmin command: create-javamail-resource

Editing a JavaMail Session

  1. In the tree component, select the Java Mail Sessions node.
  2. On the Java Mail Sessions page, select the session to be edited.
  3. On the Edit Java Mail Session page, you may do the following:
    • Modify the values in the Mail Host, Default User, Default Return Address, or Description field.
    • Select or deselect the Enabled checkbox to enable or disable the resource.
    • Modify the values of the Advanced fields.
    • Add, remove, or modify properties.
  4. Click Save to save your changes, or click Load Defaults to restore the default values for a mail session.

Deleting a JavaMail Session

  1. In the tree component, select the Java Mail Sessions node.
  2. On the Java Mail Sessions page, select the checkbox next to the name of the session to be deleted.
  3. Click Delete.

Equivalent asadmin command: delete-javamail-resource



Previous      Contents      Next     

Copyright 2004 Sun Microsystems, Inc. All rights reserved.