This publication uses a general call format to show the name of the ICSF callable service and its parameters. An example of that format is shown here:

CALL CSNBxxx (return_code,
              reason_code,
              exit_data_length,
              exit_data,
              parameter_5,
              parameter_6,
              .
              .
              .
              parameter_N)

where CSNBxxx is the name of the callable service. The return code, reason code, exit data length, exit data, parameter 5 through parameter N represent the parameter list. The call generates a fixed length parameter list. You must supply the parameters in the order shown in the syntax diagrams. Parameter Definitions describes the parameters in more detail.

ICSF callable services can be called from application programs written in a number of high-level languages as well as assembler. The high-level languages are:

• C
• COBOL
• FORTRAN
• PL/I

The ICSF callable services comply with the IBM Common Cryptographic Architecture: Cryptographic Application Programming Interface. The services can be invoked using the generic format, CSNBxxx. Use the generic format if you want your application to work with more than one cryptographic product. The format CSFxxxx can be used in place of CSNBxxx. Otherwise, use the CSFxxxx format.

Specific formats for the languages that can invoke ICSF callable services are as follows:

• C

  CSNBxxxx (return_code,reason_code,exit_data_length,exit_data,
  parameter_5,...parameter_N)

• COBOL

  CALL ‘CSNBxxxx’ USING return_code,reason_code,exit_data_length,
  exit_data,parameter_5,...parameter_N

• FORTRAN

  CALL CSNBxxxx (return_code,reason_code,exit_data_length,exit_data,
  parameter_5,...parameter_N)

• PL/I

  DCL CSNBxxxx ENTRY OPTIONS(ASM);
  CALL CSNBxxxx return_code,reason_code,exit_data_length,exit_data,
  parameter_5,...parameter_N;
   

• Assembler language programs must use standard linkage conventions when invoking ICSF callable services. An example of how an assembler language program can invoke a callable service is shown as follows:

  CALL CSNBxxxx,(return_code,reason_code,exit_data_length,exit_data,
  parameter_5,...parameter_N)

Coding examples using the high-level languages are shown in Appendix D. Coding Examples.