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; (2) Acquiring the property file to be edited and setting the properties; (3) Property settings to be edited

(1) Property file to be edited

(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

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 (Acquiring RAR file properties) in the uCosminexus Application Server Command Reference Guide. For details on the cjsetrarprop command, see cjsetrarprop (Setting RAR properties) 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>

Legend:: Y: Mandatory

For details on the property settings, see 4.1.1 Contents 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>

Legend:: Y: Mandatory; O: Optional