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.
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 AS/400 Toolbox for Java licensed program must
be installed on your AS/400.
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 Client Access/400 to map a network drive.
- The AS400ToolboxInstaller class that comes with the AS/400 Toolbox for
Java can also be used to install the Graphical Toolbox JAR files - specify
the package name "OPNAV". 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 AS/400 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 AS/400 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.
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:\jt400\lib
on your workstation, you must add the following path names to your classpath:
C:\jt400\lib\uitools.jar;
C:\jt400\lib\jui400.jar;
C:\jt400\lib\data400.jar;
C:\jt400\lib\util400.jar;
C:\jt400\lib\x4j400.jar;
C:\jt400\lib\jhall.jar;
If you have installed the Graphical Toolbox using Client Access
Express, the JAR files will all reside in the directory
\Program Files\Ibm\Client Access\jt400\lib on the drive
where you have installed Client Access Express. 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 AS/400 programs whose parameters and return values are
identified using PCML. These classes may be redistributed
with applications.
- util400.jar Contains utility classes for
formatting AS/400 data and handling AS/400 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 create 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 AS/400 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: