How to compile and link CCA application programs

The CCA RPM includes C libraries that you can use to build CCA C applications.

One of these libraries also supports a Java™ Native Interface (JNI) that you can use to build CCA Java applications. The CCA RPM also includes Java libraries with front end classes for the JNI.

The C libraries and their default distribution locations are:

/usr/lib64/libcsulcca.so.*

The libcsulcca.so library is the main interface library to most CCA interface calls. It contains all CCA verbs apart from the Master Key Process (CSNBMKP) verb. The names of the verbs and their parameters are listed in the C header file csulincl.h.

This library also contains the C support for the JNI.

/usr/lib64/libcsulccamk.so.*

This library contains the Master Key Process (CSNBMKP) verb and is required for applications that use the master key process (see Using the Master Key Process (CSNBMKP) verb).

CCA 5.0 includes two versions of the Java libraries:

New version introduced with CCA 4.2

As of CCA 4.2, new Java libraries that use the Java package infrastructure are included. These Java libraries and their default distribution locations are:

/opt/IBM/CCA/cnm/CNM.jar

This library contains the data classes used by the JNI (see Entry points and data types used in the JNI) and most JNI verb front end classes.

/opt/IBM/CCA/cnm/CNMMK.jar

This library contains the JNI front end class for the Master Key Process (CSNBMKP) verb.

Deprecated version - removed starting with CCA 5.0

Note that the CCA 5.0 rpm no longer contains the files mentioned in this section. However, CCA 4.2 still includes the Java libraries of earlier CCA versions to support your existing applications. These libraries contain all verbs available with CCA 4.2 but future additions will not be available in these libraries. The default distribution locations of these deprecated libraries are:

/opt/IBM/CCA/cnm/HIKM.zip

This library contains the data classes used by the JNI (see Entry points and data types used in the JNI) and most JNI verb front end classes.

/opt/IBM/CCA/cnm/HIKMMK.zip

This library contains the JNI front end class for the Master Key Process (CSNBMKP) verb.

See Calling the CCA JNI using the Java package infrastructure for more information about the two versions of the Java libraries.

The CCA RPM also includes C and Java sample programs that help you develop your application (see Building C applications using the CCA libraries and JNI sample modules and sample code).