IBM Support

Using IBM Toolbox for Java with Native Optimizations

Troubleshooting


Problem

This document describes the native optimizations for the IBM Toolbox for Java (toolbox), a set of classes optimized for a toolbox program running on an IBM i Java virtual machine.

Resolving The Problem

Description of native optimizations

Native optimizations are a set of functions that can affect IBM Toolbox for Java (toolbox) operations when running on an IBM i Java virtual machine (JVM). The optimizations provide the following primary features when running in this environment.
  • Sign-On

    When no user profile or password is set in the AS400 object, the user profile and password from the current job are used to establish a connection. This also affects JDBC because the Connection object internally implements an AS400 object. The host servers require passwords in order to allow a connection even in the case where no networking is used.  Therefore, the user profile must have a password; it cannot be set to *NONE and be able to make a connection to a host server.
  • Socket calls

    When the toolbox is used to establish a connection for record-level database access, data queues, program calls, command calls, or user space operations, it uses calls to operating system APIs to perform the operations. Toolbox uses the direct API calls rather than socket calls to the operating system host servers.

Enabling native optimizations

The only requirement for enabling native optimizations is that the correct JAR file is added to the class path of the Java application. If the appropriate JAR file is added to the class path and the JVM is running on a System i server, the native optimizations are used.

Operating system V5R1 and later

When the Java application is running on the V5R1 operating system or later, add the jt400Native.jar file to the class path. This file contains all of the jt400.jar classes and the additional classes required for native optimizations. Because all access classes and native classes are included, the jt400.jar file is not required, do not add it to the class path. The jt400Native.jar file can be found in the following directory:

/QIBM/ProdData/OS400/jt400/lib/jt400Native.jar

Operating system V4R5 and earlier

If the release of the operating system is V4R5 or earlier, the jt400ntv.jar file must be added to the class path. This file contains only the native optimizations; therefore, the jt400.jar file must remain in the class path. The jt400ntv.jar file can be found in the following path:

/QIBM/ProdData/OS400/Java400/jt400ntv.jar

[{"Product":{"code":"SWG60","label":"IBM i"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Component":"Data Access","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"Version Independent","Edition":"","Line of Business":{"code":"LOB57","label":"Power"}}]

Historical Number

25713522

Document Information

Modified date:
23 December 2019

UID

nas8N1017121