17.7.37 setEncodeLang

(a) Function

Sets the name of the conversion character set for data conversion.

(b) Format

public void setEncodeLang ( String encode_lang ) throws SQLException

(c) Arguments
String encode_lang
Specifies the name of the conversion character set. You must select a name from the list of encodings shown under Internationalization in the JavaTM 2 SDK, Standard Edition documentation.
The table below shows the HiRDB character encodings and the corresponding conversion character sets.
HiRDB character encoding
(character encoding set with pdntenv or pdsetup command)
Conversion character set to be specified
lang-cISO8859_1
sjis SJIS or MS932#
ujisEUC_JP
utf-8UTF-8
chineseEUC_CN
Note:
If the specified conversion character set name is not in compliance with the applicable name shown in this table, the operation of the JDBC driver is not guaranteed.
#
The specification of SJIS or MS932 depends on the handling of Windows special characters in the application.
When OFF is specified, the JDBC driver assumes that the applicable conversion character set name shown in this table was specified. If the HiRDB character encoding is sjis, the conversion character set determined by the OS running the JDBC driver is as follows.
In UNIX: SJIS
In Windows: MS932
If the null value is specified, the current conversion character set name that had been set by this method is invalidated, and the setting is returned to its initial status.
Note that the specification values are case sensitive (except for OFF).
(d) Return value

None.

(e) Functional detail

The conversion character set that was specified by this method is used for carrying out the following data conversions:

If this method is not specified, the JDBC driver converts characters using the applicable conversion character set shown in the table above. However, the JDBC driver uses the default character conversion set of the Java Virtual Machine to convert the following items:

(f) Exceptions

If the specified conversion character set is not supported by the Java Virtual Machine, this method throws an SQLException.