(a) Function

Sets an XA open character string.

(b) Format

 
public void setXAOpenString ( String xa_string ) throws SQLException
 

(c) Arguments

String xa_string

Specifies an XA open character string.

If the null value is specified, the current XA open character string that had been set by this method is invalidated, and the setting is returned to its initial status.

(d) Return value

None.

(e) Functional detail

Sets an XA open character string. This method is provided by the XADataSource interface only. Specify the XA open character string in the following format:

Format

 
HiRDB-environment-variable-group-identifier + environment-variable-group-name-of-HiRDB-client
 

Specify the HiRDB environment variable group identifier that was set by the setDescription method. Unlike when the environment variable group name of the HiRDB client is specified by the setDescription method, in this case the environment variable group name of the HiRDB client doe not need to be enclosed in quotation marks even if the name includes a single-byte at mark (@) or a single-byte space.

Setting example 1

When the path of the environment variable group name of the HiRDB client is /HiRDB/HiRDB.ini

 
ds.setDescription("HDB1");
ds.setXAOpenString("HDB1+/HiRDB/HiRDB.ini");
 

Setting example 2

When the path of the environment variable group name of the HiRDB client is C:\ProgramFiles\HITACHI\HiRDB\HiRDB.ini ( is a single-byte space)

 
ds.setDescription("HDB1");
ds.setXAOpenString("HDB1+C:\\ProgramFiles\\HITACHI\\HiRDB\\HiRDB.ini");
 

(f) Exceptions

None.