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:

Process the control statements by running KGUP.
Do not process the control statements and just save the statements in the data set. Then at another time you can access the data set to add more control statements and submit the data set for KGUP processing.

To create the KGUP control statements:

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

Enter the name of the data set that you want to contain the control statements for KGUP processing.

For partitioned data sets, specify a member name as part of the data set name.
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	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	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. 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	Specify a name for the new data set and press ENTER. The Allocation panel appears. See Figure 5. 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

Choose the type of control statement you want to create and press ENTER.
- To create an ADD, UPDATE, or DELETE control statement, select option 1. For information, see Steps for creating ADD, UPDATE, or DELETE control statements.
- To create a RENAME control statement, select option 2. For information, see Steps for creating a RENAME control statement.
- To create a SET control statement, select option 3. For information, see Steps for creating a SET control statement.
- To edit the input control statement data set, select option 4. For information, see Steps for editing control statements.
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.