OS/400 requirements for running IBM Toolbox for Java

To efficiently run IBM Toolbox for Java on your iSeries system, you need to understand the following issues:

Compatibility with different levels of OS/400

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.

Running IBM Toolbox for Java, Version 5 Release 1, on your servers

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.

Using IBM Toolbox for Java to connect from a client back to the server

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:

Begin changeThe 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 when running on the iSeries JVM

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  
X
X
   
V4R4  
X
X
   
V4R5      
X
 
V5R1        
X

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.End change

Dependencies on OS/400 and other licensed programs

Using IBM Toolbox for Java may require you to address some dependencies that it has on OS/400 and on other licensed programs.

Dependencies on OS/400

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:

  1. Type DSPUSRPRF USRPRF(QUSER) and press ENTER to enable the QUSER user profile. The resulting display shows the status for QUSER.
  2. Type STRHOSTSVR and press ENTER to start the OS/400 host servers.
  3. Type STRTCPSVR SERVER(*DDM) to start the TCP/IP server (with *DDM specified for the Server parameter).

Note: To run TCP/IP, you must have the TCP/IP Connectivity Utilities for AS/400 (licensed program Begin change 5722-TC1End change) installed on the server. For more information on host server options and TCP/IP, see the TCP/IP topic in the iSeries Information Center.

Dependencies on other licensed programs

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:

Begin changeThe 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.End change

Note: You can use SSL support only when connecting to V4R4 and later iSeries systems. For more information on SSL, see Secure Sockets Layer.