Setting up the Graphical Toolbox

The Graphical Toolbox is delivered as a set of JAR files. To set up the Graphical Toolbox you must install the JAR files on your workstation and set your CLASSPATH environment variable.

You must also ensure that your workstation meets the requirements to run IBM Toolbox for Java.

Installing the Graphical Toolbox on your workstation

To develop Java programs using the Graphical Toolbox, first install the Graphical Toolbox JAR files on your workstation.  Use one of the following methods:

Transfer the JAR Files
Note: The following list represents some of the methods you can use to transfer the JAR files. The IBM Toolbox for Java licensed program must be installed on your iSeries. Additionally, you need to download the JAR file for JavaHelp, jhall.jar, from the Sun JavaHelp Web site.
Install JAR files with iSeries Access for Windows
You can also install the Graphical Toolbox when you install iSeries Access for Windows. The IBM Toolbox for Java is now shipped as part of iSeries Access for Windows. If you are installing iSeries Access for Windows for the first time, choose Custom Install and select the IBM Toolbox for Java component on the install menu.  If you have already installed iSeries Access for Windows, you can use the Selective Setup program to install this component if it is not already present.

Setting your classpath

To use the Graphical Toolbox, you must add these JAR files to your CLASSPATH environment variable (or specify them on the classpath option on the command line).

For example, if you have copied the files to the directory C:\gtbox\lib on your workstation, you must add the following path names to your classpath:

     C:\gtbox\lib\uitools.jar;
     C:\gtbox\lib\jui400.jar;
     C:\gtbox\lib\data400.jar;
     C:\gtbox\lib\util400.jar;
     C:\gtbox\lib\x4j400.jar;
     C:\gtbox\lib\jhall.jar;

If you have installed the Graphical Toolbox using iSeries Access for Windows, the JAR files (except jhall.jar) will all reside in the directory \Program Files\Ibm\Client Access\jt400\lib on the drive where you have installed iSeries Access for Windows. iSeries Access for Windows installs jhall.jar in the \Program Files\Ibm\Client Access\jre\lib directory. The path names in your classpath should reflect this.

JAR File Descriptions

Note: Internationalized versions of the GUI Builder and Resource Script Converter tools are available.  To run a non-U.S. English version you must add the correct version of uitools.jar for your language and country to your Graphical Toolbox installation. These JAR files are available on the iSeries in /QIBM/ProdData/HTTP/Public/jt400/Mri29xx, where 29xx is the 4-digit OS/400 NLV code corresponding to your language and country. (The names of the JAR files in the various Mri29xx directories include the correct 2-character Java language and country code suffixes.) This additional JAR file should be added to your classpath ahead of uitools.jar in the search order.

Using the Graphical Toolbox

Once you have installed the Graphical Toolbox, follow these links to learn how to use the tools: