Hitachi

Hitachi Advanced Database Application Development Guide


4.3.1 HADB client for Windows

In the HADB client for Windows, specify the environment variables listed in the following table.

Table 4‒2: Values to be specified in the environment variables

No.

Environment variable

Value to be specified

1

PATH

Add the following folder to this environment variable:

64-bit edition of Windows:

  • %ADBCLTDIR%\client\bin

  • %ADBCLTDIR%\vclib

32-bit edition of Windows:

  • %ADBCLTDIR%\client\bin

  • %ADBCLTDIR%\vclib32

Specify this environment variable as a system environment variable.

2

TZ

Specify in this environment variable the time zone of the computer on which the HADB client is installed.

Specify this environment variable as a system environment variable.

Do not specify a time zone that uses leap seconds.

3

ADBCLTDIR

Specify in this environment variable the absolute path of the client directory. Be sure to specify this environment variable before you execute the registry registration or deletion command.

Specify the first three characters of the path in accordance with the following rules:

  • First character

    Alphabetic character indicating the drive

  • Second character

    Colon (:)

  • Third character

    Forward slash (/) or backlash (\)

4

ADBCLTLANG

Specify in this environment variable the character encoding used on the HADB client. Specify the same character encoding as used on the HADB server. This must be the character encoding specified in the ADBLANG environment variable for the HADB server.

  • If using Unicode (UTF-8) on the HADB server

    Specify UTF8 in this environment variable.

  • If using Shift-JIS on the HADB server

    Specify SJIS in this environment variable.

5

ADBMSGLOGSIZE

Specify in this environment variable the maximum size (in megabytes) of a client message log file. The permitted value range is from 1 to 2000.

Four client message log files are created on an HADB client. If you omit this environment variable, the maximum size of each client message log file is set to 16 megabytes.

If you start multiple client processes from a single client directory, specify for each of them the same value in this environment variable. If different values are specified when multiple client processes are run, the client message log files might become corrupted.

6

ADBODBTRC

Specify whether to output HADB ODBC driver trace information. Specify one of the following values in this environment variable:

  • YES: Specify this value to output HADB ODBC driver trace information.

  • NO: Specify this value to not output HADB ODBC driver trace information.

If you omit this environment variable or specify an invalid value, NO is assumed.

Consider setting this environment variable when using the ODBC driver.

7

ADBODBTRCSIZE

Specify the maximum size of an HADB ODBC driver trace file (in MB). You can specify a value in the range from 32 to 1,024.

If you omit this environment variable or specify an invalid value, 256 is assumed.

Consider setting this environment variable when using the ODBC driver.

8

ADBODBTRCPATH

Specify the absolute path of the folder in which to store HADB ODBC driver trace files.

The path name cannot be longer than 210 bytes.

In the following circumstances, HADB ODBC driver trace information is not output even if YES is specified in ADBODBTRC:

  • This environment variable is omitted.

  • An invalid folder is specified.

  • The path name is 211 bytes or longer.

Consider setting this environment variable when using the ODBC driver.

9

ADBODBTRCLV

This environment variable specifies the trace level to apply when outputting HADB ODBC driver trace information. Specify one of the following values:

  • 1: Specify this value to output information at trace level 1.

  • 2: Specify this value to output information at trace level 2.

For details about trace levels, see 17.4.1 About trace levels.

If you omit this environment variable or specify an invalid value, 1 is assumed.

Consider setting this environment variable when using the ODBC driver.

10

ADBODBAPMODE

Specify the application mode of the HADB ODBC driver. Normally, you do not need to specify this environment variable.

The value specified for this environment variable changes the behavior of the HADB ODBC driver.

  • ACCESS: The HADB ODBC driver operates in Microsoft Access(R) compatibility mode, rather than following the ODBC 3.5 specification.

    Specify this value when using Microsoft Access to access the HADB server. Specifying this value allows you to avoid certain issues, such as #Deleted replacing search results or errors occurring.

  • NORMAL: The HADB ODBC driver operates as normal.

If you omit this environment variable or specify an invalid value, NORMAL is assumed.

Consider setting this environment variable when using the ODBC driver.