DBLANG environment variable

The DBLANG environment variable specifies the subdirectory of ONEDB_HOME that contains the customized, language-specific message files that the HCL® OneDB® product uses.


1  DBLANG
2.1 relative_path
2.1 full_path
2.1 locale_name
Element
Description
relative_path
Subdirectory of the HCL OneDB installation directory (which ONEDB_HOME specifies)
full_path
Full path name of the directory that contains the compiled message files
locale_name
Name of a GLS locale that has the format lg_tr.code_set, where lg is a two-character name that represents the language for a specific locale, tr is a two-character name that represents the cultural conventions, and code_set is the name of the code set that the locale supports
HCL OneDB products locate product-specific message files in the following order:
  1. If DBLANG is set to a full_path: the directory that full_name indicates
  2. If DBLANG is set to a relative_path:
    1. In $ONEDB_HOME/msg/$DBLANG on UNIX™ or %ONEDB_HOME%\msg\%DBLANG% on Windows™
    2. In $ONEDB_HOME/$DBLANG on UNIX or %ONEDB_HOME%\%DBLANG% on Windows
  3. If DBLANG is set to a locale_name: the msg subdirectory for the locale in $ONEDB_HOME/msg/lg_tr/code_set on UNIX systems or %ONEDB_HOME%\msg\lg_tr\code_set on Windows, where lg is the language, tr is the territory, and code_set is the code set in locale_name.

    The value of DBLANG does not affect the messages that the database server writes to its message log. The database server obtains the locale for these messages from the SERVER_LOCALE environment variable.

  4. If DBLANG is not set: the msg subdirectory for the locale in $ONEDB_HOME/msg/lg_tr/code_set on UNIX systems or %ONEDB_HOME%\msg\lg_tr\code_set on Windows, where lg is the language and tr is the territory from the locale that is associated with the HCL OneDB product, and code_set is the condensed name of the code set that the locale supports:
    • For HCL OneDB client products: lg and tr are from the client locale (from CLIENT_LOCALE, if it is set)
    • For HCL OneDB database server products: lg and tr are from the server locale (from SERVER_LOCALE, if it is set)
  5. If DBLANG, CLIENT_LOCALE, and LANG are not set:
    1. In $ONEDB_HOME/msg/en_us/0333 on UNIX systems or %ONEDB_HOME%\msg\en_us\0333 on Windows, an internal message directory for the default locale
    2. In $ONEDB_HOME/msg on UNIX systems or %ONEDB_HOME%\msg on Windows, the default HCL OneDB message directories

The compiled message files have the .iem file extension.