| 1 | Qualified keystore file name | Input | Char(20) |
| 2 | Master key ID | Input | Binary(4) |
| 3 | Public authority | Input | Char(10) |
| 4 | Text description | Input | Char(50) |
| 5 | Error code | I/O | Char(*) |
The Create Keystore (OPM, QC3CRTKS; ILE, Qc3CreateKeyStore) API creates a database file for storing cryptographic key values for use with the cryptographic services set of APIs.
For more information about cryptographic services keystore, see Cryptographic services key management.
The keystore file to be created. The first 10 characters contain the file name. The second 10 characters contain the name of the library in which the keystore file will be located.
You can use the following special value for the library name.
| *CURLIB | The job's current library is used for the keystore file. If no library is specified as the current library for the job, the QGPL library is used. |
The master key under which the key values will be encrypted before storing in the keystore file. 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 |
The authority you give to users who do not have specific private or group authority to the keystore file.
| *ALL | The user can perform all authorized operations on the keystore file. |
| Authorization list name | The keystore file is secured by the specified authorization list, and its public authority is set to *AUTL. |
| *CHANGE | The user has read, add, update, and delete authority for the keystore file and can read the object description. |
| *EXCLUDE | The user cannot access the keystore file in any way. |
| *LIBCRTAUT | The public authority for the keystore file is taken from the CRTAUT value for the target library when the file is created. |
| *USE | The user can read the object description and contents, but cannot change the keystore file. |
A brief description of the keystore file.
The structure in which to return error information. For the format of the structure, see Error code parameter.
| 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. |
| CPF9D9D E | Unexpected error while setting keystore attributes. |
| CPF9DA0 E | Error occured opening keystore file. |
| CPF9DAD E | The master key ID is not valid. |
| CPF9DB3 E | Qualified keystore file name not valid.. |
| CPF9DB4 E | Value &1 for public authority is not valid. |
| CPF9DB5 E | Keystore file &1 not created. |
| CPF9DB7 E | Error occured writing to keystore. |
[ Back to top | Cryptographic Services APIs | APIs by category ]