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 (at installation) (64-bit edition of Windows)

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\lib

Folder for storing libraries used with the HADB client

10

%INSTCLTDIR%\client\lib\adbclt.lib

Client library

11

%INSTCLTDIR%\client\lib\adbclt32.lib

Client library (32-bit)

12

%INSTCLTDIR%\client\lib\adbjdbc8.jar

JDBC driver (JRE 8)

13

%INSTCLTDIR%\conf

Folder for storing client definitions

14

%INSTCLTDIR%\include

Folder for storing user-provided header files

15

%INSTCLTDIR%\include\adbcnv.h

User-provided header files

16

%INSTCLTDIR%\include\adbcli.h

17

%INSTCLTDIR%\include\adbtypes.h

18

%INSTCLTDIR%\include\adbodb.h

19

%INSTCLTDIR%\lib

Folder for storing libraries

20

%INSTCLTDIR%\lib\sysdef

Folder for storing definition analysis information files

21

%INSTCLTDIR%\lib\sysdef\adbclt.def

Definition analysis information file

22

%INSTCLTDIR%\sample

Folder for storing a sample application program and model definition files

23

%INSTCLTDIR%\sample\cli_sample1.c

Sample application program

24

%INSTCLTDIR%\sample\Sample1.java

Sample application program (for JDBC)

25

%INSTCLTDIR%\sample\odbc_sample1.c

Sample application program (for ODBC)

26

%INSTCLTDIR%\sample\conf

Folder for storing model definition files

27

%INSTCLTDIR%\sample\conf\client.def

Model client definition file

28

%INSTCLTDIR%\spool

Folder for storing the HADB client's execution results logs

29

%INSTCLTDIR%\vclib

Folder for storing Microsoft(R) Visual Studio(R) 2008 runtime libraries (redistribution module)

30

%INSTCLTDIR%\vclib\msvcr90.dll

Microsoft(R) Visual Studio(R) 2008 C runtime libraries

31

%INSTCLTDIR%\vclib\msvcm90.dll

32

%INSTCLTDIR%\vclib\msvcp90.dll

Microsoft(R) Visual Studio(R) 2008 C++ runtime libraries

33

%INSTCLTDIR%\vclib\

Microsoft.VC90.CRT.manifest

Manifest file for Microsoft(R) Visual Studio(R) 2008 runtime libraries

34

%INSTCLTDIR%\adbreg.reg

Registry registration command

35

%INSTCLTDIR%\adbunreg.reg

Registry deletion command

36

%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 (at installation) (32-bit edition of Windows)

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\lib

Folder for storing libraries used with the HADB client

7

%INSTCLTDIR%\client\lib\adbclt32.lib

Client library

8

%INSTCLTDIR%\client\lib\adbjdbc8.jar

JDBC driver (JRE 8)

9

%INSTCLTDIR%\conf

Folder for storing client definitions

10

%INSTCLTDIR%\include

Folder for storing user-provided header files

11

%INSTCLTDIR%\include\adbcnv.h

User-provided header files

12

%INSTCLTDIR%\include\adbcli.h

13

%INSTCLTDIR%\include\adbtypes.h

14

%INSTCLTDIR%\include\adbodb.h

15

%INSTCLTDIR%\lib

Folder for storing libraries

16

%INSTCLTDIR%\lib\sysdef

Folder for storing definition analysis information files

17

%INSTCLTDIR%\lib\sysdef\adbclt.def

Definition analysis information file

18

%INSTCLTDIR%\sample

Folder for storing a sample application program and model definition files

19

%INSTCLTDIR%\sample\cli_sample1.c

Sample application program

20

%INSTCLTDIR%\sample\Sample1.java

Sample application program (for JDBC)

21

%INSTCLTDIR%\sample\odbc_sample1.c

Sample application program (for ODBC)

22

%INSTCLTDIR%\sample\conf

Folder for storing model definition files

23

%INSTCLTDIR%\sample\conf\client.def

Model client definition file

24

%INSTCLTDIR%\spool

Folder for storing the HADB client's execution results logs

25

%INSTCLTDIR%\vclib32

Folder for storing Microsoft(R) Visual Studio(R) 2008 runtime libraries (redistribution module)

26

%INSTCLTDIR%\vclib32\msvcr90.dll

Microsoft(R) Visual Studio(R) 2008 C runtime libraries

27

%INSTCLTDIR%\vclib32\msvcm90.dll

28

%INSTCLTDIR%\vclib32\msvcp90.dll

Microsoft(R) Visual Studio(R) 2008 C++ runtime libraries

29

%INSTCLTDIR%\vclib32\Microsoft.VC90.CRT.manifest

Manifest file for Microsoft(R) Visual Studio(R) 2008 runtime libraries

30

%INSTCLTDIR%\adbreg32.reg

Registry registration command

31

%INSTCLTDIR%\adbunreg32.reg

Registry deletion command

32

%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) (64-bit edition of Windows)

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\lib

Folder for storing libraries used with the HADB client

10

%ADBCLTDIR%\client\lib\adbclt.lib

Client library

11

%ADBCLTDIR%\client\lib\adbclt32.lib

Client library (32-bit)

12

%ADBCLTDIR%\client\lib\adbjdbc8.jar

JDBC driver (JRE 8)

13

%ADBCLTDIR%\conf

Folder for storing client definitions

14

%ADBCLTDIR%\include

Folder for storing user-provided header files

15

%ADBCLTDIR%\include\adbcnv.h

User-provided header files

16

%ADBCLTDIR%\include\adbcli.h

17

%ADBCLTDIR%\include\adbtypes.h

18

%ADBCLTDIR%\include\adbodb.h

19

%ADBCLTDIR%\lib

Folder for storing libraries

20

%ADBCLTDIR%\lib\sysdef

Folder for storing definition analysis information files

21

%ADBCLTDIR%\lib\sysdef\adbclt.def

Definition analysis information file

22

%ADBCLTDIR%\sample

Folder for storing a sample application program and model definition files

23

%ADBCLTDIR%\sample\cli_sample1.c

Sample application program

24

%ADBCLTDIR%\sample\Sample1.java

Sample application program (for JDBC)

25

%ADBCLTDIR%\sample\odbc_sample1.c

Sample application program (for ODBC)

26

%ADBCLTDIR%\sample\conf

Folder for storing model definition files

27

%ADBCLTDIR%\sample\conf\client.def

Model client definition file

28

%ADBCLTDIR%\spool#1

Folder for storing the HADB client's execution results logs

29

%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

30

%ADBCLTDIR%\spool\.adbmessageclt

Client message log file number management file

31

%ADBCLTDIR%\vclib

Folder for storing Microsoft(R) Visual Studio(R) 2008 runtime libraries (redistribution module)

When the HADB client is installed

32

%ADBCLTDIR%\vclib\msvcr90.dll

Microsoft(R) Visual Studio(R) 2008 C runtime libraries

33

%ADBCLTDIR%\vclib\msvcm90.dll

34

%ADBCLTDIR%\vclib\msvcp90.dll

Microsoft(R) Visual Studio(R) 2008 C++ runtime libraries

35

%ADBCLTDIR%\vclib\

Microsoft.VC90.CRT.manifest

Manifest file for Microsoft(R) Visual Studio(R) 2008 runtime libraries

36

%ADBCLTDIR%\adbreg.reg

Registry registration command

37

%ADBCLTDIR%\adbunreg.reg

Registry deletion command

38

%ADBCLTDIR%\readme.txt

README file (Release Notes)

39

%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) (32-bit edition of Windows)

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\lib

Folder for storing libraries used with the HADB client

7

%ADBCLTDIR%\client\lib\adbclt32.lib

Client library

8

%ADBCLTDIR%\client\lib\adbjdbc8.jar

JDBC driver (JRE 8)

9

%ADBCLTDIR%\conf

Folder for storing client definitions

10

%ADBCLTDIR%\include

Folder for storing user-provided header files

11

%ADBCLTDIR%\include\adbcnv.h

User-provided header files

12

%ADBCLTDIR%\include\adbcli.h

13

%ADBCLTDIR%\include\adbtypes.h

14

%ADBCLTDIR%\include\adbodb.h

15

%ADBCLTDIR%\lib

Folder for storing libraries

16

%ADBCLTDIR%\lib\sysdef

Folder for storing definition analysis information files

17

%ADBCLTDIR%\lib\sysdef\adbclt.def

Definition analysis information file

18

%ADBCLTDIR%\sample

Folder for storing a sample application program and model definition files

19

%ADBCLTDIR%\sample\cli_sample1.c

Sample application program

20

%ADBCLTDIR%\sample\Sample1.java

Sample application program (for JDBC)

21

%ADBCLTDIR%\sample\odbc_sample1.c

Sample application program (for ODBC)

22

%ADBCLTDIR%\sample\conf

Folder for storing model definition files

23

%ADBCLTDIR%\sample\conf\client.def

Model client definition file

24

%ADBCLTDIR%\spool#1

Folder for storing the HADB client's execution results logs

25

%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

26

%ADBCLTDIR%\spool\.adbmessageclt

Client message log file number management file

27

%ADBCLTDIR%\vclib32

Folder for storing Microsoft(R) Visual Studio(R) 2008 runtime libraries (redistribution module)

When the HADB client is installed

28

%ADBCLTDIR%\vclib32\msvcr90.dll

Microsoft(R) Visual Studio(R) 2008 C runtime libraries

29

%ADBCLTDIR%\vclib32\msvcm90.dll

30

%ADBCLTDIR%\vclib32\msvcp90.dll

Microsoft(R) Visual Studio(R) 2008 C++ runtime libraries

31

%ADBCLTDIR%\vclib32\

Microsoft.VC90.CRT.manifest

Manifest file for Microsoft(R) Visual Studio(R) 2008 runtime libraries

32

%ADBCLTDIR%\adbreg32.reg

Registry registration command

33

%ADBCLTDIR%\adbunreg32.reg

Registry deletion command

34

%ADBCLTDIR%\readme.txt

README file (Release Notes)

35

%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.