Use this service to modify an exportable internal DES key token so that it cannot be exported.
The callable service name for AMODE(64) invocation is CSNEPEX.
CALL CSNBPEX(
return_code,
reason_code,
exit_data_length,
exit_data,
key_identifier)
| Direction | Type |
|---|---|
| Output | Integer |
The return code specifies the general result of the callable service. ICSF and cryptographic coprocessor return and reason codes lists the return codes.
| Direction | Type |
|---|---|
| Output | Integer |
The reason code specifies the result of the callable service that is returned to the application program. Each return code has different reason codes that indicate specific processing problems. ICSF and cryptographic coprocessor return and reason codes lists the reason codes.
| Direction | Type |
|---|---|
| Input/Output | Integer |
The length of the data that is passed to the installation exit. The data is identified in the exit_data parameter.
| Direction | Type |
|---|---|
| Input/Output | String |
The data that is passed to the installation exit.
| Direction | Type |
|---|---|
| Input/Output | String |
A 64-byte string variable containing the internal key token to be modified. The returned key_identifier will be encrypted under the current master key.
ICSF supports two methods of wrapping the key value in a symmetric key token: the original ECB wrapping and an enhanced CBC wrapping method which is ANSI X9.24 compliant. The output key_identifier will be wrapped in the same manner as the input key_identifier.
SAF may be invoked to verify the caller is authorized to use this callable service, the key label, or internal secure key tokens that are stored in the CKDS or PKDS.
The Prohibit Export access control point controls the function of this service.
This table lists the required cryptographic hardware for each server type and describes restrictions for this callable service.
| Server | Required cryptographic hardware | Restrictions |
|---|---|---|
IBM eServer zSeries 990 |
PCI X Cryptographic Coprocessor Crypto Express2 Coprocessor |
DATA keys are not supported. Old, internal DATAM and DATAMV keys are not supported. |
IBM System z9 EC |
Crypto Express2 Coprocessor | DATA keys are not supported. Old, internal DATAM and DATAMV keys are not supported. |
IBM System z10 EC |
Crypto
Express2 Coprocessor Crypto Express3 Coprocessor |
DATA keys are not supported. Old, internal DATAM and DATAMV keys are not supported. |
IBM zEnterprise 196 |
Crypto Express3 Coprocessor | DATA keys are not supported. Old, internal DATAM and DATAMV keys are not supported. |
IBM zEnterprise EC12 |
Crypto Express3 Coprocessor Crypto Express4 CCA Coprocessor |
DATA keys are not supported. Old, internal DATAM and DATAMV keys are not supported. |
IBM z13 |
Crypto Express5 CCA Coprocessor | DATA keys are not supported. Old, internal DATAM and DATAMV keys are not supported. |