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.
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.
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
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 |
|
To have KGUP append the control statements to an existing data set when you know the data set name but not the member name |
|
To have KGUP create a 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.
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.
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.
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.
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
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.