1.2.3 Setup for resource adapters included in J2EE applications

(1) Types of resource adapters

The types of resource adapters to be used by including in J2EE applications, and managed in the setup are as follows:

• DB Connector

  Use this resource adapter when you use the JDBC interface for connecting to the database.

  You cannot use this resource adapter in global transactions and the cluster configuration.

• uCosminexus TP1 Connector

  Use this resource adapter for connecting to SPP of OpenTP1.

  You cannot use this resource adapter in global transactions.

• Other resource adapters (resource adapters compliant with Connector 1.5)

  You can use resource adapters compliant with Connector 1.5 for connecting to optional resources.

  For details on the types of resource adapters that you can include and use in J2EE applications, see 3.3.2 Types of resource adapters in the uCosminexus Application Server Common Container Functionality Guide.

To Page Top

(2) Flow of the resource adapter management

The basic flow for managing resource adapters included in J2EE applications is as follows:

1. Adding resource adapters to J2EE applications

2. Defining the properties of resource adapters included in J2EE applications

3. Testing the resource adapters included in J2EE applications for connectivity

4. Starting and stopping J2EE applications

5. Exporting J2EE applications

The description of each procedure is as follows:

• Adding resource adapters to J2EE applications

  Use one of the following methods for adding resource adapters in J2EE applications:

  • In the application development environment, create a J2EE application with the added resource adapter. Import that J2EE application into a J2EE server.

  • Import a resource adapter into the J2EE server, and then add the resource adapter to the J2EE application.

• Defining the properties of resource adapters included in J2EE applications

  Define the information required for connecting to a database.

• Testing resource adapters included in J2EE applications for connectivity

  Execute the connectivity test and confirm that the resource adapters included in the J2EE application are running correctly.

• Starting and stopping J2EE applications

  Start the J2EE application including the resource adapters for which the setup is complete. When the J2EE application starts, the resource adapters included in the J2EE application will start.

  Furthermore, stop the J2EE application according to the operations. When the J2EE application stops, the resource adapters included in the J2EE application will stop.

• Exporting J2EE applications

  Include resource adapters in the J2EE application and export the application as required in the operations.

  To connect to the database, you must specify the database settings.

  Furthermore, if you want to use resource adapters, you must resolve the resource adapter references in J2EE applications. You resolve the resource adapter references by customizing the J2EE application. For an overview of customization of J2EE applications, see 1.3 Managing J2EE applications.

To Page Top

(3) Setup for resource adapters

The following table describes the functions of setup to be used in the management of resource adapters included in J2EE applications:

Table 1‒3: Setup used in the management of resource adapters included in J2EE applications

Operations in J2EE resource management	Functions	Commands
Import resource adapters	Imports resource adapters into the J2EE server.	cjimportres (-type rar specified)
Add resource adapters to J2EE applications	Adds resource adapters to the J2EE application.	cjaddapp (-type rar specified)
Import J2EE applications	Imports J2EE applications including resource adapters.	cjimportapp
Define the resource adapter properties	Obtains properties of the resource adapters included in the J2EE applications and generates a property file.	cjgetappprop (-type rar specified)
	Changes the property values of the resource adapters included in J2EE applications to the values specified in the property file.	cjsetappprop (-type rar specified)
Test resource adapters for connectivity	Executes the connectivity test for the resource adapters included in J2EE applications.	cjtestres (-name [Application name] -type rar specified)
Start and stop J2EE applications	Starts the J2EE application. When the J2EE application starts, all the resource adapters included in the J2EE application start. You cannot start the resource adapters individually.	cjstartapp
	Stops the running J2EE application. When the J2EE application stops, all the resource adapters included in the J2EE application will stop. You cannot stop the resource adapters individually.	cjstopapp
Export J2EE applications	Includes resource adapters in J2EE applications and exports the resource adapters.	cjexportapp
Delete resource adapters from J2EE applications	Deletes resource adapters of J2EE resources from the J2EE applications.	cjdeleteapp (-type rar specified)
Display the list of resources	Displays the list of resource adapters included in J2EE applications.	cjlistapp (-type rar specified)
Other operations	Displays the connection pool status of the resource adapters included in J2EE applications.	cjlistpool (-name [Application name] specified)
	Deletes connections from the connection pools of the resource adapters included in J2EE applications.	cjclearpool (-name [Application name] specified)

To Page Top