uCosminexus Application Server, Common Container Functionality Guide

[Contents][Glossary][Index][Back][Next]

3.3.9 Procedure for resource adapter settings (To include and use the resource adapter in the J2EE application)

Use the server management commands to set up the resource adapter. This subsection describes the procedure for resource adapter settings to include and use the resource adapter in the J2EE application.

Note that the method of setting up a resource adapter when the resource adapter is included and used in an application includes the following two methods:

This subsection describes each of the methods.

Note that the resource adapters included in a J2EE application are limited. For details on the resource adapters included in a J2EE application, see 3.3.3 How to use the resource adapters.

Organization of this subsection
(1) Method of importing the J2EE application containing the resource adapter into the J2EE server
(2) Method of adding the resource adapter in an imported J2EE application

(1) Method of importing the J2EE application containing the resource adapter into the J2EE server

In this method, you create a J2EE application including the RAR file of the resource adapter, and then import that EAR file into the J2EE server. The following figure gives an overview of this method.

Figure 3-6 Overview of the method of importing the J2EE application containing the resource adapter into the J2EE server

[Figure]

The following figure shows the procedure for importing a J2EE application containing a resource adapter into the J2EE server.

Figure 3-7 Procedure for importing a J2EE application containing a resource adapter into the J2EE server

[Figure]

A description of points 1 to 4 in the figure is as follows:

  1. Use the server management commands to add the RAR file of the resource adapter into the EAR file of the J2EE application.
    Use the cjaddapp command to add the RAR file of the resource adapter into the EAR file of the J2EE application.
    The resource adapters included in the EAR file are limited. For details on the resource adapters included in the EAR file, see 3.3.3 How to use the resource adapters.
  2. Use the server management commands to import the J2EE application.
    Use the cjimportapp command to import the J2EE application.
  3. Use the server management commands to define the resource adapter properties.
    Use the cjgetappprop command to obtain the HITACHI Connector Property file, edit the file, and then use the cjsetappprop command to apply the edited content.
    For details on the resource adapter properties specified for the functionality to be used, see the following locations:
  4. Use the server management commands to implement the resource adapter connection test.
    Use the cjtestres command to implement the resource adapter connection test. For details on the content to be verified in the connection test for each resource, see 3.18 Connection test for resources.

(2) Method of adding the resource adapter in an imported J2EE application

In this method, you import the resource adapter (RAR file) into the J2EE server and then add the resource adapter in a J2EE application that is already imported into the same J2EE server. The following figure gives an overview of this method.

Figure 3-8 Overview of the method of adding the resource adapter in an imported J2EE application

[Figure]

The following figure shows the procedure for adding the resource adapter into an imported J2EE application.

Figure 3-9 Procedure for adding the resource adapter into an imported J2EE application

[Figure]

A description of points 1 to 5 in the figure is as follows:

  1. Use the server management commands to import the J2EE application.
    Use the cjimportapp command to import the J2EE application.
  2. Use the server management commands to import the resource adapter.
    Use the cjimportres command to import the resource adapter.
  3. Use the server management commands to add the resource adapter into the J2EE application.
    Use the cjaddapp command to add the resource adapter into the J2EE application.
  4. Use the server management commands to define the resource adapter properties.
    Use the cjgetappprop command to obtain the HITACHI Connector Property file, edit the file, and then use the cjsetappprop command to apply the edited content.
    For details on the resource adapter properties specified for the functionality to be used, see the following locations:
  5. Use the server management commands to implement the resource adapter connection test.
    Use the cjtestres command to implement the resource adapter connection test. For details on the content to be verified in the connection test for each resource, see
    3.18 Connection test for resources.

[Contents][Back][Next]

[Trademarks]

All Rights Reserved. Copyright (C) 2013, Hitachi, Ltd.