README for the HP Neoview ODBC Drivers for UNIX (R2.5)

Setting Up the Client Environment

If you selected default options during installation, ensure that:

• The include (*.h) files are in the /usr/include/hpodbc directory.

• An MXODSN file is in the /etc/hpodbc directory.

By default, the MXODSN file in the package will be installed as /etc/hpodbc/

MXODSN.template. Rename it to MXODSN, and make necessary changes to the file before

using the driver.

• The libraries are located in the /usr/lib directory.

For the HPUX (IA-64) 64 bit driver, the default lib location is /usr/lib/hpux64.

For the HPUX (IA-64) 32 bit driver, the default lib location is /usr/lib/hpux32.

For the HPUX (PA-RISC) 64 bit driver, the default lib location is /usr/lib/pa20_64.

For the Linux 64 bit driver, the default lib location is /usr/lib64.

For the Solaris 64 bit driver, the default lib location is /usr/lib/sparcv9.

If you select non-default locations during installation, ensure that the files are installed in the

directories that you specified during installation.

The driver expects the MXODSN file to be present in either the default location (/etc/hpodbc)

or the current working directory (CWD) of the application.

Using a Third Party Driver Manager

• If you are using an external driver manager, you must point to libhpodbc_drvr and not to

libhpodbc. (Use libhpodbc_drvr64 if you are using 64-bit versions of external driver

managers.)

• The driver (libhpodbc_drvr.so) has been verified with iODBC and unixODBC driver

managers.

• These driver managers, as well as documentation, can be found at these Web sites:

http://www.iodbc.org/

http://www.unixodbc.org/

• The three environment variables that control tracing are:

— HPODBC_TRACE_LEVEL — sets trace level (ERROR, WARNING, CONFIG, INFO,

or DEBUG)

— HPODBC_TRACEFILE_NAME — specifies the name of the log file

— HPODBC_TRACEFILE_SIZE — specifies the maximum files size of the log files

• For information on the necessary data source configuration options, you will need to add

to the respective configuration files (for example, to odbc.ini). For more information, see the

Neoview ODBC Drivers Manual at http://www.hp.com/go/neoviewdocs.

Running the Sample Program

NOTE: The examples after each step assume that you have default installation directories.

If you have a previous version of the hpodbc driver installed, you need to re-link your existing

application to ensure that you pick up the correct version of the driver. If you are unsure of the

version, check the version of your application with this command:

ldd <object file>

1. Move to the directory where you installed the sample program:

cd /etc/hpodbc/sample

Installation of the Neoview ODBC Drivers for UNIX 13