To archive a record, the record archive flag must be enabled using the Key Data Set Metadata Write service. A SMF type 82 record is generated. The record remains in the key data set. The record can be deleted by the Key Record Delete services. The key material and metadata are deleted when the record is deleted.
To recall an archived record, the record archive flag must be disabled using the Key Data Set Metadata Write service. A SMF type 82 record is generated.
If an application attempts to use an archived record, a SMF type 82 record is generated. The XFACILIT resource CSF.KDS.KEY.ARCHIVE.USE control (see Key Store Policy) determines whether the service request succeeds or fails. If the key archive use control is enabled, the request is allowed to succeed and the return code reflects the processing of the service. If the key archive use control is disabled, the request fails with a return code of 8 and a reason code indicating a record was archived.
In addition to the key archive use control, the key archive message control (KEYARCHMSG keyword in the options data set) causes a joblog message to be issued the first time an archived record is successfully used by an application.