4.3.3 Defining the resource adapter properties (for Connector 1.5)
Define the properties for connecting to the resource adapter compliant with Connector 1.5 specifications.
You can also define the properties of the resource adapter after deploying the J2EE resource adapter. Note that if you want to change the properties of a resource adapter that is already set, change the properties when the applicable resource adapter is not running.
For an overview of the property setup procedures, see 3.5 Property settings using the property file. The following subsections define the resource adapter properties:
- Organization of this subsection
(1) Property file to be edited
HITACHI Connector Property file
(2) Acquiring the property file to be edited and setting the properties
-
Acquiring the property file
Execute the following command to acquire the Connector property file of the resource adapter:
- Execution format
cjgetresprop [server-name] [-nameserver provider-URL] -type rar -resname display-name-of-the-resource-adapter -c path-of-Connector-attribute-file
- Example of execution
cjgetresprop MyServer -type rar -resname Rar1 -c AccountProp.xml
-
Setting the properties
Execute the following command to apply the values of the HITACHI Connector Property file:
- Execution format
cjsetresprop [server-name] [-nameserver provider-URL] -type rar -resname display-name-of-the-resource-adapter -c path-of-Connector-attribute-file
- Example of execution
cjsetresprop MyServer -type rar -resname Rar1 -c AccountProp.xml
- Important note
-
When defining the properties after deploying the resource adapter, use the cjgetrarprop command and cjsetrarprop command. For details on the cjgetrarprop command, see cjgetrarprop (get RAR file Property) in the uCosminexus Application Server Command Reference Guide. For details on the cjsetrarprop command, see cjsetrarprop (HITACHI Connector Property Settings) in the uCosminexus Application Server Command Reference Guide.
(3) Property settings to be edited
A resource adapter compliant with Connector 1.5 specifications might include multiple connection definitions.
Specify the following property settings:
-
Property settings of resource adapters
Specify the following properties:
-
Configuration properties
-
Outbound resource adapter properties
-
Inbound resource adapter properties
-
Properties of the administered objects
-
Runtime properties
For details on the property settings, see (4) Setting the resource adapter properties.
-
-
Property settings for each Outbound resource adapter connection
For using Outbound resource adapters, specify the following properties:
-
Configuration properties
-
Runtime properties
-
Optional name information
For details on the property settings for each Outbound resource adapter connection, see (5) Property settings for each Outbound resource adapter connection.
-
(4) Setting the resource adapter properties
The following sections describe the settings for the resource adapter properties:
(a) Configuration properties
The following table describes the settings for the configuration properties (<resourceadapter> - <config-property> tag) of the resource adapter:
|
Items |
Corresponding tags |
|---|---|
|
Configuration property name |
<config-property-name> |
|
Configuration property data type |
<config-property-type> |
|
Configuration property value |
<config-property-value> |
Repeat the above settings for all the configuration properties that you want to define.
For the configuration property name (<config-property-name>) to be defined, see 4.2.2 Defining the DB Connector properties.
(b) Outbound resource adapter properties
The following table describes the settings for the Outbound resource adapter properties (<outbound-resourceadapter> tag):
|
Items |
Mandatory |
Corresponding tags |
|---|---|---|
|
Property settings for each connection# |
Y |
<connection-definition> |
|
Transaction support level |
O |
<transaction-support> |
|
Scope of re-authentication support |
O |
<reauthentication-support> |
- Legend:
-
Y: Mandatory
O: Optional
- #
-
For details on the property settings for each Outbound resource adapter connection, see (5) Property settings for each Outbound resource adapter connection.
For details on the property settings, see 4.1.1 Specifications of the HITACHI Connector Property file in the uCosminexus Application Server Application and Resource Definition Reference Guide.
(c) Inbound resource adapter properties
The following table describes the settings for the Inbound resource adapter properties (<inbound-resourceadapter> - <messageadapter> - <messagelistener> tag):
|
Items |
Corresponding tags |
|---|---|
|
Message listener type |
<messagelistener-type> |
|
Information about ActivationSpec |
<activationspec> |
(d) Properties of the administered objects
The following table describes the property settings for the administered objects (<adminobject> - <config-property> tag) of the resource adapter:
|
Items |
Corresponding tags |
|---|---|
|
Property name of the administered object |
<config-property-name> |
|
Property data type of the administered object |
<config-property-type> |
|
Property value of the administered object |
<config-property-value> |
(e) Runtime properties
The following table describes the settings for runtime properties (<resourceadapter-runtime> - <property> tag) of the resource adapter:
|
Items |
Corresponding tags |
|---|---|
|
Property name |
<property-name> |
|
Property data type |
<property-type> |
|
Property value |
<property-value># |
- #
-
For details on how to set up property values, see 4.2.2 Defining the DB Connector properties.
Repeat the above settings for all the properties that you want to define.
Specify the following settings in the property name (<property-name>):
|
Property items |
Item name of property name (<property-name>) |
|---|---|
|
Maximum number of threads executed concurrently in the thread pool |
MaxTPoolSize |
|
Minimum number of threads in the thread pool |
MinTPoolSize |
|
Value of a timeout until a thread is released from the thread pool (seconds) |
TPoolKeepalive |
- Note:
-
Specify the above settings when the lifecycle management function is enabled. When the lifecycle management function is not used (<resourceadapter-class> is not specified), the property value (<property-value>) is ignored. For the lifecycle management functionality, see 3.16.1 Lifecycle management of a resource adapter in the uCosminexus Application Server Common Container Functionality Guide.
For details on the property settings, see 4.1.1 Specifications of the HITACHI Connector Property file in the uCosminexus Application Server Application and Resource Definition Reference Guide.
(5) Property settings for each Outbound resource adapter connection
The property settings for each Outbound resource adapter connection are described as follows:
(a) Configuration properties
The following table describes the settings for the configuration properties (<outbound-resourceadapter> - <connection-definition> - <config-property> tag) of the Outbound resource adapter:
|
Items |
Corresponding tags |
|---|---|
|
Configuration property name |
<config-property-name> |
|
Configuration property data type |
<config-property-type> |
|
Configuration property value |
<config-property-value> |
Repeat the above settings for all the configuration properties that you want to define.
For the configuration property name (<config-property-name>) to be defined, see 4.2.2 Defining the DB Connector properties.
Note that the configuration properties for each connection combine the configuration properties specified for each connection (<outbound-resourceadapter> - <connection-definition> - <config-property> tag) and the configuration properties specified for the resource adapter (<resourceadapter> - <config-property> tag). If the same configuration property name is specified, the priority will be given to the configuration property specified for each connection.
(b) Runtime properties
The following table describes the settings for runtime properties (<outbound-resourceadapter> - <connection-definition> - <connector-runtime> tag) of Outbound resource adapters:
|
Items |
Corresponding tags |
|---|---|
|
Property name |
<property-name> |
|
Property data type |
<property-type> |
|
Property value |
<property-value> |
Repeat the above settings for all the properties that you want to define.
For details on the runtime property names (<property-name>) to be defined and operations and precautions for the connection pool, see 4.2.2 Defining the DB Connector properties.
(c) Optional name information
The following table describes the settings for optional name information (<outbound-resourceadapter> - <connection-definition> - <connector-runtime> - <resource-external-property> tag) of Outbound resource adapters:
|
Items |
Mandatory |
Corresponding tags |
|---|---|---|
|
Optional name of the resource |
Y |
<optional-name> |
|
Resource authentication method |
O |
<res-auth> |
|
Scope of resource sharing |
O |
<res-sharing-scope> |
- Legend:
-
Y: Mandatory
O: Optional
For details on the property settings, see 4.1.1 Specifications of the HITACHI Connector Property file in the uCosminexus Application Server Application and Resource Definition Reference Guide.
For details on how to use the optional name of the resource adapter, see 4.7 Referencing and changing the resource adapter names registered in the JNDI name space.