Delete Key Record (QC3DLTKR, Qc3DeleteKeyRecord) API


  Required Parameter Group:

1 Qualified keystore file name Input Char(20)
2 Record label Input Char(32)
3 Error code I/O Char(*)

 Service Program Name: QC3KRDLT

 Default Public Authority: *USE

 Threadsafe: Yes

The Delete Key Record (OPM, QC3DLTKR; ILE, Qc3DeleteKeyRecord) API deletes a key record from a keystore file.

For more information about cryptographic services keystore, see Cryptographic services key management.


Authorities and Locks

Required file authority
*OBJOPR, *DLT


Required Parameter Group

Qualified keystore file name
INPUT; CHAR(20)

The keystore file from which the key record will be deleted. The first 10 characters contain the file name. The second 10 characters contain the name of the library where the keystore file is located. You can use the following special values for the library name.

*CURLIB The job's current library is used to locate the keystore file. If no library is specified as the current library for the job, the QGPL library is used.
*LIBL The job's library list is searched for the first occurence of the specified file name.

Record label
INPUT; CHAR(32)

The label of a key record in the specified keystore file. The label will be converted from the job CCSID, or if 65535, the job default CCSID (DFTCCSID) job attribute to CCSID 1200 (Unicode UTF-16).

Error code
I/O; CHAR(*)

The structure in which to return error information. For the format of the structure, see Error code parameter.


Error Messages

Message ID Error Message Text
CPF24B4 E Severe error while addressing parameter list.
CPF3C1E E Required parameter &1 omitted.
CPF3CF1 E Error code parameter not valid.
CPF3CF2 E Error(s) occurred during running of &1 API.
CPF9872 E Program or service program &1 in library &2 ended. Reason code &3.
CPF9D88 E An error occurred during exit program post-processing.
CPF9D89 E An error occurred during exit program pre-processing.
CPF9D8F E Keystore record was not deleted due to an exit program cancel.
CPF9D9F E Not authorized to keystore file.
CPF9DA0 E Error occured opening keystore file.
CPF9DA1 E Key record not found.
CPF9DA5 E Keystore file not found.
CPF9DB3 E Qualified keystore file name not valid.
CPF9DB6 E Record label not valid.
CPF9DB9 E Error occured deleting record from keystore.

API introduced: V5R4

[ Back to top | Cryptographic Services APIs | APIs by category ]