Calling CCA verbs in C program syntax

In every operating system environment, you can code CCA API verb calls using standard C programming language syntax.

Function call prototypes for all CCA security API verbs are contained in a header file. The files and their default distribution locations are:

AIX: /usr/include/

To include these verb declarations, use the following compiler directive in your program:

AIX: #include "csufincl.h"

To issue a call to a CCA security API verb, code the verb entry-point name in uppercase characters. Separate the parameter identifiers with commas and enclose them in parentheses. End the call with a semicolon character. For example:

      CSNBCKI (&return_code,
               &reason_code,
               &exit_data_length,    /* exit_data_length */
               exit_data,            /* exit_data        */
               clear_key,
               key_token);

Note: The third and fourth parameters of a CCA call, exit_data_length and exit_data, are not currently supported by the CCA Cryptographic Coprocessor Support Program. Although it is permissible to code null address pointers for these parameters, it is preferred that you specify a long integer valued to 0 with the exit_data_length parameter.