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

13. Enter a directory for the include files, or press Enter to use the default directory

(/usr/include/hpodbc).

14. Enter a directory for the sample program, or press Enter to use the default directory

(/etc/hpodbc/sample).

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.

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.

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