Steps for creating a RENAME control statement

The Create RENAME Control Statement panel appears. The RENAME control statement changes the label of a key entry in a CKDS. To create a RENAME control statement:

Choose option 2 on the KGUP Control Statement Menu, as shown in Figure 1.

Figure 1. Selecting the Rename Option on the KGUP Control Statement Menu Panel

 CSFCSM00 ----------- ICSF - KGUP Control Statement Menu ------------
 OPTION ===> 2

   Storage data set for control statements   (DDNAME = CSFIN)

   Data Set Name: LARSON.CSFIN.TESTDS1P(TEST2)


    Enter the number of the desired option above.

    1  Maintain       - Create ADD, UPDATE, or DELETE control statements
    2  Rename         - Create statement to RENAME entry label
    3  Set            - Create a statement to SET installation data
    4  Edit           - Edit the statement storage data set

See Figure 2. If you leave this field blank, the On this panel, you enter information in the fields to create a RENAME control statement. This panel creates a RENAME control statement according to the syntax described in Syntax of the RENAME Control Statement. See that topic for more information about the RENAME control statement keywords.

Figure 2. Create RENAME Control Statement Panel

 CSFCSE20 --------- ICSF - Create RENAME Control Statement ----------
 COMMAND ===>

 Enter the following information:

    Existing Key Label
      ________________________________________________________________

    New Key Label
      ________________________________________________________________

    Key Type           ===> ________         Selection panel displayed if blank

    Comment Line       ===> _____________________________________________

 Press ENTER to create and store control statement
 Press END   to exit to the previous panel

In the Existing Key Label field, specify the current label on the CKDS that you want KGUP to change.
In the New Key Label field, specify the new label that you want to replace the existing label.

In the Key Type field, specify the key type of the key entry whose label you want changed. Key Type Selection panel appears. See Figure 3.

Figure 3. Selecting a Key Type on the Key Type Selection Panel

 CSFCSE12--------- ICSF - Key Type Selection Panel ----- ROW 1 To 13 OF 11
 COMMAND ===>                                                  SCROLL ===> PAGE

 Select one key type only
     KEY TYPE      DESCRIPTION

    CIPHER     Data encryption/decryption key
    CIPHERXI   Input cipher text transaction key
    CIPHERXL   Cipher text transaction key
    CIPHERXO   Output cipher text transaction key
    CLRAES     Clear AES encryption/decryption key
    CLRDES     Clear DES encryption/decryption key
    DATA       Encryption/Decryption key
    DATAM      Double-length MAC generation key
    DATAMV     Double-length MAC verification key
    DECIPHER   Data decryption key
    DKYGENKY   Diversified key-generating key
    ENCIPHER   Data encryption key
    EXPORTER   Export key encrypting key
    IMPORTER   Import key encrypting key
    IMPPKA     Limited authority key encrypting key
    IPINENC    Input PIN encrypting key
    KEYGENKY   Key-generating key
    MAC        MAC generate key
    MACVER     MAC verify key
    NULL       Used to create CKDS entry
    OPINENC    Output PIN encrypting key
    PINGEN     PIN generation key
    PINVER     PIN verification key 
    PINVER     PIN verification key
********************************BOTTOM OF DATA*********************************

Type s to the left of the key type you want to specify.
In Figure 3, the exporter key is selected.
Press ENTER to return to the Create RENAME Control Statement panel.
The RENAME control statement The key type you choose on the Key Type Selection panel appears in the key type field.

An example of a Create RENAME Control Statement panel which creates a control statement to change the key label JWL@SSIDEC95 to JWL@SSIJUNE96 for an exporter key is shown in Figure 4.

Figure 4. Completing the Create RENAME Control Statement Panel

 CSFCSE20 --------- ICSF - Create RENAME Control Statement ----------
 COMMAND ===>

 Enter the following information:

    Existing Key Label
      JWL@SSIDEC95____________________________________________________

    New Key Label
      JWL@SSIJUNE96___________________________________________________

    Key Type           ===> ex______         Selection panel displayed if blank

    Comment Line       ===> export test key renamed______________________

 Press ENTER to create and store control statement
 Press END   to exit to the previous panel

In the Comment Line field, you can enter up to 45 characters of information about the control statement.
The information appears as a comment that precedes the control statement in the input control statement data set.
When you enter all the information on the Create RENAME Control Statement panel, press ENTER.
ICSF writes the control statement in the input control statement data set.

If a specification in any field is incorrect, when ICSF processes the control statement it displays an appropriate message on the top line of the panel. The cursor then appears in the field with the error. To display the long version of the error message at the bottom of the panel, press the HELP key (F1). You can correct the error and press ENTER again so ICSF can write the control statement to the control statement input data set.

The Create SET Control Statement panel appears. If a control statement was created, the message SUCCESSFUL UPDATE appears on the right side of the top line of the panel.
To create another RENAME control statement, enter new information in the fields to create the control statement.
When you specify the information, press ENTER to place the control statement in the control statement input data set.
When you have finished creating RENAME control statements, press END to return to the KGUP Control Statement Menu panel.