4.3.2 Defining the resource adapter properties (for Connector 1.0)
Define the properties of resource adapters compliant with Connector 1.0 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 HITACHI 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 attributes
Execute the following command to apply the values of the Connector attribute 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
The property settings for the resource adapter are described below:
-
General information of the resource adapter
-
Configuration properties
-
Runtime properties
-
Optional name information
(a) General information of the resource adapter
The following table describes the settings for general information (<outbound-resourceadapter> tag) of the resource adapter:
Items |
Mandatory |
Corresponding tags |
---|---|---|
Transaction support level |
Y |
<transaction-support> |
Scope of re-authentication support |
Y |
<reauthentication-support> |
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.
(b) Configuration properties
The following table describes the settings for the configuration properties (<outbound-resourceadapter> - <connection-definition> - <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.
(c) Runtime properties
The following table describes the settings for runtime properties (<property> tag) of the resource adapter:
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.
(d) Optional name information
The following table describes the settings for optional name information (<outbound-resourceadapter> - <connection-definition> - <connector-runtime> - <resource-external-property> tag) of the resource adapter:
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> |
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.