9.14.2 Scheduling the Stateless Session Beans
For using CTM to schedule the Stateless Session Beans included in a J2EE application that is to be scheduled using CTM, specify the settings for scheduling Stateless Session Beans.
You can schedule only Stateless Session Beans for which the remote home interface is implemented.
To use the scheduling function, set up the runtime properties of Stateless Session Beans. For details on setting up the runtime properties of Stateless Session Beans, see 9.10.2 Setting the runtime properties for Stateless Session Beans.
You also specify the settings for integrating with CTM in the application properties.
You must set up both the application properties and Session Bean Properties. Hitachi recommends that you use the HITACHI Application Integrated Property File to specify the settings.
- Organization of this subsection
(1) Attribute files to be edited
HITACHI Application Integrated Property File
(2) Acquiring the attribute files to be edited and setting the attributes
-
Acquiring the attribute files
You execute the following command to acquire the HITACHI Application Integrated Property File:
- Execution format
cjgetappprop [server-name] [-nameserver provider-URL] -name J2EE-application-name -type all -c path-of-the-hitachi-application-integrated-property-file
- Example of execution
cjgetappprop MyServer -name adder -type all -c C:\home\Adder.xml
-
Setting the attributes
You execute the following command to apply the values of the HITACHI Application Integrated Property File:
- Execution format
cjsetappprop [server-name] [-nameserver provider-URL] -name J2EE-application-name -type all -c path-of-the-hitachi-application-integrated-property-file
- Example of execution
cjsetappprop MyServer -name adder -type all -c C:\home\Adder.xml
(3) Attribute settings to be edited
The attribute settings to be edited are as follows:
-
Application properties
-
Session Bean attributes
The individual settings are as follows:
(a) Application properties
The following table describes the settings for integrating Stateless Session Beans with CTM:
|
Items |
Mandatory |
Corresponding tags |
|---|---|---|
|
Presence of CTM integration |
Y |
<managed-by-ctm> |
|
Queue deployment model |
Y |
<scheduling-unit> |
- Legend:
-
Y: Mandatory
For details on the property settings, see 3.2.1 Specifications of the HITACHI Application Property file in the uCosminexus Application Server Application and Resource Definition Reference Guide.
(b) Session Bean attribute file
The following table describes the runtime attribute settings (<session-runtime>) for integrating Stateless Session Beans with CTM:
|
Items |
Mandatory |
Corresponding tags |
|---|---|---|
|
Settings for scheduling |
Y |
<enable-scheduling> |
|
Queue name |
Y |
<scheduling> - <queue-name> |
|
Number of threads |
Y |
<scheduling> - <parallel-count> |
|
Queue length |
O |
<scheduling> - <queue-length> |
- Legend:
-
Y: Mandatory
O: Optional
For details on the property settings, see 3.4.1 Specifications of the HITACHI Session Bean Property file in the uCosminexus Application Server Application and Resource Definition Reference Guide.
(4) Notes
If you specify the settings using an application property file and Session Bean property file and without using the HITACHI Application Integrated Property File, you must specify the settings in the following order:
-
Execute the following command to apply the values of the <enable-scheduling> tag in the Session Bean property file:
cjsetappprop [server-name] [-nameserver provider-URL] -name J2EE-application-name -type ejb -resname display-name-of-EJB-JAR/ display-name-of-Stateless-Session-Bean -c path-of-the- Session Bean property file
-
Execute the following command to apply the values of the <managed-by-ctm> tag and <scheduling-unit> tag in the application property file:
cjsetappprop [server-name] [-nameserver provider-URL] -name J2EE-application-name -c path-of-the-HITACHI-application-property-file
-
Execute the following command to apply the values of the tags that exist under the <scheduling> tag of the Session Bean property file :
cjsetappprop [server-name] [-nameserver provider-URL] -name J2EE-application-name -type ejb -resname display-name-of-EJB-JAR/ display-name-of-Stateles-Session-Bean -c path-of-the-hitachi-The Session Bean property file