Return codes

Table 1 lists return codes from the ICSF callable services.
Table 1. Return Codes
Return Code Hex (Decimal) Description
Return Code 0 (0) The call to the service was successfully processed. See the reason code for more information.
Return Code 4 (4) The call to the service was successfully processed, but some minor event occurred during processing. See the reason code for more information.

User action: Review the reason code.

Return Code 8 (8) The call to the service was unsuccessful. The parameters passed into the call are unchanged, except for the return code and reason code. There are rare examples where output areas are filled, but their contents are not guaranteed to be accurate. These are described under the appropriate reason code descriptions. The reason code identifies which error was found.

User action: Review the reason code, correct the problem, and retry the call.

Return Code C (12) The call to the service could not be processed because ICSF was not active, ICSF found something wrong in its environment, a TSS security product is not available, or a processing error occurred in a TSS product. The parameters passed into the call are unchanged, except for the return code and reason code.

User action: Review the reason code and take the appropriate action.

Return Code 10 (16) The call to the service could not be processed because ICSF found something seriously wrong in its environment or a processing error occurred in the coprocessor. The parameters passed into the call are unchanged, except for the return code and reason code.

User action: Review the reason code and contact your system programmer.

Return Code 14 (20) The call to the service could not be processed because an unexpected error occurred in ICSF's cryptographic software element. The reason codes for this error are not documented.

User action: Contact your IBM support center.

Return Code 18 (24) The call to the service could not be processed because an unexpected error occurred in the Crypto Express Enterprise PKCS #11 coprocessor or Regional Cryptographic Server. The reason codes for this error are not documented.

User action: Contact your IBM support center.

Return Code 19 (25) The call to the service could not be processed because a vendor specific error occurred in the Crypto Express Enterprise PKCS #11 coprocessor or Regional Cryptographic Server. The reason codes for this error are not documented.

User action: Contact your IBM support center.