Steps for creating KGUP control statements using the ICSF panels

You create the control statements to specify the functions you want KGUP to perform. When you create the control statements, ICSF stores the statements in the control statement input data set.

When you create the control statements, do one of these procedures:
To create the KGUP control statements:
  1. Select option 1, Create, on the Key Administration panel, as shown in Figure 1, and press ENTER.
    Figure 1. Selecting the Create Option on the Key Administration Panel
     CSFSAM00 ----------------- ICSF - Key Administration ---------------
     OPTION ===> 1
    
    
        Enter the number of the desired option.
    
        1  Create         - Create key generator control statements
    
        2  Dataset        - Specify datasets for processing
    
        3  Submit         - Invoke Key Generator Utility Program (KGUP)
    
        4  Refresh        - Activate an existing cryptographic key dataset
     

    The KGUP Control Statement Data Set Specification panel appears. See Figure 2.

    Figure 2. KGUP Control Statement Data Set Specification Panel
     CSFSAE10 - ICSF - KGUP Control Statement Data Set Specification ----
     COMMAND ===>
    
     Enter control statement input data set (DDNAME = CSFIN)
    
        Data Set Name ===> ______________________________________________________
        Volume Serial ===> ______  (if uncataloged)
    
    
        Press ENTER to open or create and open specified data set
        Press END   to exit to the previous panel
     
  2. Enter the name of the data set that you want to contain the control statements for KGUP processing.
    1. For partitioned data sets, specify a member name as part of the data set name.
    2. If the data set is not cataloged, you must also specify the volume serial for the data set in the Volume Serial field. This volume serial allows ICSF to access the correct volume when ICSF opens the data set.
    Note: If you specify NOPREFIX in your TSO profile, so data sets are not automatically prefixed with your userid, you must specify the fully qualified data set name within apostrophes. If you specify PREFIX without a valid prefix, your TSO userid becomes the prefix.
    Depending on your requirements, there are several options to choose from when entering the data set name. Refer to Table 1 for a list of these options and the steps to follow for each.
    Table 1. Data Set Name Options
    Option Steps
    To have KGUP append the control statements to an existing data set when you know the data set name and the member name
    1. Specify the data set name and member name of the existing data set and press ENTER.

      The KGUP Control Statement Menu appears. See Figure 6. The new control statements will be appended when any existing control statements in the data set.

    To have KGUP append the control statements to an existing data set when you know the data set name but not the member name
    1. Specify the data set name of the existing data set and press ENTER.

      If the partitioned data set is not empty, the Member Selection List appears. See Figure 4.

    2. On the Member Selection List panel:
      • To select a member that already exists, place an s to the left of the member name in the list and press ENTER.

        For example, in Figure 4 SHIFT2 is selected so the data set LARSON.CSFIN.TESTDS1P(SHIFT2) becomes the input control statement data set.

      • To locate a member on the selection list, type an l (the lowercase letter L) and the member name on the command line and press ENTER.

        The list moves so the member appears on the top line of the list and the cursor appears to the left of the member.

      • To create a new member, type s and the new member name on the command line and press ENTER.

      The KGUP Control Statement Menu appears. See Figure 6. The new control statements will be appended when any existing control statements in the data set.

    To have KGUP create a new data set
    1. Specify a name for the new data set and press ENTER.

      The Allocation panel appears. See Figure 5.

    2. Enter the necessary information to allocate a new data set and press ENTER.

      The KGUP Control Statement Menu appears. See Figure 6. The new control statements will be stored in the new data set.

    Figure 3 shows an example of the KGUP Control Statement Data Set Specification panel with the partitioned data set CSFIN.TESTDS1P and a member name of TEST1.

    Figure 3. Entering a Data Set Name on the KGUP Control Statement Data Set Specification Panel
     CSFSAE10 - ICSF - KGUP Control Statement Data Set Specification ----
     COMMAND ===>
    
     Enter control statement input data set (DDNAME = CSFIN)
    
        Data Set Name ===> CSFIN.TESTDS1P(test1)_________________________________
        Volume Serial ===> ______  (if uncataloged)
    
    
        Press ENTER to open or create and open specified data set
        Press END   to exit to the previous panel
     

    If the member TEST1 did not previously exist, ICSF creates the member. If the member already exists, ICSF appends the control statements to the end of the data set. <Prefix>.CSFIN.TESTDS1P(test1) becomes the control statement input data set.

    If you specify CSFIN.TESTDS1P without the member name, the Member Selection List panel appears. See Figure 4.

    Figure 4. Member Selection List Panel
     CSFSAE12 --------- ICSF - Member Selection List --------- ROW 1 To 6 OF 6
     COMMAND ===>                                                  SCROLL ===> PAGE
    
     Data Set:  LARSON.CSFIN.TESTDS1P
     Select one member name only
         NAME          CREATED     CHANGED       SIZE   INIT    MOD    USERID
        PINEX1        95/08/04 96/08/05 10:44      26     24      1   LARSON
        PINEX2        95/08/04 96/07/04 11:23      14     14      0   LARSON
        KEYEX1        95/08/04 96/08/05 12:44       6      6      1   LARSON
     s  SHIFT2        95/08/04 96/08/12 10:55     195    137      2   LARSON
        SHIFT3        95/08/04 96/08/05 12:44      48      4      1   LARSON
        TEST1         95/08/04 96/08/05 11:44       4      4      1   LARSON
     ****************************** BOTTOM OF DATA *********************************
     

    If you specify a new data set name, the Allocation panel appears. See Figure 5.

    Figure 5. Entering Data Set Information on the Allocation Panel
     CSFSAE11 --------------- ICSF - Allocation -------------------------
     COMMAND ===> _
    
     DATA SET NAME: LARSON.CSFIN.TESTDS1P
       Data set cannot be found.  Specify allocation parameters below.
    
        VOLUME SERIAL      ===> ______      (Blank for authorized default volume) *
        GENERIC UNIT       ===> ________    (Generic group name or unit address) *
        SPACE UNITS        ===> BLOCK_____  (BLKS, TRKS, or CYLS)
        PRIMARY QUANTITY   ===> 10____      (In above units)
        SECONDARY QUANTITY ===> 5_____      (In above units)
        DIRECTORY BLOCKS   ===> 10____      (Zero for sequential data set)
        RECORD FORMAT      ===> FB
        RECORD LENGTH      ===> 80
        BLOCK SIZE         ===> 6400__      (In multiples of record length)
        EXPIRATION DATE    ===> _____       (Format is YYDDD)
    
        ( * Only one of these fields may be specified)
    
    
    
        Press ENTER to allocate specified data set and continue
        Press END   to exit to the previous panel without allocating
     

    Once the data set has been selected or created, the data set becomes the control statement input data set on the KGUP Control Statement Menu, as shown in Figure 6. The name of the control statement input data set you specified appears at the top of the panel.

    From this panel, you can press END to go back to the KGUP Control Statement Data Set Specification panel. On the later panel you can either specify another data set to store control statements, or press END again to return to the Key Administration panel.

    Figure 6. KGUP Control Statement Menu Panel
     CSFCSM00 ----------- ICSF - KGUP Control Statement Menu ------------
     OPTION ===> _
    
       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
    
    
        Press ENTER to go to the selected option
        Press END   to exit to the previous panel
    
    
    
    
    
     
  3. Choose the type of control statement you want to create and press ENTER.

    When you choose the Maintain, Rename, or Set option, you access the panels to create the control statement you want. When you create a control statement, the statement is placed in the specified control statement input data set. To edit the control statements that are stored in this data set, choose the Edit option.