HITACHI Connector Property file

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
 

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.

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.
  

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#1	Y	<connection-definition>
Transaction support level#2	O	<transaction-support>
Scope of re-authentication support	O	<reauthentication-support>

Legend:

Y: Mandatory

O: Optional

#1

For details on the property settings for each Outbound resource adapter connection, see (5) Property settings for each Outbound resource adapter connection.

#2

You cannot specify a global transaction (XATransaction) for resource adapters compliant with Connector 1.5 specifications.

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.

(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 Contents of the HITACHI Connector Property file in the uCosminexus Application Server Application and Resource Definition Reference Guide.

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 Contents 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.8 Referencing and changing the resource adapter names registered in the JNDI name space.