Previous topic |
Next topic |
Contents |
Contact z/OS |
Library |
PDF
gsk_add_record() z/OS Cryptographic Services System SSL Programming SC14-7495-00 |
|
Adds a record to a key or request database.
Format
Parameters
ResultsThe function return value will be
0 if no error is detected. Otherwise, it will be one of the return
codes listed in the gskcms.h include file. These are some
possible errors:
UsageThe gsk_add_record() routine adds a record to a key or request database. The database must be open for update in order to add records. Unused and reserved fields in the gskdb_record structure must be initialized to zero. An error will be returned when adding a certificate to a key database if the database already contains the certificate. If the record has a private key, the encrypted private key will be generated from the private key supplied in the database record. The recordType field
identifies the database record type as follows:
The recordFlags field is a bit field
with these values:
A unique record identifier is assigned when the record is added to the database and will be returned to the application in the recordId field. If the record contains an X.509 certificate, the issuerRecordId field will be set to the record identifier of the certificate issuer. The record label is used as a friendly name for the database entry and is in the local code page. It can be set to any value and consists of characters which can be represented using 7-bit ASCII (letters, numbers, and punctuation). It may not be set to an empty string. If the record contains an X.509 certificate, the certificate will be validated and the record will not be added to the database if the validation check fails. If the database is a FIPS key database, then the certificate must use only FIPS algorithms and key sizes. Except for the record label, all character strings are specified using UTF-8. The database file is updated as part of the gsk_add_record() processing. A temporary database file is created using the same name as the database file with ".new" appended to the name. The database file is then overwritten and the temporary database file is deleted. The temporary database file will not be deleted if an error occurs while rewriting the database file. |
Copyright IBM Corporation 1990, 2014
|