Overview of the property settings of J2EE applications

The J2EE application property settings imply defining the attributes and operations of the imported J2EE applications. This section explains the following:

Property settings and attribute files for J2EE applications
Property settings for Enterprise Beans
Property settings for servlets and JSPs
Property settings for J2EE applications (common)

Note

You cannot change the items specified in annotations. Furthermore, to change application properties that contain cosminexus.xml, there are setup methods that use the server management commands and MyEclipce. If you use the redeploy functionality after changing the definition information within cosminexus.xml by using server management commands, the information changed by the server management commands is lost.

For details on changing the application properties that contain cosminexus.xml by using MyEclipce, see 5.3.2 How to operate cosminexus.xml editor in the uCosminexus Application Server Application Development Guide. Also, for details on the operations of applications that contain cosminexus.xml, see 11.3.6 Running an application that includes cosminexus.xml in the uCosminexus Application Server Common Container Functionality Guide.

For details on the property settings and property files for resource adapters included in J2EE applications, see 5.4 Defining resource adapter properties.

Organization of this section: (1) Property settings and attribute files for J2EE applications; (2) Property settings of an Enterprise Bean; (3) Property settings for servlets and JSPs; (4) Property settings for J2EE applications (common)

(1) Property settings and attribute files for J2EE applications

For an overview about the procedures for setting the properties, see 3.5 Property settings using the property file.

You can use the following attribute files to set the J2EE application properties:

Specific attribute files
Set the properties for each specific attribute file of the components that form the J2EE applications.
HITACHI Application Integrated Property File
Compile the contents of specific attribute files and set the properties.

In the J2EE application property settings, you can use specific attribute files and HITACHI Application Integrated Property Files individually as well as collectively.

This chapter mainly explains how to set the properties by using the specific attribute files. For details on setting the properties by using the HITACHI Application Integrated Property File, see 9.2 Property settings using the HITACHI Application Integrated Property File.

(2) Property settings of an Enterprise Bean

When you create and customize J2EE applications containing Enterprise Beans, specify the settings below when required.

The following table describes the property settings for the Enterprise Beans:

Table 9-1 Items to be edited in the Enterprise Bean properties

Items to be edited		Contents	Mandatory	Reference
Defining Enterprise Bean references		Define the references to the following Enterprise Beans forming a J2EE application: Session Bean Entity Bean Message-driven Bean	O	Section 9.3
	Defining other Enterprise Bean references	Define the references to the other Enterprise Beans.	O	Subsection 9.3.1
	Defining mail configuration references	Define the references to the mail servers.	O	Subsection 9.3.2
	Defining resource adapter references	Define the references to the resource adapters.	O	Subsection 9.3.3
	Defining resource environment references	Define the references to the resource environment.	O	Subsection 9.3.4
Defining message references of Message-driven Beans		Map the actual Connection Factory and Destination wherever the Connection Factory and Destination of Message-driven Bean are being referenced.	O	Section 9.4
Defining transaction attributes		Define the transaction attributes.	O	Section 9.5
Defining CMP of an Entity Bean		Define the CMP for delegating the persistence management of Entity Bean to a container.	O	Section 9.6
	CMP settings	Define the settings for delegating the persistence management of an Entity Bean to a container, by using a single primary key. Define the settings for delegating the persistence management of an Entity Bean to a container, by using the compound primary key.	O	Subsection 9.6.1
	Mapping CMP1.x and the database	Map the CMP1.x Entity Bean field to a table in the database.	O	Subsection 9.6.2
	Mapping CMP2.x and the database	Map the CMP2.x Entity Bean field to a table in the database.	O	Subsection 9.6.3
Defining the runtime attributes of Enterprise Beans		Set the runtime operations of the Enterprise Beans. Specify the settings when required.	Y	Section 9.10
	Setting the runtime properties for Stateful Session Beans	Set the properties for runtime operations of Stateful Session Beans.	Y	Subsection 9.10.1
	Setting the runtime properties for Stateless Session Beans	Set the properties for runtime operations of Stateless Session Beans.	Y	Subsection 9.10.2
	Setting the runtime properties for Entity Beans	Set the properties for runtime operations of Entity Beans.	Y	Subsection 9.10.3
	Setting the runtime properties for Message-driven Beans	Set the properties for runtime operations of Message-driven Beans.	Y	Subsection 9.10.4
Interceptor settings		Define the settings for using the interceptor.	O	Section 9.17

Legend:: Y: Mandatory. Ensure that the settings are specified when customizing the J2EE applications that contain the corresponding Enterprise Beans.; O: Optional. Specify the settings based on the J2EE applications.

(3) Property settings for servlets and JSPs

When you create a J2EE application containing the servlets and JSPs, specify the settings when required.

The following table describes the property settings of servlets and JSPs:

Table 9-2 Items to be edited in servlet and JSP properties

Items to be edited		Contents	Mandatory	Reference
Defining servlet and JSP references		Define the references (resource references) to Enterprise Beans, security role, and the resources (database or mail server).	O	Section 9.7
	Defining Enterprise Bean references	Define the references to the Enterprise Beans.	O	Subsection 9.7.1
	Defining mail configuration references	Define the references to the mail servers.	O	Subsection 9.7.2
	Defining resource adapter references	Define the references to the resource adapters.	O	Subsection 9.7.3
	Defining resource environment references	Define the references to the resource environment.	O	Subsection 9.7.4
Defining servlet and JSP mapping		Define the mapping of servlets and JSPs.	O	Section 9.8
Filter settings		Add the filter and define the mapping.	O	Section 9.9
	Adding a filter	Add the filter.	O	Subsection 9.9.1
	Defining a filter mapping	Define the mapping to the filter.	O	Subsection 9.9.2
	Deleting a filter	Delete the filter.	O	Subsection 9.9.3
Defining the runtime attributes of servlets and JSPs		Define the runtime attributes of servlets and JSPs.	O	Section 9.11
	Defining the context root of a J2EE application	Set the context root of the J2EE applications.	Y	Subsection 9.11.1
	Defining the control of the number of threads executed concurrently for each Web application	In the Web container, specify whether to control the number of threads executed concurrently for each Web application and the thread count.	O	Subsection 9.11.2
	Defining the control of the number of threads executed concurrently for each URL group	For each URL group, specify the definition for controlling the number of threads executed concurrently.	O	Subsection 9.11.3
	Defining and monitoring the number of requests pending for each URL group	For each URL group, specify the definition for monitoring the number of pending requests.	O	Subsection 9.11.4
Setting the default character encoding		Set the default character encoding for Web applications.	O	Section 9.12
Error notification settings for servlets and JSPs		Specify the settings for reporting an error that occurs in the servlets or JSPs to the J2EE applications.	O	Section 9.16

Legend:: Y: Mandatory. Ensure that the settings are specified when customizing the J2EE applications that contain servlets and JSPs.; O: Optional. Specify the settings based on the J2EE applications.

(4) Property settings for J2EE applications (common)

Specify the following settings when required, regardless of the configuration of the J2EE applications:

Table 9-3 Items to be edited in J2EE application (common) properties

Items to be edited		Contents	Mandatory	Editing reference location for specific properties file
Items to be edited		Contents	Mandatory	Reference manual	Reference location
Referencing and changing the names registered in JNDI namespace		Reference a name registered in the JNDI namespace of the J2EE application and give an optional name if required.	O	This manual	Section 9.13
	Referencing the J2EE application names	Specify the settings to reference a J2EE application name.	O	This manual	Subsection 9.13.1
	Referencing and changing the Enterprise Bean name	Specify the settings to reference and change an Enterprise Bean name.	O	This manual	Subsection 9.13.2
CTM scheduling		Specify the settings to use CTM for queue scheduling, and the scheduling method.	O	This manual	Subsection 9.14
	Scheduling the J2EE applications	Specify the settings related to linking each J2EE application with CTM.	O	This manual	Subsection 9.14.1
	Scheduling the Stateless Session Beans	Specify the settings for scheduling Stateless Session Beans.	O	This manual	Subsection 9.14.2
Setting invocation order		Set the order for invoking the J2EE applications and the order for invoking an Enterprise Bean (EJB-JAR) and servlets or JSPs (WAR) included in the J2EE applications.	O	This manual	Section 9.15
	Setting the invocation order for J2EE applications	Set the order for invoking the J2EE applications.	O	This manual	Subsection 9.15.1
	Setting the invocation order for Enterprise Beans	Set the order for invoking the Enterprise Beans (EJB-JAR) included in the J2EE application.	O	This manual	Subsection 9.15.2
	Setting the invocation order for servlets and JSPs	Set the order for invoking servlets and JSPs (WAR) included in the J2EE applications.	O	This manual	Subsection 9.15.3
Setting security roles		This setting is necessary for performing user management with security roles. You can register and map the users and roles.	O	Security Management Guide	9.2
	Setting users	Register a user. You can also map the user to a role.	O	Security Management Guide	9.2.1
	Setting roles	Register a role. You can also map the role to a user.	O	Security Management Guide	9.2.2
Defining security role references		Define the references to the security role.	O	Security Management Guide	9.3
	Defining security role references of Enterprise Beans	Map the security role that is actually managed by the J2EE server, wherever the security role is referenced.	O	Security Management Guide	9.3.1
	Defining security role references of servlets and JSPs	Define the references to the security role.	O	Security Management Guide	9.3.2
Defining security (method permission)		Define the method permission for setting the access permission based on the security role. Define the method permission for setting the access permission for all users.	O	Security Management Guide	9.4
Defining security (security identity)		Set UseCallerIdentity as the security identity that forms the security information. Set Run as as the security identity that forms the security information.	O	Security Management Guide	9.5
	Security identity of the Enterprise Beans	Map the user ID that is actually managed by the J2EE server, to the security identity information referenced in the J2EE application.	O	Security Management Guide	9.5.1
	Security identity of servlets and JSPs	Define the security identity.	O	Security Management Guide	9.5.2

Legend:: O: Optional. Specify the settings based on the J2EE applications.

#: uCosminexus Application Server has been omitted from the manual names described in the Reference manual column.

9.1 Overview of the property settings of J2EE applications

(1) Property settings and attribute files for J2EE applications

(2) Property settings of an Enterprise Bean

(3) Property settings for servlets and JSPs

(4) Property settings for J2EE applications (common)