uCosminexus Application Server, Common Container Functionality Guide

[Contents][Glossary][Index][Back][Next]

2.8.3 Settings for using the caching functionality

This subsection describes the settings for using the caching functionality. The locations for the settings differ in the J2EE applications and in the EJB client applications.

Organization of this subsection
(1) When the caching functionality is used in the J2EE applications
(2) When the caching functionality is used in the EJB client applications

(1) When the caching functionality is used in the J2EE applications

You specify the definition for using the caching functionality in the J2EE applications in the <configuration> tag of the logical J2EE server (j2ee-server) in the Easy Setup definition file. The following table describes the definitions for using the caching functionality specified in the Easy Setup definition file.

Table 2-35 Definitions for using the caching functionality

Specified parameters Settings
ejbserver.jndi.cache Specify whether to enable caching in naming.
ejbserver.jndi.cache.interval Specify the interval (unit: seconds) for clearing the cache when caching is performed in naming.
ejbserver.jndi.cache.interval.clear.option Determine the operations (cache-clearing range) for the cache area in naming after the lapse of the interval.

The following is an example of settings when the cache is cleared periodically (when the physical tier is defined).

Example:
<configuration>
 <logical-server-type>j2ee-server</logical-server-type>
 <param>
 <param-name>ejbserver.jndi.cache</param-name>
 <param-value>on</param-value>
 </param>
 <param>
 <param-name>ejbserver.jndi.cache.interval</param-name>
 <param-value>60</param-value>
 </param>
 <param>
 <param-name>ejbserver.jndi.cache.interval.clear.option</param-name>
 <param-value>check</param-value>
 </param>
 ... 
</configuration>

(2) When the caching functionality is used in the EJB client applications

You specify the settings as properties when the EJB client application starts.

The method of setting the EJB client application properties differs depending on the commands used for starting the EJB client application.

The following is an example of settings when the cache is cleared periodically.

Example of system property settings for an EJB client
 ... 
# Cache settings
ejbserver.jndi.cache=on
ejbserver.jndi.cache.interval=60
ejbserver.jndi.cache.interval.clear.option=check