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. There
are two ways to do this:
- Transfer the JAR Files
- Note: The following list represents three
different ways 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. 
- Use FTP (ensure you transfer the files in binary mode) and copy
the JAR files from the directory
/QIBM/ProdData/HTTP/Public/jt400/lib to a local directory
on your workstation
- Use IBM iSeries Client Access Express to map a network drive.
- The AS400ToolboxInstaller class that comes with the IBM Toolbox
for Java can also be used to install the Graphical Toolbox JAR
files - specify OPNAV for the package name. For more information,
see Client installation and update
classes.
- Install JAR files with Client Access
Express
- You can also install the Graphical Toolbox when you install
Client Access Express. The IBM Toolbox for Java is now
shipped as part of Client Access Express. If you are
installing Client Access Express for the first time, choose Custom
Install and select the IBM Toolbox for Java
component on the install menu. If you have already installed
Client Access Express, you can use the Selective Setup program to
install this component if it is not already present.
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 Client Access
Express, 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
Client Access Express.
Client Access Express 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
- uitools.jar Contains the GUI Builder and
Resource Script Converter tools.
- jui400.jar Contains the runtime API for
the Graphical Toolbox. Java programs use this API to display
the panels constructed using the tools. These classes may be
redistributed with applications.
- data400.jar Contains the runtime API for the Program
Call Markup Language (PCML). Java programs use this API to call iSeries programs
whose parameters and return values are identified using PCML. These
classes may be redistributed with applications.
- util400.jar Contains utility classes for formatting
iSeries data and handling iSeries messages. These classes may be redistributed
with applications.
- x4j400.jar Contains the XML parser used
by the API classes to interpret PDML and PCML documents.
jhall.jar Contains the
JavaHelp classes that displays the online help and context
sensitive help for the panels you build with the GUI Builder.

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: