Message-Driven Bean Configuration

Connection Factory and Destination

A message-driven
bean is a client to a Connector inbound resource adapter. The message-driven
bean container uses the JMS service integrated into the GlassFish 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.xml file 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):

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, click the Help button in the Administration Console. The Monitor tab is accessible from the Application Server
page.