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
Objects for communication with redirector

By default, both types of objects are set to be placed in the Explicit heap. However, if you change the settings in the JavaVM option described in 8.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 8-16 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.
ejbserver.server.eheap.ajp13.enabled	Specify whether to place the objects for communication with the redirector in the Explicit heap.

For details on the parameters to be specified, see 4.14 Parameters that you can specify on the logical J2EE server 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 8-17 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)

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

The placement destination of the objects for communication with the redirector varies according to the values of the prerequisite JavaVM options and the ejbserver.server.eheap.ajp13.enabled property. The following table describes the placement destination of the objects for communication with the redirector.

Table 8-18 Placement destination of the objects for communication with the redirector according to the values of the JavaVM options and the ejbserver.server.eheap.ajp13.enabled property

JavaVM option	Value of ejbserver.server.eheap.ajp13.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)

(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>
<param>
<param-name>ejbserver.server.eheap.ajp13.enabled</param-name>
<param-value>true</param-value>
</param>
:
</configuration>

8.13.4 Settings for using the function on the J2EE server

(1) How to set

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