Forcing HEI or DECS to Use a Character Set as Native

HCL Enterprise Integrator (HEI) and Domino® Enterprise Connection Services (DECS) determines the native character set on the local machine during startup and uses this setting whenever the native character set is required. HEI and DECS can be forced to use a different character set as native by setting the EINativeText variable in the notes.ini file to the suffix of an HEI text stream format.

LCSTREAMFMT_HCLP932 indicates code page 932. To force HEI to use that character set as native, add the following line to the notes.ini file:

EINativeText=HCLCP932
Note: This variable is obsolete for the Connector for DB2® on IBM® i. Beginning in release 8.0.2, HEI and DECS always use Unicode as the native character set on IBM® I.

Note: The Supported Character Sets table appears later in this appendix. You can specify the native text character set in the notes.ini by simply removing the LCSTREAMFMT preface from the IBM®name portion of the Stream Format Constant name listed in that table.

In all cases, this character set will be assumed to be the native format.

The NativeText variable can be used in conjunction with any Character Set Translation setting. The Character Set Translation Disabled setting causes this character set to be used in all connector interactions. For example, if you're on a CP932 machine, and you access CP819 data with the NativeText variable set to IBMCP932, the character set is considered to be CP932 without translation enabled. If converted to another character set, it is converted as if it were CP932.

In LMBCS-only mode, the system only operates with three character sets:

  • Unicode = Unicode
  • LMBCS = LMBCS
  • All else = Native codepage

This option changes what native text is on the machine. For example, if you force native text to be CP819, then all native text conversion maps to and from CP819. You still have Unicode and LMBCS as in the preceding example, but everything else is considered CP819.

This feature is important for Thai systems, where the native character set generally cannot be retrieved well. The Thai character set, IBMCP874, can be set and then with the translation level set to LMBCS-only or disabled, all databases that HEI (or DECS) interacts with (except Notes® if LMBCS only translation is selected) will be considered as CP874.