Neoview JDBC Type 4 Driver Programmer's Reference (R2.2, R2.3, R2.4, R2.5)

B Avoiding Driver-Server Version Mismatch
The HP Neoview JDBC type 4 driver, version R2.2, described in this document can connect only
with an HP Neoview R2.2 platform (server). It cannot connect with an R2.1 earlier version platform
To make a connection with the Neoview platform, JDBC clients, through the driver, connect with
the Neoview database connectivity service (NDCS) on the Neoview platform. In some situations,
HP JDBC clients need to make connections to Release 2.2 and R2.1 (and older) Neoview platforms
(servers) from the same client boxes. To make a connection, the driver version must be compatible
with the Neoview platform version.
NOTE: The NDCS release version and Neoview platform release version are always the same.
The topics discussing compatibility issues are:
• “Compatible Versions”
• “Considerations for Mixed-Version JDBC Clients Connecting to Neoview Platforms”
(page 105)
• “Version Mismatch Error Message” (page 105)
Compatible Versions
Ensure that you install the driver version that is compatible with the Neoview platform version.
Compatible versions of the Neoview platformDriver version
All versions up to, but not including, Neoview Release 2.2Neoview Release 2.0 driver
All versions up to, but not including, Neoview Release 2.2Neoview Release 2.1 driver
Neoview Release 2.2 and later versionsNeoview Release 2.2 driver
If a compatible version is not installed, you can obtain the software to download from the Neoview
Software Depot at: http://www.software.hp.com (search for “Neoview”).
Considerations for Mixed-Version JDBC Clients Connecting to Neoview
Platforms
On the client platform, you can install multiple versions of the HP Neoview JDBC type 4 driver
to connect to Neoview platforms of different platform versions.
• Assuming you have installed the Release 2.2 HP Neoview JDBC type 4 driver on your
workstation and set up the client environment, the 2.2 driver’s classes are set your java
CLASSPATH.
• To connect to a Release 2.1 or 2.0 server (Neoview platform) from the same client machine,
you must load the 2.1 driver by making sure that it is in your java CLASSPATH.
• Connecting to both a 2.1 and 2.2 server from the same application at the same time is not
possible.
• A given application must use either the 2.2 driver or the 2.1 driver when launched. The only
way to switch is to reload the application when pointing to a new CLASSPATH that contains
a different driver.
Version Mismatch Error Message
If an HP Neoview JDBC client attempts to connect to an invalid NDCS version, the driver returns
the error:
SQLCODE: 29162
SQLSTATE S1000
Error text:
Compatible Versions 105