Message-Driven Bean Configuration

This section addresses the following configuration topics:

• Using Session Beans

• Message-Driven Bean Pool

• Domain-Level Settings

Connection Factory and Destination

A message-driven bean is a client to a Connector 1.5 inbound resource adapter. The message-driven bean container uses the JMS service integrated into the Application Server for message-driven beans that are JMS clients. JMS clients use JMS Connection Factory- and Destination-administered objects. A JMS Connection Factory administered object is a resource manager Connection Factory object that is used to create connections to the JMS provider.

The mdb-connection-factory element in the sun-ejb-jar.xmlfile for a message-driven bean specifies the connection factory that creates the container connection to the JMS provider.

The jndi-name element of the ejb element in the sun-ejb-jar.xml file specifies the JNDI name of the administered object for the JMS Queue or Topic destination that is associated with the message-driven bean.

Message-Driven Bean Pool

The container manages a pool of message-driven beans for the concurrent processing of a stream of messages. The sun-ejb-jar.xml file contains the elements that define the pool (that is, the bean-pool element):

• steady-pool-size

• resize-quantity

• max-pool-size

• pool-idle-timeout-in-seconds

For more information about sun-ejb-jar.xml, see The sun-ejb-jar.xml File.

Domain-Level Settings

You can control the following domain-level message-driven bean settings in the EJB container:

• Initial and Minimum Pool Size - Specifies the initial and minimum number of beans maintained in the pool. The default is 0.

• Maximum Pool Size - Specifies the maximum number of beans that can be created to satisfy client requests. The default is 32.

• Pool Resize Quantity - Specifies the number of beans to be created if a request arrives when the pool is empty (subject to the Initial and Minimum Pool Size), or the number of beans to remove if idle for more than the Idle Timeout. The default is 8.

• Idle Timeout - Specifies the maximum time in seconds that a bean can remain idle in the pool. After this amount of time, the bean is destroyed. The default is 600 (10 minutes). A value of 0 means a bean can remain idle indefinitely.

For information on monitoring message-driven beans, see the Application Server Administration Console online help and the Sun Java System Application Server Platform Edition 8.2 Administration Guide.

Running monitoring when it is not needed might impact performance, so you might choose to turn monitoring off when it is not in use. For details, see the Sun Java System Application Server Platform Edition 8.2 Administration Guide.