The IBM Toolbox for Java is a library of Java classes supporting the client/server and internet programming model to an IBM i system. The classes can be used by Java applets, servlets, and applications to easily access IBM i data and resources. The Toolbox does not require additional client support over and above what is provided by the Java Virtual Machine and JDK.
The IBM Toolbox for Java provides support similar to functions available when using the IBM i Access APIs. It uses the IBM i host servers that are part of the base IBM i operating system to access data and resources on an IBM i system. Each of these host servers runs in a separate job on the system, communicating with a Java client program using architected data streams on a socket connection. The socket interfaces are hidden from the Java programmer by the IBM Toolbox for Java classes. Since the socket connections are managed by Toolbox classes, IBM i Access is not needed on the workstation.
Java Beans are provided for most public interfaces.
- Access IBM i resources
- Graphical User Interfaces present data to the user
The IBM Toolbox for Java provides a set of graphical user interface (GUI) classes to retrieve and present data to the user. The graphical user interface classes access and manipulate data on an IBM i system by using the classes mentioned in the previous section along with Sun's Java Foundation Classes (JFC/Swing) to display the data to the user.
Server panes are components used to present and allow manipulation of one or more IBM i resources. All panes extend on the Java Component class, thus they can be added to any Container, Window, or AWT Frame. The IBM Toolbox for Java provides the following panes:
Server panes can be used with the following IBM i resources: Integrated File System, jobs, messages, print resources, users and groups.
In addition to server panes, the IBM Toolbox for Java provides other GUI components that extend JFC/Swing classes for the following IBM i resources:
- Additional classes
- New classes
IBM Toolbox for Java V5R4 features many new classes in the existing access package. The new classes enable you to:
For more information about new classes, see the associated package documentation.
- Enhanced classes
IBM Toolbox for Java V5R4 also includes enhancements to existing classes. These enhancements offer:
- Deprecated packages
Several packages have been deprecated since V5R3. These packages include:
- Deprecated classes
Several classes have been deprecated since V5R3. These classes include:
- Toolbox is Java
The IBM Toolbox for Java requires a Java virtual machine that fully supports JDK 1.1.8 or any later JDK, including Java 2. Many new IBM Toolbox for Java functions require using version 1.4 or higher of the JVM. If your program uses the Graphical Toolbox or classes in the vaccess package, Swing 1.1 is also required. For Java applications, the Toolbox has been tested on Java Virtual Machines on at least the following platforms:
For Java applets, IBM Toolbox for Java no longer supports running in the default JVM in Netscape(R) Navigator or Microsoft(R) Internet Explorer. For your applet that uses Toolbox for Java classes to run in a browser, you should install a plug-in such as the Sun Java 2 Runtime Environment (JRE) 1.3.0 plug-in.
Toolbox for Java no longer includes data400.jar. The classes that were in data400.jar are now in jt400.jar. Remove data400.jar from your CLASSPATH statements.
You can not use this release of IBM Toolbox for Java to deserialize some objects that you serialized using releases prior to V5R1.
- Secure sockets
If you are using Secure Sockets Layer (SSL) to encrypt data flowing between the client and the server, you must use one of the following:
- Application development
- IBM i requirements
In order to connect to the IBM i system and access its data and services, the IBM Toolbox for Java requires both the TC1 Licensed Program (TCP/IP Connectivity Utilities for IBM i) and the Host Server option of IBM i to be installed and configured on the system.