Configure the IBM Toolbox for Java

The IBM Toolbox for Java is a library of Java classes that are optimized for accessing i5/OS data and resources. You can use the IBM Toolbox for Java JDBC driver to access local or remote DB2 UDB for iSeries databases from server-side and client Java applications that run on any platform that supports Java.

Determine which version of the IBM Toolbox for Java you want to use on your system.

Overview

IBM Toolbox for Java licensed program

The licensed program is available with every i5/OS release. You can install the licensed program on your i5/OS system, and then either copy the IBM Toolbox for Java JAR file (jt400.jar) to your system or update your system classpath to locate the server installation. Product documentation for IBM Toolbox for Java is available from the iSeries information center. See the following IBM Suggests section for a link to the IBM eServer iSeries Information Center.

Locate the documentation by traversing the following path in the left-hand navigation window of the iSeries information center: Programming > Java > IBM Toolbox for Java .

JTOpen

JTOpen is the open source version of IBM Toolbox for Java, and is more frequently updated than the licensed program version. You can download JTOpen from the Toolbox for Java and JTOpen download page on IBM.com. (See the following IBM Suggests section for the link.) You can also download the JTOpen Programming Guide. The guide includes instructions for installing JTOpen and information about the JDBC driver.

The IBM Toolbox for Java JDBC driver is included with both versions of the IBM Toolbox for Java. This JDBC driver supports JDBC 3.0. For more information about IBM Toolbox for Java and JTOpen, see the product Web site. A link to the product overview page is in the IBM Suggests section of this article.

Procedure

1. Install the IBM Toolbox for Java licensed program.

   The licensed program is available with every i5/OS release. You can install the licensed program on your i5/OS system, and then either copy the IBM Toolbox for Java JAR file (jt400.jar) to your system or update your system classpath to locate the server installation.

2. Open the administrative console.

3. Select Environment > WebSphere Variables.

4. Set the WebSphere variable OS400_TOOLBOX_JDBC_DRIVER_PATH at the Node level.

5. Double click OS400_TOOLBOX_JDBC_DRIVER_PATH.

6. Set the value to the full directory path to the jt400.jar file downloaded in step one. Do not include jt400.jar in this value.

   For example:

   OS400_TOOLBOX_JDBC_DRIVER_PATH == "/JDBC_Drivers/Toolbox"

   When you choose a Toolbox driver from the list of possible resource providers the Classpath field looks like:

   Classpath == ${OS400_TOOLBOX_JDBC_DRIVER_PATH}/jt400.jar

Related concepts

Related tasks

Related information