7.13.4 Settings for using the function on the J2EE server

This subsection describes settings for using the Explicit Memory Management functionality on the J2EE server. Set whether to target the following objects for placement in the Explicit heap, as the J2EE server properties:

Objects related to HTTP session

By default, objects are set to be placed in the Explicit heap. However, if you change the settings in the JavaVM option described in 7.13.1 Common settings for using the Explicit Memory Management functionality (setting JavaVM options) to not to use the Explicit Memory Management functionality, property settings of the J2EE server become invalid.

Organization of this subsection

(1) How to set
(2) An example of definitions in an Easy Setup definition file

(1) How to set

Perform the J2EE server settings in an Easy Setup definition file. Specify definitions of the Explicit Memory Management functionality in the <configuration> tag of the logical J2EE server (j2ee-server) in an Easy Setup definition file.

The following table describes definitions of the Explicit Memory Management functionality in an Easy Setup definition file.

Table 7‒15: Definitions of the Explicit Memory Management functionality in an Easy Setup definition file
Parameter to be specified	Setting details
`ejbserver.server.eheap.httpsession.enabled`	Specify whether to place the objects related to an HTTP session in the Explicit heap.

For details on the parameters to be specified, see 4.11 Parameters applicable to logical J2EE servers in the uCosminexus Application Server Definition Reference Guide.

Relationship between the JavaVM options and each property is described below.

Relationship between the JavaVM options and ejbserver.server.eheap.httpsession.enabled property

The placement destination of the objects related to an HTTP session varies according to the values specified in the prerequisite JavaVM options and the ejbserver.server.eheap.httpsession.enabled property. The following table describes the placement destination of objects related to an HTTP session.

Table 7‒16: Placement destination of the objects related to an HTTP session according to the values of the JavaVM options and the ejbserver.server.eheap.httpsession.enabled property
JavaVM option	Value of ejbserver.server.eheap.httpsession.enabled property	Placement destination
`-XX:+HitachiUseExplicitMemory`	`true`	Explicit heap area
	`false`	Java heap area
	Other value (such as an incorrect string or value not specified)	Explicit heap area
`-XX:-HitachiUseExplicitMemory`	`true`	Java heap area
	`false`
	Other value (such as an incorrect string or value not specified)
Not specified	`true`	Java heap area
	`false`
	Other value (such as an incorrect string or value not specified)

To Page Top

(2) An example of definitions in an Easy Setup definition file

An example of definitions in an Easy Setup definition file is given below.

An example of definitions in an Easy Setup definition file

<configuration>
  <logical-server-type>j2ee-server</logical-server-type>
  <param>
    <param-name>ejbserver.server.eheap.httpsession.enabled</param-name>
    <param-value>true</param-value>
  </param>
     :
 </configuration>

To Page Top