| 1 | Master key ID | Input | Binary(4) |
| 2 | Master key version | Input | Char(1) |
| 3 | Error code | I/O | Char(*) |
The Clear Master Key (OPM, QC3CLRMK; ILE, Qc3ClearMasterKey) API clears the specified master key version. Before clearing an old master key version, care should be taken to ensure no keys or data are are still encrypted under it.
For more information about master keys, see Cryptographic services key management.
For all master keys except the Save/Restore Master Key, the key and KVV for the specified version are set to null (binary 0). Clearing the Save/Restore Master Key sets the key value for the specified version to the default value with a KVV of hexadecimal '16C1D3E3C073E77DB28F33E81EC165313318CE54'.
The master key IDs are
| 1 | Master key 1 |
| 2 | Master key 2 |
| 3 | Master key 3 |
| 4 | Master key 4 |
| 5 | Master key 5 |
| 6 | Master key 6 |
| 7 | Master key 7 |
| 8 | Master key 8 |
| -1 | ASP master key |
| -2 | Save/restore master key |
The version of the master key
| 0 | New version |
| 1 | Current version |
| 2 | Old version |
| 3 | Pending version Not valid for *SAVRST Master Key. |
The structure in which to return error information. For the format of the structure, see Error code parameter.
| Message ID | Error Message Text |
|---|---|
| CPF222E E | &1 special authority is required. |
| 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. |
| CPD9D88 E | An error occurred during exit program post-processing. |
| CPD9D89 E | An error occurred during exit program pre-processing. |
| CPF9D91 E | Master Key &1 was not cleared due to an exit program cancel. |
| CPF9DAD E | The master key ID is not valid. |
| CPF9DAE E | The master key version is not valid. |
| CPF9DDA E | Unexpected return code &1. |
[ Back to top | Cryptographic Services APIs | APIs by category ]