README for the HP Neoview UNIX Drivers (Upd6 R2.2)

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

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

Note: 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.

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

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

If you select nondefault locations during installation, ensure that the files are installed in the

directories that you specified during installation.

Note: 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.

• 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 docs.hp.com: http://docs.hp.com/en/busintellsol.html.

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 relink 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

2. Compile the sample program.

Note: All drivers, other than the 64–bit driver for HP-UX (IA-64) and the x86_64 Linux driver,

are 32-bit drivers; therefore, applications need to be compiled accordingly.

• On Linux:

gcc connect_test.cpp -L/usr/lib -I/usr/include/hpodbc -lhpodbc \

-o connect_test

Note: The Linux driver is a 32-bit driver. If you are using an x86–64 machine, you need

to explicitly compile your application as a 32-bit application. For example: