Hitachi

uCosminexus Application Server Application and Resource Definition Reference Guide


3.2.1 Specifications of the HITACHI Application Property file

The HITACHI Application Property file has the following DOCTYPE declaration:

<!DOCTYPE hitachi-application-property PUBLIC '-//Hitachi, Ltd.//DTD Application Property 8.0//EN' 'file:///Cosminexus-installation-directory/CC/admin/dtds/hitachi-application-property_8_0.dtd'>

The HITACHI Application Property file is an xml file containing the following tags.

Note that you can also use the earlier versions of the property file.

Tag name

Occurrence pattern

Explanation

<hitachi-application-property>

Once

Specifies the root tag.

<description>

Zero or once

Describes the application.

<icon>

Zero or once

Defines the icons of the J2EE application displayed on the Deploy tool.

<small-icon>

Zero or once

Specifies the file name for small icons (16 × 16).

<large-icon>

Zero or once

Specifies the file name for large icons (32 × 32).

<lookup-name>

Once

Specifies the name to be used when performing an EJB lookup from the client using 255 characters or less.

The name corresponds to Application-lookup-name in HITACHI_EJB/SERVERS/server-name/EJB/Application-lookup-name/EJB-lookup-name. This tag is only for reference. The lookup name is created automatically based on the application name.#1

<library-directory>

Zero or once

Displays the directory name in which the library JAR is saved. If a tag is not specified in the DD (application.xml) or if the DD (application.xml) is not included in the J2EE application, "lib" is displayed. For an empty tag, items immediately under the J2EE application root are assumed to be specified.#1

<security-prop>

Once

Specifies the security management methods of the Enterprise Bean.

<security-method>

Once

Specifies the security management methods.

Specify any one of the following:

disable_methods_without_roles

You cannot execute a method without a security role.

map_methods_without_roles

The default security role specified in default-security-role is assigned to the method without a security role.

no_security_for_methods_without_roles
  • Any user can execute a method to which a security role is not assigned.

  • The execution of a method to which a security role is assigned is restricted, depending on the security role.

no_security_for_all_methods

Any user can execute a method to which a security role is assigned or a method to which a security role is not assigned.

<default-security-role>

Zero or once

Specifies the default security role when map_methods_without_roles is specified in security-method. You can omit this tag when a security-method other than map_methods_without_roles is specified (This tag is ignored by cjsetappprop command even if set).

<start-order>

Zero or once

Specifies the order of starting and stopping the J2EE applications.

The start process is executed in the ascending order when the applications are started and the stop process is executed in the descending order when the applications are terminated.

0 start-order 2147483647

<scheduling-unit>

3.2.5 in the Application Server Expansion Guide

Zero or once

Specifies the deploy model for a queue.

Specify any one of the following:

Application

Deploys the queue for each application.

The default value is Application.

Bean

Deploys the queue for each Bean.

<scheduling>

3.4 in the Application Server Expansion Guide

Zero or once

Defines CTM integration.

Note that this tag is enabled only in the products that include Cosminexus Component Transaction Monitor in the component software. An error occurs if you specify this tag in other cases. For the available products, see 2.2.1 Relationship of products and component software in the manual uCosminexus Application Server Overview.

<queue-name>

3.2.5 in the Application Server Expansion Guide

Once

Specifies the name of the queue to be scheduled using a maximum of 63 alphanumeric characters (0 to 9, A to Z, and a to z) and underscores (_)). The default value for the queue name is the application name.#2

<parallel-count>

3.4 in the Application Server Expansion Guide

Once

Specifies the number of threads provided by CTM to invoke an application as a value from 1 to 127. The default value is 1.

An error will occur if the Bean is invoked through CTM and if the Maximum value is less than the parallel-count value.

<queue-length>

3.4 in the Application Server Expansion Guide

Zero or once

Specifies an integer value from 1 to 32767 for the length of the queue to be scheduled.

When sharing a queue, if the settings differ between the applications that share the queue and the Beans that share the queue, the length of the generated queue becomes valid.

<managed-by-ctm>

3.4 in the Application Server Expansion Guide

Once

Specifies whether to perform CTM integration.

Specify any one of the following:

true

Integrates with CTM.

false

Does not integrate with CTM.

The default value is false.

<ref-libraries>

Zero or once

Specifies the libraries to be referenced.

<classpath>

One or more times

Specifies the class path.

When ref-libraries is specified and the tag does not exist, an error will occur.

When you specify multiple tags, the tags will be set up in the runtime property in the specified order. For details on the class path specified in a class loader, see Appendix B.3 Class path specified in the class loader in the manual uCosminexus Application Server Common Container Functionality Guide.

<method-observation-recovery-mode>

Zero or once

Specifies the failure recovery mode of the J2EE application time monitoring functionality.

You can only specify thread here.

thread

Stops the thread.

--

--

--

#1

You must not change the tag name, add or delete the tag, or change the values of the tags output with the cjgetappprop command.

#2

If you specify Application for <scheduling-unit> and omit <queue-name>, make sure that a value that can be specified for <queue-name> is defined for <display-name> under <application> in the application.xml file.