ejb-container

Configures the EJB container. Stateless session beans are maintained
in pools. Stateful session beans have session affinity and are cached.
Entity beans associated with a database primary key are also cached.
Entity beans not yet associated with a primary key are maintained
in pools. Pooled entity beans are used to run ejbCreate() and
finder methods.

Attributes

The following table describes attributes for the ejb-container element.

Table 1–50 ejb-container
Attributes

Attribute

Default

Description

steady-pool-size

32

(optional) Specifies the initial and minimum number of beans
maintained in the pool. Must be 0 or greater and
less than max-pool-size .

Bean instances are removed from the pool and returned after
use. The pool is replenished or cleaned up periodically to maintain
this size.

Applies to stateless session beans and entity beans.

pool-resize-quantity

16

(optional) Specifies the number of beans to be removed when
the pool-idle-timeout-in-seconds timer expires. A cleaner thread removes any unused instances.

Must be 0 or greater and less than max-pool-size . The pool is not resized below the steady-pool-size.

Applies to stateless session beans and entity beans.

max-pool-size

64

(optional) Specifies the maximum number of beans that can be
created to satisfy client requests. A value of 0 indicates
an unbounded pool.

Applies to stateless session beans and entity beans.

cache-resize-quantity

32

(optional) Specifies the number of beans to be:

created if a request arrives when the pool has no
available beans (subject to the max-cache-size limit)

passivated when the cache-idle-timeout-in-seconds timer expires and a cleaner thread removes any unused instances,
or when the cache size exceeds max-cache-size.

Must be greater than 1 and less than max-cache-size.

Applies to stateful session beans and entity
beans.

max-cache-size

512

(optional) Specifies the maximum number of beans in the cache.
A value of 0 indicates an unbounded cache.

Applies to stateful session beans and entity beans.

pool-idle-timeout-in-seconds

600

(optional) Specifies the maximum time that a bean can remain
idle in the pool. After this amount of time, the pool can remove this
bean. A value of 0 specifies that idle beans can
remain in the pool indefinitely.

Applies to stateless session beans and entity beans.

cache-idle-timeout-in-seconds

600

(optional) Specifies the maximum time that a bean can remain
idle in the cache. After this amount of time, the container can passivate
this bean. A value of 0 specifies that beans never
become candidates for passivation.

Applies to stateful session beans and entity beans.

removal-timeout-in-seconds

5400

(optional) Specifies the amount of time that a bean can remain
passivated before it is removed from the session store. A value of 0 specifies that the container does not remove inactive
beans automatically.

If removal-timeout-in-seconds is
less than or equal to cache-idle-timeout-in-seconds, beans are removed immediately without being passivated.

The session-store attribute of the server element determines the location of
the session store.