2.2.1 Details of the HITACHI Application Integrated property

This subsection describes the details of the HITACHI Application Integrated property of cosminexus.xml with reference to each tag.

Note that the tag details are described in the order mentioned in 2.1 Specifications of the Cosminexus application property file (cosminexus.xml).

Organization of this subsection
(1) <security-prop>
(2) <security-method>
(3) <default-security-role>
(4) <start-order>
(5) <scheduling-unit>
(6) <scheduling>
(7) <queue-name>
(8) <parallel-count>
(9) <queue-length>
(10) <managed-by-ctm>
(11) <ref-libraries>
(12) <classpath>
(13) <method-observation-recovery-mode>
(14) <ejb-async-props>
(15) <min-thread-pool-size>
(16) <max-thread-pool-size>
(17) <thread-pool-keep-alive>
(18) <result-timeout-value>

(1) <security-prop>

Description
This tag specifies the management method for the security of cosminexus-app.
Specifiable value
None.
Dependency on other tags
None.
Tag omission
You can omit this tag.
Value omission
You cannot omit the value of this tag.

(2) <security-method>

Description
This tag specifies whether to enable the security settings.
Specifiable value
  • disable_methods_without_roles
    You cannot execute a method to which no security role is assigned.
  • map_methods_without_roles
    The default security role specified in default-security-role is assigned to the method to which no security role is assigned.
  • no_security_for_methods_without_roles
    Any user can execute a method to which no security role is assigned.
    The execution of methods to which a security role is assigned is restricted depending on the security role.
  • no_security_for_all_methods
    Any user can execute all the methods, including the methods to which a security role is assigned and the methods to which no security role is assigned.
Dependency on other tags
None.
Tag omission
You cannot omit the value of this tag.
Value omission
You cannot omit the value of this tag.

(3) <default-security-role>

Description
This tag specifies the default security role when map_methods_without_roles is specified in <security-method>.
The set value of this tag is ignored when a value other than map_methods_without_roles is specified in <security-method>.
Specifiable value
There are no limitations for the input value.
Dependency on other tags
None.
Tag omission
You can omit this tag.
Value omission
You cannot omit the value of this tag.

(4) <start-order>

Description
This tag specifies the order of starting and stopping the J2EE applications.
When starting an application, the start processing is executed in the ascending order and when terminating the application, the stop processing is executed in the descending order.
Specifiable value
Specify an integer value from 0 to 2147483647.
Dependency on other tags
None.
Tag omission
You can omit this tag.
Value omission
You cannot omit the value of this tag.

(5) <scheduling-unit>

Description
This tag specifies the deployment model of the queue.
Specifiable value
You can specify the following character strings:
  • Application
    This value is specified when the queue is to be deployed for each application.
  • Bean
    This value is specified when the queue is to be deployed for each Bean.
Dependency on other tags
None.
Tag omission
You can omit this tag.
Value omission
You cannot omit the value of this tag.

(6) <scheduling>

Description
This tag sets up the information related to CTM integration.
Specifiable value
None.
Dependency on other tags
None.
Tag omission
You can omit this tag.
Value omission
You can omit this tag.

(7) <queue-name>

Description
This tag specifies the queue name for which scheduling is to be executed.
Specifiable value
You can specify 1 to 63 alphanumeric characters and underscores (_).
Dependency on other tags
None.
Tag omission
You can omit this tag.
Value omission
You cannot omit the value of this tag.

(8) <parallel-count>

Description
This tag specifies the number of threads prepared by the CTM scheduler to invoke an application.
Specifiable value
Specify an integer value from 1 to 127.
Dependency on other tags
None.
Tag omission
You can omit this tag.
Value omission
You cannot omit the value of this tag.

(9) <queue-length>

Description
This tag specifies the length of a queue.
Specifiable value
Specify an integer value from 1 to 32767.
Dependency on other tags
None.
Tag omission
You can omit this tag.
Value omission
You cannot omit the value of this tag.

(10) <managed-by-ctm>

Description
This tag specifies whether to integrate CTM.
Specifiable value
  • true
    Integrate CTM.
  • false
    Do not integrate CTM.
Dependency on other tags
None.
Tag omission
You can omit this tag.
Value omission
You cannot omit the value of this tag.

(11) <ref-libraries>

Description
This tag specifies the library JAR to be referenced.
Specifiable value
None.
Dependency on other tags
None.
Tag omission
You can omit this tag.
Value omission
You can omit this tag.

(12) <classpath>

Description
This tag specifies the class path of the referenced library.
Specifiable value
There are no limitations for the input value.
Dependency on other tags
<max-thread-pool-size>
Tag omission
You cannot omit the value of this tag.
Value omission
You cannot omit the value of this tag.

(13) <method-observation-recovery-mode>

Description
This tag specifies the recovery mode of the method cancellation functionality.
Specifiable value
You can specify the following character strings:
  • thread
Dependency on other tags
None.
Tag omission
You can omit this tag.
Value omission
You cannot omit the value of this tag.

(14) <ejb-async-props>

Description
This tag sets up the information for invoking the Session Bean asynchronously.
Specifiable value
None.
Dependency on other tags
None.
Tag omission
You can omit this tag.
Value omission
You can omit this tag.

(15) <min-thread-pool-size>

Description
This tag specifies the minimum number of threads executed concurrently in a thread pool.
Specifiable value
Specify an integer value from 1 to 2147483647.
Dependency on other tags
This tag depends on the <max-thread-pool-size> tag.
Tag omission
You can omit this tag.
Value omission
You cannot omit the value of this tag.

(16) <max-thread-pool-size>

Description
This tag specifies the maximum number of threads executed concurrently in a thread pool.
Specifiable value
Specify an integer value from 1 to 2147483647.
Dependency on other tags
This tag depends on the <min-thread-pool-size> tag.
Tag omission
You can omit this tag.
Value omission
You cannot omit the value of this tag.

(17) <thread-pool-keep-alive>

Description
This tag specifies the timeout value until the threads in the thread pool are released (unit: seconds).
Specifiable value
Specify an integer value from 1 to 2147483647.
Dependency on other tags
None.
Tag omission
You can omit this tag.
Value omission
You cannot omit the value of this tag.

(18) <result-timeout-value>

Description
Specifies the time (unit: minutes) for which the results of asynchronous invocation are stored. If 0 is specified, the results of asynchronous invocation are not released and are stored until the application terminates.
Specifiable value
Specify an integer value from 0 to 2147483647.
Dependency on other tags
None.
Tag omission
You can omit this tag.
Value omission
You cannot omit the value of this tag.