Configuring 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.

Before you begin

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

About this task

The IBM Toolbox for Java is available in these versions:
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.

[AIX HP-UX Linux Solaris Windows] [z/OS] Note: If you are using WebSphere Application Server on platforms other than iSeries, use the JTOpen version of the Toolbox JDBC driver.

Procedure

  1. [AIX HP-UX Linux Solaris Windows] [z/OS] Download the jt400.jar file. The URL for the product Web site download page is in the IBM Suggests section of this article.

    Place it in a directory on your workstation such as /JDBC_Drivers/Toolbox.

  2. [iSeries] 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.

  3. Open the administrative console.
  4. Select Environment > WebSphere Variables.
  5. Set the WebSphere variable OS400_TOOLBOX_JDBC_DRIVER_PATH at the Node level.
  6. Double click OS400_TOOLBOX_JDBC_DRIVER_PATH.
  7. 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



In this information ...


Related concepts

IBM Redbooks, demos, education, and more

(Index)

Use IBM Suggests to retrieve related content from ibm.com and beyond, identified for your convenience.

This feature requires Internet access.

Task topic Task topic    

Terms and conditions for information centers | Feedback

Last updatedLast updated: Aug 31, 2013 4:28:44 AM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=pix&product=was-nd-mp&topic=trun_toolbox
File name: tcws_toolbox.html