IBM 4764 PCI-X Cryptographic Coprocessor

Building Java applications to use with the CCA API

Application programmers who have Release 3.30.05 or later of the IBM 4764 Cryptographic Coprocessor installed can now build Java applications to use with the Common Cryptographic Architecture (CCA) Support Program. Users who have Release 3.30.05 installed can also fix a problem using the CNM utility with Java Platform, Standard Edition (Java SE) Version 1.6.0_13 or later. Later releases of CCA do not have this problem.

The following is for Release 3.30.05 users only.

Release 3.30.05 users who want to fix the CNM utility problem or to enable application programmers who want to build Java applications on the Microsoft Windows, Novell SUSE Linux, and Red Hat Linux operating systems, follow these steps:

1. Release 3.30.05 of the IBM 4764 Cryptographic Coprocessor is required.

2. Download the Java-for-IBM-4764-3.30.06.zip (547KB) file and extract the files. These files will be copied to their distribution locations in the following steps.

3. Make a backup copy of your CCA Support Program installation.

4. The extracted HIKM.zip file replaces the existing HIKM.zip file. Copy the extracted HIKM.zip file to its distribution location. The default distribution location of this file is shown in the following table:

Operating system Default distribution location
Linux /opt/IBM/4764/cnm
Windows \Program Files\IBM\4764\cnm

5. Copy these three new files to their distribution location:


The default distribution location of these files is shown in the following table:

Operating system Default distribution location
Linux /opt/IBM/4764/samples
Windows \Program Files\IBM\4764\samples

6. Linux users only:

File Permissions
/opt/IBM/4764/cnm/HIKM.zip 440
/opt/IBM/4764/samples/hikmNativeInteger.html 666
/opt/IBM/4764/samples/Java-for-IBM-4764-HOWTO.txt 666
/opt/IBM/4764/samples/mac.java 666
/usr/libHIKM.so.1.3.0 755

7. Windows users only:
The extracted hikm.dll file replaces the existing hikm.dll library. Copy the hikm.dll file to its distribution location. The default distribution location of this file is:
\Program Files\IBM\4764
Note: The libHIKM.so.1.3.0 file is for Linux users only.

8. Programmers should follow the instructions provided in the Java-for-IBM-4764-HOWTO.txt file to build Java applications to use with the CCA Support Program.