Connection information setup/acquisition interface

The JdbhDataSource, JdbhConnectionPoolDataSource, and JdbhXADataSource classes, which are provided by the JDBC driver, provide methods of setting/acquiring the connection information necessary for database connection, besides the methods specified by the JDBC2.0 Optional Package specification.

The following table lists and describes the methods that set and acquire connection information.

Table 17-18 Methods of setting/acquiring connection information

Subsection	Method	Function
17.11.1	setDescription	Sets the additional connection information needed by the database to be connected.
17.11.2	getDescription	Acquires the additional connection information needed by the database to be connected.
17.11.3	setDBHostName	Sets the host name of the HiRDB to be connected.
17.11.4	getDBHostName	Acquires the host name of the HiRDB to be connected.
17.11.5	setEncodeLang	Uses the specified encoding character code to convert data.
17.11.6	getEncodeLang	Returns the encoding characters to be used for data conversion.
17.11.7	setUser	Sets the authorization identifier.
17.11.8	getUser	Acquires the authorization identifier.
17.11.9	setPassword	Sets a password.
17.11.10	getPassword	Acquires a password.
17.11.11	setXAOpenString^#	Sets an XA_OPEN character string.
17.11.12	getXAOpenString^#	Acquires an XA_OPEN character string.
17.11.13	setXACloseString^#	Sets an XA_CLOSE character string.
17.11.14	getXACloseString^#	Acquires an XA_CLOSE character string.
17.11.15	setRMID^#	Sets a resource manager identifier.
17.11.16	getRMID^#	Acquires a resource manager identifier.
17.11.17	setXAThreadMode^#	Sets a thread mode for using XA.
17.11.18	getXAThreadMode^#	Acquires a thread mode for using XA.
17.11.19	setCommit_Behavior	Sets whether a cursor remains valid following COMMIT.
17.11.20	getCommit_Behavior	Acquires whether a cursor remains valid following COMMIT.
17.11.21	setBlockUpdate	Specifies whether or not multiple parameter sets are to be processed at one time.
17.11.22	getBlockUpdate	Acquires a value indicating whether or not multiple parameter sets are to be processed at one time.
17.11.23	setLONGVARBINARY_Access	Specifies the access method for a LONGVARBINARY database (column attribute is BLOB or BINARY).
17.11.24	getLONGVARBINARY_Access	Acquires the access method for a LONGVARBINARY database (column attribute is BLOB or BINARY).
17.11.25	setSQLInNum	Specifies the maximum number of input or input/output ? parameters in the SQL statements to be executed.
17.11.26	getSQLInNum	Acquires the maximum number of input or input/output ? parameters in the SQL statements to be executed that has been set by setSQLInNum.
17.11.27	setSQLOutNum	Specifies the maximum number of search items, output ? parameters, or input/output ? parameters in the SQL statements to be executed.
17.11.28	getSQLOutNum	Acquires the maximum number of search items, output ? parameters, or input/output ? parameters in the SQL statements to be executed that has been set by setSQLOutNum.
17.11.29	setSQLWarningLevel	Specifies the warning retention level that occurred during execution of SQL statements.
17.11.30	getSQLWarningLevel	Acquires the warning retention level specified in setSQLWarningLevel.
17.11.31	setClear_Env	Specifies whether or not the HiRDB client environment definition set as OS environment variables is to be ignored during database connection.
17.11.32	getClear_Env	Acquires the environment variable invalidation setting specified by setClear_Env.

#: These methods are provided by the JdbhXADataSource class only.

17.11 Connection information setup/acquisition interface