1.2.2 Setup for resource adapters
This subsection describes the setup of resource adapters deployed and used as J2EE resource adapters.
- Organization of this subsection
(1) Types of resource adapters
The types of resource adapters deployed and used as the J2EE resource adapters are as follows:
-
DB Connector
Use this resource adapter when you use the JDBC interface for connecting to a database.
-
DB Connector for Cosminexus RM and Cosminexus RM
Use this resource adapter when you use JMS interface for connecting to a database.
For DB Connector for Cosminexus RM, see 2.7 Functions of DB Connector for Reliable Messaging, and for the management of Cosminexus RM, see 2.3 Managing messages in the manual Cosminexus Reliable Messaging.
-
uCosminexus TP1 Connector
Use this resource adapter for connecting to SPP of OpenTP1.
-
TP1/Message Queue - Access
Use this resource adapter for connecting to TP1/Message Queue.
-
Other resource adapters
You can use resource adapters compliant with Connector 1.5 for connecting to the optional resources.
(2) Flow of resource adapter management
The basic flow of resource adapter management is as follows:
-
Importing the resource adapters
-
Defining the resource adapter properties
-
Deploying the resource adapters
-
Testing the J2EE resource adapters for connectivity
-
Starting and stopping the J2EE resource adapters
-
Exporting the J2EE resource adapters
The description of above procedures is as follows:
-
Importing the resource adapters
You import the resource adapter.
-
Defining the resource adapter properties
You define the information required for connecting to a database.
-
Deploying the resource adapters
You deploy the imported resource adapter as a J2EE resource adapter. You can use the resource adapter deployed as the J2EE resource adapter from all the J2EE applications running on the J2EE server.
-
Testing the J2EE resource adapters for connectivity
You execute the connectivity test and confirm that the J2EE resource adapters are running correctly.
-
Starting and stopping the J2EE resource adapters
You start the J2EE resource adapters for which the setup is complete. Furthermore, stop the J2EE resource adapters according to the operations.
-
Exporting the J2EE resource adapters
You export the J2EE resource adapters according to the operations.
To connect to a 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 J2EE applications. For an overview of customization of J2EE applications, see 1.3 Managing J2EE applications.
(3) Setup of resource adapters
The following table describes the functions of the setup to be used in the resource adapter management.
Operations in J2EE resource management |
Functions |
Commands |
---|---|---|
Import the resource adapters |
Imports the resource adapters into the J2EE server. |
cjimportres (-type rar specified) |
Define the resource adapter properties |
Obtains the pre-deployment resource adapter properties and generates a property file. |
cjgetresprop (-type rar specified) |
Changes the values of the pre-deployment resource adapter properties to the values specified in the property file. |
cjsetresprop (-type rar specified) |
|
Obtains the properties of the deployed J2EE resource adapters and generates the property file. |
cjgetrarprop |
|
Changes the property values of the deployed J2EE resource adapters to the values specified in the property file. |
cjsetrarprop |
|
Deploy the resource adapters |
Deploys the resource adapter. |
cjdeployrar |
Test the J2EE resource adapters for connectivity |
Executes the connectivity test for the J2EE resource adapter. |
cjtestres (-type rar specified) |
Start and stop the J2EE resource adapters |
Starts the J2EE resource adapter. |
cjstartrar |
Stops the J2EE resource adapter that is running. |
cjstoprar |
|
Export the J2EE resource adapters |
Exports the resource adapter residing on the J2EE server. |
cjexportrar |
Display the list of resources |
Displays the list of the imported resource adapters. |
cjlistres (-type rar specified) |
Displays the list of the J2EE resource adapters. |
cjlistrar |
|
Delete the resources |
Deletes the resource adapters. |
cjdeleteres (-type rar specified) |
Un-deploys the J2EE resource adapters. |
cjundeployrar |
|
Other operations |
Displays the status of the resource adapter connection pool. |
cjlistpool |
Deletes connections of the resource adapter connection pool. |
cjclearpool |
|
Copies the resource adapter properties. |
cjcopyres (-type rar specified) |