To efficiently run IBM Toolbox for Java on your iSeries system, you need to understand the following issues:
Because you can use IBM Toolbox for Java both on your server and your client, the compatibility issues affect both running on a server and connecting from a client back to a server.
To install IBM Toolbox for Java (licensed program 5722-JC1 V5R1M0) on an iSeries system, the server must be running one of the following:
You can install only one version of the IBM Toolbox for Java licensed program on the system. To install a different version, first remove the existing IBM Toolbox for Java licensed program.
You can use different versions of IBM Toolbox for Java on a client and on the server to which you are connecting. To use IBM Toolbox for Java, Version 5 Release 1, to access data and resources on an iSeries system, the server to which you are connecting must be running one of the following:
The table below shows how different versions of IBM
Toolbox for Java are compatible with different releases of
OS/400.
Table: Compatibility requirements for installing on and connecting back to different versions of OS/400
Toolbox modification | Ships with OS/400 | LPP | Installs on OS/400 | Connects back to OS/400 |
---|---|---|---|---|
Mod 0 | V4R2 | 5763-JC1 V3R2M0 | V3R2 and above | V3R2 and above |
Mod 1 | V4R3 | 5763-JC1 V3R2M1 | V3R2 and above | V3R2 and above |
Mod 2 | V4R4 | 5769-JC1 V4R2M0 | V4R2 and above | V4R2 and above |
Mod 3 | V4R5 | 5769-JC1 V4R5M0 | V4R3 and above | V4R2 and above |
Mod 4 | V5R1 | 5722-JC1 V5R1M0 | V4R4 and above | V4R3 and above |
Native optimizations are a set of functions that affect operation of IBM Toolbox for Java when running on the iSeries JVM. The optimizations are:
The optimizations exist to make the IBM Toolbox for Java classes work the way a user would expect them to work when running on OS/400.
Note: It is very important to understand that your Java programs use native optimizations only when you use the version of IBM Toolbox for Java that matches the version of OS/400 on your server.
No change to the Java application is needed to get the optimizations. IBM Toolbox for Java automatically enables the optimizations when appropriate.
When the versions of IBM Toolbox for Java and OS/400 do not match, native optimizations are not available. In this case, IBM Toolbox for Java works as if it is running on a client.
The table below shows which versions of IBM Toolbox for Java and OS/400 you must run to get use native optimizations. This table documents only compatibility issues that affect native optimizations. The previous table shows general compatibility issues between IBM Toolbox for Java and OS/400.
Table: Compatibility requirements for using native optimizations
Level of OS/400 | Level of IBM Toolbox for Java | ||||
---|---|---|---|---|---|
V3R2M0 | V3R2M1 | V4R2M0 | V4R5M0 | V5R1M0 | |
V4R2 | No IBM Toolbox for Java performance enhancements are available. | ||||
V4R3 |
|
|
|||
V4R4 |
|
|
|||
V4R5 |
|
||||
V5R1 |
|
An 'X' indicates that performance enhancements are enabled for a given configuration of IBM Toolbox for Java and OS/400.
In order to gain the performance improvements, you need to make
sure to use the jar file that includes OS/400 native optimizations.
For more information, see
Note 1 in Jar files.
Using IBM Toolbox for Java may require you to address some dependencies that it has on OS/400 and on other licensed programs.
Running IBM Toolbox for Java in a client/server environment requires that you enable the QUSER user profile, start the host servers, and have TCP/IP running. Perform these actions from an iSeries command line by running the following commands:
Note: To run TCP/IP, you must have the TCP/IP Connectivity
Utilities for AS/400 (licensed program
5722-TC1
)
installed on the server. For more information on host server options and TCP/IP,
see the TCP/IP topic in the iSeries Information
Center.
When you want to use the spooled file viewer functions (SpooledFileViewer class) of IBM Toolbox for Java, ensure that you have installed host option 8 (AFP Compatibility Fonts) on your server.
Note: SpooledFileViewer, PrintObjectPageInputStream, and PrintObjectTransformedInputStream classes work only when connecting to V4R4 or later systems.
When you want to use Secure Sockets Layer (SSL), ensure that you have installed the following:
The V5R1 version of IBM Toolbox for Java requires
that you use the V5R1 version of Client Encryption. The 128-bit
version of Client Encryption is compatible with both the 56- and
128-bit versions of Cryptographic Access Provider listed above. In
other words, when 5722-CE3 is installed, you can use 5722-AC3 or
5722-AC2.
Note: You can use SSL support only when connecting to V4R4 and later iSeries systems. For more information on SSL, see Secure Sockets Layer.