To run an ODBC application program or a UAP that uses ODBC functions, you need to install the ODBC driver in the HiRDB client beforehand. To execute a UAP via ODBC on the HiRDB server, you also need to install the ODBC driver in the HiRDB server.

This section presents the ODBC driver installation procedure. Be sure to exit all Windows applications before starting the installation.

To install the ODBC driver:.

1. Execute hcd_inst.exe found on the integrated CD-ROM to start Hitachi Integrated Installer.
2. At the Hitachi Integrated Installer screen, select one of the following, and then click the Execute Installation button to start the HiRDB setup program:
   For the UNIX version:
   
   • For HiRDB/Run Time: HiRDB/Run Time
   • For HiRDB/Developer's Kit: HiRDB/Developer's Kit
   For the Windows version:
   
   • For a HiRDB/Single Server: HiRDB/Single Server
   • For a HiRDB/Parallel Server: HiRDB/Parallel Server
3. Perform the following operation; the setup program of the selected program process starts:
   For the UNIX version:
   From the Select Program Process window of the HiRDB setup program, select one of the following, and then click the Next button:
   
   • For HiRDB/Run Time: Previous Product, and then HiRDB/Run Time (ODBC 2.0)
   • For HiRDB/Developer's Kit: Previous Product, and then HiRDB/Developer's Kit (ODBC 2.0)
   For the Windows version:
   From the Select Program Process window of the HiRDB setup program, select Previous Product and HiRDB/Run Time (ODBC 2.0), and then click the Next button.
   
4. Select the displayed HiRDB driver and choose the OK button. Installation does not take place if you choose OK without selecting anything.
5. Existing data sources are displayed. If no data source has been defined, nothing is displayed. Choose the Add button.
   

   

6. Select the HiRDB driver as being subject to data source addition.
   

   

7. A dialog box for setting up the data source is displayed.
   

   

   Explanation

   Data source name

   Specify a name identifying the data source. The name can have up to 32 single-byte characters or 16 double-byte characters. Single-byte and double-byte characters can also be mixed.

   PDHOST (host name)

   Specify the host name of the server machine. This is the name specified in the client environment definition. For details about PDHOST, see 6.6.4 Environment definition information. If this information is omitted, the system assumes the value in the client environment definition.

   PDNAMEPORT (HiRDB port number)

   Specify the port number of the server machine. This is the port number specified in the client environment definition. For details about PDNAMEPORT, see 6.6.4 Environment definition information. If this information is omitted, the system assumes the value in the client environment definition.

   HiRDB client environment definition file name (absolute path name) ^*

   Specify the absolute path name of the HiRDB client environment definition file. Use this item to change the specification values for the HiRDB client environment variables for a particular data source. For example, if you are using the high-speed connection facility (PDSERVICEPORT) to connect to multiple HiRDB systems, you can use this item to specify the file name of the HiRDB client environment definition file and change the connection destination for each data source.

   If this information is omitted, the system assumes HIRDB.INI. For all client environment variables, except PDHOST and PDNAMEPORT, the system uses the settings in the HiRDB client environment definition file specified here.

   If the specified file is not HIRDB.INI, the system ignores the specifications in HIRDB.INI.

8. After specifying all items, choose the OK button. The specified data source is displayed. To change the settings, choose the Set button to display the previous dialog box.
   

   

   ^* When you install a HiRDB client, a HiRDB client environment definition file is automatically created under the filename HiRDB.INI in the system directory. To install the ODBC driver before installing the HiRDB client, you need to create the HIRDB.INI file, because this file has not been created. To create a client environment definition file, copy the HIRDB.INI file found in the odb32\Disk1\Sampleap directory of the installation CD-ROM to an appropriate directory, and then edit the file. For details about each client environment variable, see 6.6.4 Environment definition information.