Hitachi

Hitachi Advanced Database Application Development Guide


B.1 HADB clients for Windows

Organization of this subsection

(1) Structure of the client directory (at installation)

The tables below describe the structure of the client directory (at installation) when a Windows edition of HADB client is installed.

In the tables, %INSTCLTDIR% indicates the client directory (at installation).

Table B‒1: Structure of the client directory (during installation) (for the 64-bit version of HADB client)

No.

Folder and file names

Description

1

%INSTCLTDIR%\client

Folder for storing the commands, libraries, ODBC driver, and ODBC data source setup program used on the HADB client

2

%INSTCLTDIR%\client\bin

Folder for storing the commands, ODBC driver, and ODBC data source setup program used on the HADB client

3

%INSTCLTDIR%\client\bin\adbclt.dll

HADB client

4

%INSTCLTDIR%\client\bin\adbodbc.dll

ODBC driver

5

%INSTCLTDIR%\client\bin\adbodbcstp.dll

ODBC data source setup program

6

%INSTCLTDIR%\client\bin\adbclt32.dll

HADB client (32-bit)

7

%INSTCLTDIR%\client\bin\adbodbc32.dll

ODBC driver (32-bit)

8

%INSTCLTDIR%\client\bin\adbodbstp32.dll

ODBC data source setup program (32-bit)

9

%INSTCLTDIR%\client\bin\libcurl.dll

Curl library

10

%INSTCLTDIR%\client\bin\libcurl32.dll

Curl library (32-bit)

11

%INSTCLTDIR%\client\lib

Folder for storing libraries used with the HADB client

12

%INSTCLTDIR%\client\lib\adbclt.lib

Client library

13

%INSTCLTDIR%\client\lib\adbclt32.lib

Client library (32-bit)

14

%INSTCLTDIR%\client\lib\adbjdbc8.jar

JDBC driver (JRE 8)

15

%INSTCLTDIR%\conf

Folder for storing client definitions

16

%INSTCLTDIR%\include

Folder for storing user-provided header files

17

%INSTCLTDIR%\include\adbcnv.h

User-provided header files

18

%INSTCLTDIR%\include\adbcli.h

19

%INSTCLTDIR%\include\adbtypes.h

20

%INSTCLTDIR%\include\adbodb.h

21

%INSTCLTDIR%\lib

Folder for storing libraries

22

%INSTCLTDIR%\lib\sysdef

Folder for storing definition analysis information files

23

%INSTCLTDIR%\lib\sysdef\adbclt.def

Definition analysis information file

24

%INSTCLTDIR%\sample

Folder for storing a sample application program and model definition files

25

%INSTCLTDIR%\sample\cli_sample1.c

Sample application program

26

%INSTCLTDIR%\sample\Sample1.java

Sample application program (for JDBC)

27

%INSTCLTDIR%\sample\odbc_sample1.c

Sample application program (for ODBC)

28

%INSTCLTDIR%\sample\conf

Folder for storing model definition files

29

%INSTCLTDIR%\sample\conf\client.def

Model client definition file

30

%INSTCLTDIR%\spool

Folder for storing the HADB client's execution results logs

31

%INSTCLTDIR%\vclib

Folder for storing the Microsoft Visual Studio 2019 Visual C++ Redistributable package

32

%INSTCLTDIR%\vclib\VC_redist.x64.exe

Visual C++ Redistributable package for Microsoft Visual Studio 2019

33

%INSTCLTDIR%\adbreg.reg

Registry registration command

34

%INSTCLTDIR%\adbunreg.reg

Registry deletion command

35

%INSTCLTDIR%\readme.txt

README file (Release Notes)

Note

The folders and files listed in the preceding table are created when an HADB client is installed. The folders and files listed in the preceding table are deleted when the HADB client is uninstalled.

Table B‒2: Structure of the client directory (during installation) (for the 32-bit version of HADB client)

No.

Folder and file names

Description

1

%INSTCLTDIR%\client

Folder for storing the commands, libraries, ODBC driver, and ODBC data source setup program used on the HADB client

2

%INSTCLTDIR%\client\bin

Folder for storing the commands, ODBC driver, and ODBC data source setup program used on the HADB client

3

%INSTCLTDIR%\client\bin\adbclt32.dll

HADB client

4

%INSTCLTDIR%\client\bin\adbodbc32.dll

ODBC driver

5

%INSTCLTDIR%\client\bin\adbodbstp32.dll

ODBC data source setup program

6

%INSTCLTDIR%\client\bin\libcurl32.dll

Curl library

7

%INSTCLTDIR%\client\lib

Folder for storing libraries used with the HADB client

8

%INSTCLTDIR%\client\lib\adbclt32.lib

Client library

9

%INSTCLTDIR%\client\lib\adbjdbc8.jar

JDBC driver (JRE 8)

10

%INSTCLTDIR%\conf

Folder for storing client definitions

11

%INSTCLTDIR%\include

Folder for storing user-provided header files

12

%INSTCLTDIR%\include\adbcnv.h

User-provided header files

13

%INSTCLTDIR%\include\adbcli.h

14

%INSTCLTDIR%\include\adbtypes.h

15

%INSTCLTDIR%\include\adbodb.h

16

%INSTCLTDIR%\lib

Folder for storing libraries

17

%INSTCLTDIR%\lib\sysdef

Folder for storing definition analysis information files

18

%INSTCLTDIR%\lib\sysdef\adbclt.def

Definition analysis information file

19

%INSTCLTDIR%\sample

Folder for storing a sample application program and model definition files

20

%INSTCLTDIR%\sample\cli_sample1.c

Sample application program

21

%INSTCLTDIR%\sample\Sample1.java

Sample application program (for JDBC)

22

%INSTCLTDIR%\sample\odbc_sample1.c

Sample application program (for ODBC)

23

%INSTCLTDIR%\sample\conf

Folder for storing model definition files

24

%INSTCLTDIR%\sample\conf\client.def

Model client definition file

25

%INSTCLTDIR%\spool

Folder for storing the HADB client's execution results logs

26

%INSTCLTDIR%\vclib32

Folder for storing the Microsoft Visual Studio 2019 Visual C++ Redistributable package

27

%INSTCLTDIR%\vclib32\VC_redist.x86.exe

Visual C++ Redistributable package for Microsoft Visual Studio 2019

28

%INSTCLTDIR%\adbreg32.reg

Registry registration command

29

%INSTCLTDIR%\adbunreg32.reg

Registry deletion command

30

%INSTCLTDIR%\readme.txt

README file (Release Notes)

Note

The folders and files listed in the preceding table are created when an HADB client is installed. The folders and files listed in the preceding table are deleted when the HADB client is uninstalled.

(2) Structure of client directory (during operation)

For a Windows edition of HADB client, the client directory (at installation) is used as-is during operation.

Table B‒3: Structure of the client directory (during operation) (for the 64-bit version of HADB client)

No.

Folder and file names

Description

Time the item is created

Time the item is deleted

1

%ADBCLTDIR%\client

Folder for storing the commands, libraries, ODBC driver, and ODBC data source setup program used on the HADB client

When the HADB client is installed

When the HADB client is uninstalled

2

%ADBCLTDIR%\client\bin

Folder for storing the commands, ODBC driver, and ODBC data source setup program used on the HADB client

3

%ADBCLTDIR%\client\bin\adbclt.dll

HADB client

4

%ADBCLTDIR%\client\bin\adbodbc.dll

ODBC driver

5

%ADBCLTDIR%\client\bin\adbodbcstp.dll

ODBC data source setup program

6

%ADBCLTDIR%\client\bin\adbclt32.dll

HADB client (32-bit)

7

%ADBCLTDIR%\client\bin\adbodbc32.dll

ODBC driver (32-bit)

8

%ADBCLTDIR%\client\bin\adbodbstp32.dll

ODBC data source setup program (32-bit)

9

%ADBCLTDIR%\client\bin\libcurl.dll

Curl library

10

%ADBCLTDIR%\client\bin\libcurl32.dll

Curl library (32-bit)

11

%ADBCLTDIR%\client\lib

Folder for storing libraries used with the HADB client

12

%ADBCLTDIR%\client\lib\adbclt.lib

Client library

13

%ADBCLTDIR%\client\lib\adbclt32.lib

Client library (32-bit)

14

%ADBCLTDIR%\client\lib\adbjdbc8.jar

JDBC driver (JRE 8)

15

%ADBCLTDIR%\conf

Folder for storing client definitions

16

%ADBCLTDIR%\include

Folder for storing user-provided header files

17

%ADBCLTDIR%\include\adbcnv.h

User-provided header files

18

%ADBCLTDIR%\include\adbcli.h

19

%ADBCLTDIR%\include\adbtypes.h

20

%ADBCLTDIR%\include\adbodb.h

21

%ADBCLTDIR%\lib

Folder for storing libraries

22

%ADBCLTDIR%\lib\sysdef

Folder for storing definition analysis information files

23

%ADBCLTDIR%\lib\sysdef\adbclt.def

Definition analysis information file

24

%ADBCLTDIR%\sample

Folder for storing a sample application program and model definition files

25

%ADBCLTDIR%\sample\cli_sample1.c

Sample application program

26

%ADBCLTDIR%\sample\Sample1.java

Sample application program (for JDBC)

27

%ADBCLTDIR%\sample\odbc_sample1.c

Sample application program (for ODBC)

28

%ADBCLTDIR%\sample\conf

Folder for storing model definition files

29

%ADBCLTDIR%\sample\conf\client.def

Model client definition file

30

%ADBCLTDIR%\spool#1

Folder for storing the HADB client's execution results logs

31

%ADBCLTDIR%\spool\adbmessagecltXX.log

Client message log file#2

When the HADB client connects to the HADB server for the first time after the HADB client is installed

32

%ADBCLTDIR%\spool\.adbmessageclt

Client message log file number management file

33

%ADBCLTDIR%\vclib

Folder for storing the Microsoft Visual Studio 2019 Visual C++ Redistributable package

When the HADB client is installed

34

%ADBCLTDIR%\vclib\VC_redist.x64.exe

Visual C++ Redistributable package for Microsoft Visual Studio 2019

35

%ADBCLTDIR%\adbreg.reg

Registry registration command

36

%ADBCLTDIR%\adbunreg.reg

Registry deletion command

37

%ADBCLTDIR%\readme.txt

README file (Release Notes)

38

%ADBODBTRCPATH%\adbodbtrace_PID_TID_xx.log#1

HADB ODBC driver trace file#3

When a handle is obtained by using the HADB ODBC driver for the first time

The HADB client does not delete this file.

#1

Grant write permission for the following folders to each OS user who might use the HADB client (including the ODBC driver):

  • %ADBCLTDIR%\spool

  • %ADBODBTRCPATH%

#2

A maximum of four client message log files are created. The maximum size of each file is specified by using the ADBMSGLOGSIZE environment variable.

#3

A maximum of two HADB ODBC driver trace files are created per process or thread. The maximum size of each file is specified by using the ADBODBTRCSIZE environment variable.

A user needs to create the folder that is used to store HADB ODBC driver trace files. When the folder becomes no longer necessary, a user needs to delete it. The HADB client does not create or delete the folder.

Table B‒4: Structure of the client directory (during operation) (for the 32-bit version of HADB client)

No.

Folder and file names

Description

Time the item is created

Time the item is deleted

1

%ADBCLTDIR%\client

Folder for storing the commands, libraries, ODBC driver, and ODBC data source setup program used on the HADB client

When the HADB client is installed

When the HADB client is uninstalled

2

%ADBCLTDIR%\client\bin

Folder for storing the commands, ODBC driver, and ODBC data source setup program used on the HADB client

3

%ADBCLTDIR%\client\bin\adbclt32.dll

HADB client

4

%ADBCLTDIR%\client\bin\adbodbc32.dll

ODBC driver

5

%ADBCLTDIR%\client\bin\adbodbstp32.dll

ODBC data source setup program

6

%ADBCLTDIR%\client\bin\libcurl32.dll

Curl library

7

%ADBCLTDIR%\client\lib

Folder for storing libraries used with the HADB client

8

%ADBCLTDIR%\client\lib\adbclt32.lib

Client library

9

%ADBCLTDIR%\client\lib\adbjdbc8.jar

JDBC driver (JRE 8)

10

%ADBCLTDIR%\conf

Folder for storing client definitions

11

%ADBCLTDIR%\include

Folder for storing user-provided header files

12

%ADBCLTDIR%\include\adbcnv.h

User-provided header files

13

%ADBCLTDIR%\include\adbcli.h

14

%ADBCLTDIR%\include\adbtypes.h

15

%ADBCLTDIR%\include\adbodb.h

16

%ADBCLTDIR%\lib

Folder for storing libraries

17

%ADBCLTDIR%\lib\sysdef

Folder for storing definition analysis information files

18

%ADBCLTDIR%\lib\sysdef\adbclt.def

Definition analysis information file

19

%ADBCLTDIR%\sample

Folder for storing a sample application program and model definition files

20

%ADBCLTDIR%\sample\cli_sample1.c

Sample application program

21

%ADBCLTDIR%\sample\Sample1.java

Sample application program (for JDBC)

22

%ADBCLTDIR%\sample\odbc_sample1.c

Sample application program (for ODBC)

23

%ADBCLTDIR%\sample\conf

Folder for storing model definition files

24

%ADBCLTDIR%\sample\conf\client.def

Model client definition file

25

%ADBCLTDIR%\spool#1

Folder for storing the HADB client's execution results logs

26

%ADBCLTDIR%\spool\adbmessagecltXX.log

Client message log file#2

When the HADB client connects to the HADB server for the first time after the HADB client is installed

27

%ADBCLTDIR%\spool\.adbmessageclt

Client message log file number management file

28

%ADBCLTDIR%\vclib32

Folder for storing the Microsoft Visual Studio 2019 Visual C++ Redistributable package

When the HADB client is installed

29

%ADBCLTDIR%\vclib32\VC_redist.x86.exe

Visual C++ Redistributable package for Microsoft Visual Studio 2019

30

%ADBCLTDIR%\adbreg32.reg

Registry registration command

31

%ADBCLTDIR%\adbunreg32.reg

Registry deletion command

32

%ADBCLTDIR%\readme.txt

README file (Release Notes)

33

%ADBODBTRCPATH%\adbodbtrace_PID_TID_xx.log#1

HADB ODBC driver trace file#3

When a handle is obtained by using the HADB ODBC driver for the first time

The HADB client does not delete this file.

#1

Grant write permission for the following folders to each OS user who might use the HADB client (including the ODBC driver):

  • %ADBCLTDIR%\spool

  • %ADBODBTRCPATH%

#2

A maximum of four client message log files are created. The maximum size of each file is specified by using the ADBMSGLOGSIZE environment variable.

#3

A maximum of two HADB ODBC driver trace files are created per process or thread. The maximum size of each file is specified by using the ADBODBTRCSIZE environment variable.

A user needs to create the folder that is used to store HADB ODBC driver trace files. When the folder becomes no longer necessary, a user needs to delete it. The HADB client does not create or delete the folder.