Using the conversion program override file

The conversion program converts all entries in a PCF CKDS into ICSF entries. The conversion program also converts each type of PCF key into a specific ICSF key type. If you want the conversion program to bypass certain key entries or convert a specific key or key type differently than it does by default, use the override file.

By specifying override records, you can have the conversion program:

Bypass conversion of key entries.
Include information in key entries.
Convert key types differently than it does by default.

These actions can relate to entries explicitly identified with a key label or entries that are identified globally.

You specify information in certain fields in an override record and leave other fields blank, depending on the action you want the conversion program to take. You can specify a global record affecting more than one PCF CKDS entry or a record that affects only one PCF CKDS entry.

All the override data set records should be in ascending sequence by key label and old key type. If you use global entries, they must be the initial entries in the override record. Table 1 shows the syntax of a record in the override file.

Note: All the fields should contain character values and be left-justified.

If you specify a key label in an override record, the conversion program processes the key entry identified by that key label. If you do not specify a key label in an override record, you are using a global override record. The conversion program processes all the key labels that pertain to the information specified by the override file.

You can use a global override record to affect all the entries in a CKDS and then use override records to explicitly affect entries you did not want to have that global override record affect.

Table 1. Format of Records in the Override File
Column	Length	Description
1	8	*Key Label* The key label of the PCF entry you want to convert The field can have these values: Blanks A key label existing in the PCF CKDS that you want to convert
9	1	This field must be blank.
10	8	*Old Key Type* The key type of the key entry you want to convert in the PCF CKDS. The field can have these values: Blanks LOCAL REMOTE
18	1	This field must be blank.
19	8	*New Key Type* The key type that you want the converted key entry to be in the ICSF CKDS. The master key variant for the key type enciphers the key in the ICSF CKDS entry that the conversion program creates. The field can have these values: Blanks OPINENC EXPORTER IPINENC IMPORTER
27	1	This field must be blank.
28	8	*Ignored* In ICSF/MVS Version 1 Release 1, this field contained the key qualifier. The CKDS for ICSF/MVS Version 1 Release 2 or above does not support key qualifiers. If your installation has a PCF conversion program override file created with ICSF/MVS Version 1 Release 1, you can still use it with z/OS ICSF. Any key qualifier entries are ignored.
36	1	This field must be blank.
37	1	*Bypass Flag* Used to indicate that an input CKDS entry is not to be included in the new ICSF CKDS. If you set this field to `Y`, the conversion program does not convert the entry. The field can have these values: Blank (same as N) N Y
38	1	This field must be blank.
39	52	*Installation Data* Any additional information your installation records about a key. The information appears in the installation data field of the new ICSF CKDS. The field can contain any value.