137 lines
8.0 KiB
HTML
137 lines
8.0 KiB
HTML
<?xml version="1.0" encoding="UTF-8"?>
|
||
<!DOCTYPE html
|
||
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||
<html lang="en-us" xml:lang="en-us">
|
||
<head>
|
||
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
||
<meta name="security" content="public" />
|
||
<meta name="Robots" content="index,follow" />
|
||
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
|
||
<meta name="DC.Type" content="reference" />
|
||
<meta name="DC.Title" content="Setting up the Graphical Toolbox" />
|
||
<meta name="abstract" content="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." />
|
||
<meta name="description" content="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." />
|
||
<meta name="DC.Relation" scheme="URI" content="pdmlpg1.htm" />
|
||
<meta name="copyright" content="(C) Copyright IBM Corporation 2006" />
|
||
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2006" />
|
||
<meta name="DC.Format" content="XHTML" />
|
||
<meta name="DC.Identifier" content="pdmlbeg" />
|
||
<meta name="DC.Language" content="en-us" />
|
||
<!-- All rights reserved. Licensed Materials Property of IBM -->
|
||
<!-- US Government Users Restricted Rights -->
|
||
<!-- Use, duplication or disclosure restricted by -->
|
||
<!-- GSA ADP Schedule Contract with IBM Corp. -->
|
||
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
|
||
<link rel="stylesheet" type="text/css" href="./ic.css" />
|
||
<title>Setting up the Graphical Toolbox</title>
|
||
</head>
|
||
<body id="pdmlbeg"><a name="pdmlbeg"><!-- --></a>
|
||
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
<h1 class="topictitle1">Setting up the Graphical Toolbox</h1>
|
||
<div><p>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.</p>
|
||
<div class="section"><p>You must also ensure that your workstation meets the <a href="rzahnm04.htm#rzahnm04">requirements
|
||
to run IBM<sup>®</sup> Toolbox
|
||
for Java™</a>.</p>
|
||
</div>
|
||
<div class="section"><h4 class="sectiontitle">Installing the Graphical Toolbox on your workstation</h4><p> To
|
||
develop Java programs using the Graphical Toolbox, first install
|
||
the Graphical Toolbox JAR files on your workstation. Use one of the
|
||
following methods:</p>
|
||
<dl><dt class="dlterm"><strong>Transfer the JAR Files</strong></dt>
|
||
<dd><strong>Note:</strong> 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 <a href="http://www.javasoft.com/products/javahelp/index.html" target="_blank">Sun JavaHelp Web site</a><img src="www.gif" alt="Link outside Information Center" />.<ul><li>Use FTP (ensure you transfer the files in binary mode) and copy the JAR
|
||
files from the directory <strong>/QIBM/ProdData/HTTP/Public/jt400/lib</strong> to a
|
||
local directory on your workstation</li>
|
||
<li>Use iSeries Access
|
||
for Windows<sup>®</sup> to
|
||
map a network drive.</li>
|
||
</ul>
|
||
</dd>
|
||
</dl>
|
||
<dl><dt class="dlterm"><strong>Install JAR files with iSeries Access for Windows</strong></dt>
|
||
<dd>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 <strong>IBM Toolbox for Java</strong> 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.</dd>
|
||
</dl>
|
||
</div>
|
||
<div class="section" id="pdmlbeg__clpath"><a name="pdmlbeg__clpath"><!-- --></a><h4 class="sectiontitle">Setting your classpath</h4><p>To use the Graphical
|
||
Toolbox, you must add these JAR files to your CLASSPATH environment variable
|
||
(or specify them on the <tt>classpath</tt> option on the command line).</p>
|
||
<p>For
|
||
example, if you have copied the files to the directory <strong>C:\gtbox\lib</strong> on
|
||
your workstation, you must add the following path names to your classpath:</p>
|
||
<pre> C:\gtbox\lib\uitools.jar;
|
||
C:\gtbox\lib\jui400.jar;
|
||
C:\gtbox\lib\data400.jar;
|
||
C:\gtbox\lib\util400.jar;
|
||
C:\gtbox\lib\jhall.jar;</pre>
|
||
<div class="p">You also need to add
|
||
an XML parser to your CLASSPATH. For more information, see the following page:<blockquote><a href="rzahhxmlparserxslprocessor.htm">XML parser and XSLT processor</a></blockquote>
|
||
</div>
|
||
<p>If
|
||
you have installed the Graphical Toolbox using iSeries Access for Windows,
|
||
the JAR files (except jhall.jar) will all reside in the directory <strong>\Program
|
||
Files\Ibm\Client Access\jt400\lib</strong> on the drive where you have installed iSeries Access
|
||
for Windows. iSeries Access
|
||
for Windows installs
|
||
jhall.jar in the <strong>\Program Files\Ibm\Client Access\jre\lib</strong> directory.
|
||
The path names in your classpath reflect this.</p>
|
||
</div>
|
||
<div class="section"><h4 class="sectiontitle">JAR File Descriptions</h4><ul><li><strong>uitools.jar</strong>: Contains the GUI Builder and Resource Script
|
||
Converter tools.</li>
|
||
<li><strong>jui400.jar</strong>: 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.</li>
|
||
<li><strong>data400.jar</strong>: 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.</li>
|
||
<li><strong>util400.jar</strong>: Contains utility classes for formatting iSeries data
|
||
and handling iSeries messages.
|
||
These classes may be redistributed with applications.</li>
|
||
<li><strong>jhall.jar</strong>: Contains the JavaHelp classes that displays the
|
||
online help and context sensitive help for the panels you build with the GUI
|
||
Builder.</li>
|
||
<li><strong>XML parser</strong>: Contains the XML parser used by the
|
||
API classes to interpret PDML and PCML documents.</li>
|
||
</ul>
|
||
<div class="note"><span class="notetitle">Note:</span> You can use internationalized versions of the GUI Builder and
|
||
Resource Script Converter tools. To run a non-U.S. English version, you
|
||
must add to your Graphical Toolbox installation the correct version of <strong>uitools.jar</strong>
|
||
for your language and country or region. These JAR files are available on
|
||
the iSeries server
|
||
in <strong>/QIBM/ProdData/HTTP/Public/jt400/Mri29xx</strong>, where 29xx is the 4-digit i5/OS™ NLV
|
||
code that corresponds to your language and country or region. (The names
|
||
of the JAR files in the various Mri29xx directories include 2-character suffixes
|
||
for the Java language code and the country or region code.)
|
||
This additional JAR file is be added to your classpath ahead of <strong>uitools.jar</strong>
|
||
in the search order.</div>
|
||
</div>
|
||
<div class="section"><h4 class="sectiontitle">Using the Graphical Toolbox</h4><p>Once you have installed
|
||
the Graphical Toolbox, follow these links to learn how to use the tools:</p>
|
||
<ul><li><a href="pdmltool.htm#pdmltool__runninggui">Using the GUI Builder</a></li>
|
||
<li> <a href="pdmltool.htm#pdmltool__rc2xmlcall">Using the Resource Script
|
||
Converter</a></li>
|
||
</ul>
|
||
</div>
|
||
</div>
|
||
<div>
|
||
<div class="familylinks">
|
||
<div class="parentlink"><strong>Parent topic:</strong> <a href="pdmlpg1.htm" title="The Graphical Toolbox, a set of UI tools, makes it easy to create custom user interface panels in Java.">Graphical Toolbox and PDML</a></div>
|
||
</div>
|
||
</div>
|
||
</body>
|
||
</html> |