Figure 1 is an example of an activity report with five explicit override records and no global override records.
CRYPTOGRAPHIC CONVERSION ACTIVITY REPORT DATE: 2001/06/01 (YYYY/MM/DD) TIME: 10:13:09 PAGE: 1
OVERRIDE--> CRLABEL3 LOCAL OPINENC Used in transfers to Main Office.
>>>CSFV0192 TYPE FOR KEY ENTRY CRLABEL3 LOCAL CONVERTED TO OPINENC.
>>>CSFV0232 INSTALLATION DATA FOR KEY ENTRY CRLABEL3 OPINENC SET TO Used in transfers to Main Office
OVERRIDE--> CRLABEL3 REMOTE IPINENC Used in receiving from the Main Office
>>>CSFV0192 TYPE FOR KEY ENTRY CRLABEL3 REMOTE CONVERTED TO IPINENC.
>>>CSFV0232 INSTALLATION DATA FOR KEY ENTRY CRLABEL3 IPINENC SET TO Used in receiving from the Main Office.
OVERRIDE--> KGLABEL1 LOCAL OPINENC Used for sending encrypted PINs
>>>CSFV0292 NO KEY ENTRY FOUND FOR KGLABEL1 LOCAL.
OVERRIDE--> LOLABEL2 Valid for January 2001
>>>CSFV0232 INSTALLATION DATA FOR KEY ENTRY LOLABEL2 EXPORTER SET TO Valid for January 2001.
OVERRIDE--> ZZZZ1 LOCAL Y Eliminate Key from output CKDS
>>>CSFV0382 ADD/CHANGE SPECIFICATIONS IGNORED ON OVERRIDE ENTRY. BYPASS_FLAG VALUE IS "Y".
>>>CSFV0292 NO KEY ENTRY FOUND FOR ZZZZ1 LOCAL.
>>>CSFV0012 CONVERSION PROCESSING COMPLETED. RETURN CODE = 4.
CRYPTOGRAPHIC CONVERSION ACTIVITY REPORT DATE: 2001/06/01 (YYYY/MM/DD) TIME: 10:13:09 PAGE: 2
CKDS DDNAME Data Set Name
------------ --------------
CSFVSRC PROD.CUSP.CKDS
CSFVINP TEST.CSF.CKDS
CSFVNEW MERGED.CSF.CKDS
PROCESSING SUMMARY
Source CKDS Entries Converted Entries ICSF Entries
-------------------------------- ----------------------------------- -----------------------------------
LOCAL 4 * Candidates 16 + Changed Input Entries 2
REMOTE 4 Bypassed by Overrides ( 0) Unchanged Input Entries 13
CROSS 4 --------------------------------
----------------------------- -------------------------------- TOTAL ICSF Input Entries 15
* TOTAL Source Entries 12 TOTAL Converted Entries 16 + Entries Added from Source 14
Entries Bypassed by Exit ( 0)
--------------------------------
TOTAL Output ICSF Entries 29
* One Source CKDS CROSS entry converts to two Candidates.
+ Total Converted Entries = Changed Input Entries + Entries Added from Source.
In the report, the first override record specifies that when the conversion program converts a PCF entry labeled CRLABEL3 with a key type of local, the program should convert the entry into an output PIN-encrypting key. The conversion program also places the information Used in transfers to Main Office in the installation data field of the output ICSF CKDS entry.
The second override record specifies that when the conversion program converts a PCF entry labeled CRLABEL3 with a key type of remote, the program should convert the key into an input PIN-encrypting key. The conversion program places the information Used in receiving from the Main Office in the installation data field of the output ICSF CKDS entry.
The label specified by the third override record does not exist in the PCF CKDS. Therefore, the conversion program ignores this override record.
The fourth override record specifies that when the conversion program converts a PCF entry labelled LOLABEL2, the program should place the information Valid for January 2001 in the installation data field of the output ICSF CKDS record.
The label specified by the fifth override record does not exist on the PCF CKDS that the conversion program is converting. Therefore, the conversion program ignores this override record.
The message that the conversion processing has been completed is followed by a return code. Return codes are listed under message CSFV0026 in z/OS Cryptographic Services ICSF Messages.
After describing the five override records, the conversion report lists the data sets the conversion program used in the conversion. PROD.CUSP.CKDS is the PCF CKDS that the program converted. TEST.CSF.CKDS is the input ICSF CKDS containing the ICSF entries input during the conversion. MERGED.CSF.CKDS is the output ICSF CKDS where the conversion program placed the converted entries.
Then the activity report lists totals pertaining to the conversion. The PCF CKDS has a total of 12 entries: four with a key type of local, four with a key type of remote, and four with a key type of cross. Because the conversion of each cross key entry results in two ICSF entries, the total ICSF entries that are candidates for conversion from the PCF is 16. None of these candidates was bypassed because of an override record, so 16 PCF entries were converted.
There were 15 entries in the input ICSF CKDS, and two of these entries were updated because they had identical key labels in the PCF CKDS. Fourteen new output ICSF CKDS entries were added from the PCF CKDS. The total number of entries in the output ICSF CKDS is 29. This includes the 15 entries in the input ICSF CKDS and the 14 entries added from the PCF CKDSN. No entries were bypassed because of the conversion program exit.