You can use the resource adapters conforming to the Connector 1.0 specifications or Connector 1.5 specifications with Application Server.
This subsection describes the resource adapters conforming to the respective specifications. This subsection also describes the differences in the DD schema of resource adapters.
You can use the following resource adapters with Application Server:
You can use the functionality supported by the Connector 1.0 specifications with these resource adapters.
Note that with DB Connector and DB Connector for Cosminexus RM, you can use the functionality added with Application Server in addition to the functionality supported by the Connector 1.0 specifications. For details on the available functionality, see 3.3.4 Resource adapter functionality.
You can use the resource adapters conforming to the Connector 1.5 specifications with Application Server. From the contracts in the Connector 1.5 specifications, the functionality corresponding to the following contracts can be used with Application Server:
Application Server provides the following resource adapters:
For details on the available functionality, see 3.3.4 Resource adapter functionality.
Also, for resource adapters conforming to the Connector 1.5 specifications, see 3.13.1 Resource adapters used for connection with other resources.
This section describes the differences in the DD schema of the resource adapters conforming to the Connector 1.0 specifications and resource adapters conforming to the Connector 1.5 specifications. The DD for a resource adapter is ra.xml.
The following table describes the main changes from the schema defined in the Connector 1.0 specifications to the schema defined in the Connector 1.5 specifications. For the changes other than those described in this table, see the Connector 1.5 specifications.
Table 3-4 Main changes from the schema defined in the Connector 1.0 specifications to the schema defined in the Connector 1.5 specifications
Content changed in the Connector 1.5 specifications | DD content in the Connector 1.5 specifications |
---|---|
Specification of the implementation class of the javax.resource.spi.ResourceAdapter interface | <connector>-<resourceadapter>-<resourceadapter-class> tag <connector>-<resourceadapter>-<config-property> tag |
Specification of the Outbound resource adapter | <connector>-<resourceadapter>-<outbound-resourceadapter> tag |
Specification of the Inbound resource adapter | <connector>-<resourceadapter>-<inbound-resourceadapter> tag |
Specification of adminobject | <connector>-<resourceadapter>-<adminobject> tag |
An overview of the content changed in the Connector 1.5 specifications is as follows:
The resource adapters that define properties differ depending on the information such as the types of resources to be connected to and the transactions to be used. This section describes the resource adapters used in the following cases:
The files for DB Connectors differ depending on the database type to be connected to and the transaction type to be used. The following table describes the DB Connector types.
Table 3-5 DB Connector types
RAR file name | Explanation |
---|---|
DBConnector_HiRDB_Type4_CP.rar | Select this file when you use HiRDB Type4 JDBC Driver to connect to HiRDB or XDM/RD E2 without using a local transaction or transaction management. |
DBConnector_HiRDB_Type4_XA.rar | Select this file when you use HiRDB Type4 JDBC Driver to connect to HiRDB using a global transaction. |
DBConnector_Oracle_CP.rar | Select this file when you use Oracle JDBC Thin Driver to connect to Oracle without using a local transaction or transaction management. |
DBConnector_Oracle_XA.rar | Select this file when you use Oracle JDBC Thin Driver to connect to Oracle using a global transaction. |
DBConnector_SQLServer_CP.rar | Select this file when you use SQL Server JDBC Driver to connect to SQL Server (only in Windows) without using a local transaction or transaction management. |
DBConnector_CP_ClusterPool_Root.rar | This is the root resource adapter of the connection pool clustering functionality. Select this file when a member resource adapter belonging to the root resource adapter connects to Oracle without using a local transaction or transaction management. |
DBConnector_Oracle_CP_ClusterPool_Member.rar | This is the member resource adapter of the connection pool clustering functionality. Select this file when you use Oracle JDBC Thin Driver to connect to Oracle without using a local transaction or transaction management. Note that you cannot specify this file in the resource references of J2EE applications. |
Note: When you prepare a new DB Connector RAR file, you can use the template files of the HITACHI Connector Property files provided with Application Server to define properties. The template files of the HITACHI Connector Property files are provided for all the DB Connector RAR files. For details on the provided template files, see 4.1.14 Template files of the HITACHI Connector Property files in the uCosminexus Application Server Application and Resource Definition Reference Guide.
When you connect to a database by integrating the system with Cosminexus RM, you must import both, resource adapter for the Cosminexus RM integration (DB Connector for Cosminexus RM) and the resource adapter provided with Cosminexus RM. For details on the resource adapter provided with Cosminexus RM, see the manual uCosminexus Application Server Reliable Messaging.
The files for DB Connector for Cosminexus RM differ depending on the transaction type to be used and the database type to be connected to. The following table describes the types of DB Connector for Cosminexus RM.
Table 3-6 DB Connector for Cosminexus RM types
RAR file name | Explanation |
---|---|
DBConnector_HiRDB_Type4_CP_Cosminexus_RM.rar | Select this file when you use HiRDB Type4 JDBC Driver to connect to HiRDB without using a local transaction or transaction management. |
DBConnector_HiRDB_Type4_XA_Cosminexus_RM.rar | Select this file when you use HiRDB Type4 JDBC Driver to connect to HiRDB using a global transaction. |
DBConnector_Oracle_CP_Cosminexus_RM.rar | Select this file when you use Oracle JDBC Thin Driver to connect to Oracle without using a local transaction or transaction management. |
DBConnector_Oracle_XA_Cosminexus_RM.rar | Select this file when you use Oracle JDBC Thin Driver to connect to Oracle using a global transaction. |
Note: When you prepare a new RAR file for DB Connector for Cosminexus RM, you can use the template files of the HITACHI Connector Property files provided with Application Server to define properties. The template files of the HITACHI Connector Property files are provided for all the DB Connector RAR files. For details on the provided template files, see 4.1.14 Template files of the HITACHI Connector Property files in the uCosminexus Application Server Application and Resource Definition Reference Guide.
To connect to OpenTP1 SPP and Outbound, you use the resource adapters uCosminexus TP1 Connector and TP1/Client/J. For details, see the uCosminexus TP1 Connector documentation and the OpenTP1 Version 7 TP1/Client User's Guide TP1/Client/J.
To connect from OpenTP1 SUP using Inbound, you use the TP1 inbound adapter. For details, see 4. Invoking Application Server from OpenTP1 (TP1 Inbound Integrated Function).
Also, to connect to CJMSP Broker when you use Cosminexus JMS Provider, you use the CJMSP resource adapter. For details, see 7. Cosminexus JMS Provider.
Note that to use a new RAR file for the TP1 inbound adapter or the CJMSP resource adapter, you can use the template file provided with Application Server to define properties. For details, see 4.1.14 Template files of the HITACHI Connector Property files in the uCosminexus Application Server Application and Resource Definition Reference Guide.
To connect to TP1/Message Queue, use the resource adapter TP1/Message Queue - Access. For details, see the OpenTP1 Version 7 TP1/Message Queue - Access User Guide.
With Application Server, you can also connect to any resource by using the resource adapters conforming to the Connector 1.0 specifications or Connector 1.5 specifications. To use these resource adapters, see the documentation for resource adapters.