(a) Function

Sets client environment definitions for HiRDB.

(b) Format

 
public void setEnvironmentVariables ( String variables ) throws SQLException
 

(c) Arguments

String variables

Specifies HiRDB client environment definitions in the format shown below:

Format

 
"variable-name=value;variable-name=value;...;variable-name=value"
 

A specification example is shown below:

Specification example

 
setEnvironmentVariables ("PDFESHOST=FES1;PDCWAITTIME=0");
 

If the null value is specified, the current client environment definitions that had been set by this method are invalidated, and the settings are returned to their initial status.

(d) Return value

None.

(e) Functional detail

Sets HiRDB client environment definitions.

For details about the client environment definitions that can be specified by the JDBC driver, see 17.10 Supported client environment definitions. If a client environment definition that cannot be specified by the JDBC driver is specified for a variable, the specification is ignored. Note that the variable names are case sensitive.

For details about the priorities among connection information items that have multiple setting methods, see 17.11 Connection information priorities.

This method does not check each specification of the client environment definitions. The specification values are checked during connection to the database, and an SQLException is thrown if an error is detected.

(f) Exceptions

None.