AS/400 Toolbox for Java \
Graphical Toolbox \ Setting up
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.
- 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;
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.
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: