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 135, and press ENTER.
Figure 135. 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 136.
Figure 136. 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 16 for a list of these options and the
steps to follow for each.
Table 16. Data Set Name OptionsOption | 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 140. 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 138.
- 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 138 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 140.
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 139.
- Enter the necessary information to allocate a new data set and
press ENTER.
The KGUP Control Statement Menu appears. See Figure 140. The new control statements will be stored in the new
data set.
| Figure 137 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.
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 138.
Figure 138. 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 139.
Figure 139. 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 140. 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 140. 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.
Steps for creating ADD, UPDATE, or DELETE control statements
When you select Maintain (option 1) on the KGUP Control Statement
Menu panel, the Create ADD, UPDATE, or DELETE Key Statement panel
appears. See Figure 141.
Figure 141. Create ADD, UPDATE, or DELETE Key Statement Panel
CSFCSE10----- ICSF - Create ADD, UPDATE, or DELETE Key Statement ------------
Specify control statement information below
Function ===> ______ ADD, UPDATE, or DELETE
Algorithm ===> DES DES or AES
Key Type ===> ________ Outtype ===> ________ (Optional)
Label ===> ________________________________________________________________
Group Labels ===> NO_ NO or YES
or Range:
Start ===> ________________________________________________________________
End ===> ________________________________________________________________
Transport Key Label(s)
===> ________________________________________________________________
===> ________________________________________________________________
or Clear Key ===> NO_ NO or YES
Control Vector ===> YES NO or YES
Length of Key ===> ___ 8, 16 or 24 For AES: 16, 24, or 32
Key Values ===>
________________ ,_______________ ,________________,_____________________
Comment Line ===> _______________________________________________________
Press ENTER to create and store control statement
Press END to exit to the previous panel without saving
- On the panel, fill out the fields to create the ADD, UPDATE, or
DELETE control statement that you want KGUP to process. Each field
on the panel corresponds to a control statement keyword. The panel
helps you to create a complete, syntactically correct ADD, UPDATE,
or DELETE control statement.
The panel creates control statements
according to the syntax described in Syntax of the ADD and UPDATE Control Statements. See that
topic for more information about the control statement keywords.
- In the Function field, select the function you want KGUP to perform.
- Function
- Result
- ADD
- Enter new key entries in the CKDS. Generate and receive key
values for key distribution.
- UPDATE
- Change existing entries in the CKDS. Generate and receive key
values for key distribution.
- DELETE
- Remove entries from the CKDS.
You can just type the first letter of the function in the
first position in a field on the panel. For example, in Figure 142, a was entered in the Function field to
specify the ADD function. ICSF recognizes the abbreviation.
For
a description of the keywords you must specify for each function,
see Using the ADD and UPDATE control statements for key management
and distribution functions.
Figure 142. Selecting the ADD Function on the Create ADD, UPDATE, or DELETE Key Statement Panel
-------------- ICSF - Create ADD, UPDATE, or DELETE Key Statement ------------
Specify control statement information below
Function ===> add___ ADD, UPDATE, or DELETE
Algorithm ===> DES DES or AES
Key Type ===> ________ Outtype ===> ________ (Optional)
Label ===> ________________________________________________________________
Group Labels ===> NO_ NO or YES
or Range:
Start ===> ________________________________________________________________
End ===> ________________________________________________________________
Transport Key Label(s)
===> ________________________________________________________________
===> ________________________________________________________________
or Clear Key ===> NO_ NO or YES
Control Vector ===> YES NO or YES
Length of Key ===> ________________ For AES: 16, 24, or 32
Key Values ===>
________________ ,_______________ ,________________,_____________________
Comment Line ===> _______________________________________________________
Press ENTER to create and store control statement
Press END to exit to the previous panel without saving
- In the Key Type field, enter the type of key you want KGUP to
process with the control statement. This field represents the TYPE
keyword on the control statement.
If you leave the Key Type Field
blank and press ENTER, the Key Type Selection panel appears. See Figure 143.
Figure 143. Selecting a Key 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
CLRAES Clear AES Encryption/decryption key
CLRDES Clear Encryption/decryption key
DATA Encryption/decryption key
DATAM Double-length MAC generation key
DATAMV Double-length MAC verification key
DATAXLAT Data-translation key
s EXPORTER Export key-encrypting key
IMPORTER Import key-encrypting key
IPINENC Input PIN-encrypting key
MAC Message authentication key
MACVER Message verification key
NULL Dummy CKDS records
OPINENC Output PIN-encrypting key
PINGEN PIN generation key
PINVER PIN verification key
********************************BOTTOM OF DATA*********************************
- Type s to the left of the key type you want to specify
from the displayed list of key types.
In Figure 143,
the exporter key is selected.
- When you have specified a key type, press ENTER to return to the
Create ADD, UPDATE, or DELETE Key Statement panel, as shown in Figure 144.
Figure 144. Completing the Create ADD, UPDATE, or DELETE Key Statement Panel
-------------- ICSF - Create ADD, UPDATE, or DELETE Key Statement ------------
Specify control statement information below
Function ===> ADD___ ADD, UPDATE, or DELETE
Algorithm ===> DES DES or AES
Key Type ===> EXPORTER Outtype ===> ________ (Optional)
Label ===> ATMBRANCH5M0001_________________________________________________
Group Labels ===> NO_ NO or YES
or Range:
Start ===> ________________________________________________________________
End ===> ________________________________________________________________
Transport Key Label(s)
===> tkatmbranch5m0001_______________________________________________
===> ________________________________________________________________
or Clear Key ===> NO_ NO or YES
Control Vector ===> YES NO or YES
Length of Key ===> 16_ 8, 16 or 24 For AES: ________________________
Key Values ===>
________________ ,_______________ ,________________,_____________________
Comment Line ===> export test key _______________________________________
Press ENTER to create and store control statement
Press END to exit to the previous panel without saving
If you abbreviated the control statement function, the function
now appears in its full form. The type of key you selected on the
Key Type Selection panel appears in the Key Type field.
- Specify either a label or range to identify the label of the key
entry in the CKDS that you want KGUP to process.
The Label field
represents the LABEL keyword on the control statement. The Range field
represents the RANGE keyword on the control statement. In the Range
fields, specify the first and last label in a range of labels you
want KGUP to process.
Table 17. Selecting Range and Label OptionsOption | Steps |
---|
To have KGUP process only one key
label |
- Specify the key label in the Label field.
- Type NO in the Group Labels field.
| To have KGUP process more than one
key label |
- Specify the first label in the Label field.
- Type YES in the Group Labels field.
|
- Specify either a transport key label or YES in the
Clear Key field.
The Transport Key Label field represents the TRANSKEY
keyword on the control statement. The Clear Key field represents the
CLEAR keyword. These keywords are mutually exclusive.
When
KGUP generates a key, the program places the key value in a data set
so you can send the value to another system. The other system uses
the value to create the complement of the key. You send the key value
as either a clear key value or a key value encrypted under a transport
key.
When KGUP imports a key value, the program may import
a clear or encrypted key value. KGUP decrypts the encrypted key value
from under the transport key that you specify in the Transport Key
Label field.
Table 18. Selecting the Transport Key Label and Clear Key Label OptionsOption | Steps |
---|
To have KGUP generate a key other
than an importer key and encrypt the key value |
- Specify the label of the transport key you want KGUP to use to
encrypt the key in the Transport Key Label field.
- Type NO in the Clear Key field.
| To have KGUP generate a key other
than an importer key and leave the key value in the clear |
- Leave the Transport Key Label field blank
- Type YES in the Clear Key field.
| To have KGUP import an encrypted
key |
- Specify the label of the transport key you want KGUP to use to
dencrypt the key in the Transport Key Label field.
- Type NO in the Clear Key field.
| To have KGUP import a clear key |
- Leave the Transport Key Label field blank
- Type YES in the Clear Key field.
|
- Specify either YES or NO in the Control
Vector field.
Usually the cryptographic facility exclusive ORs
a transport key with a control vector prior to the transport key encrypting
a key. However, if your system is exchanging keys with a system like
PCF that does not use control vectors, you need to specify that no
control vector be used. If you want KGUP to generate a transport key
that uses a control vector, type YES in the Control Vectors
field. Otherwise type NO. If you type NO in
this field, the control statement contains the NOCV keyword.
- If you want KGUP to work with a single-length key in its processing,
type YES in the Length of Key field. Otherwise,
type NO. If you type YES in the field, the control
statement contains the LENGTH keyword.
- If you are entering a key value, enter the key value in the Key
Values field.
You enter the value as three values if the key is
a triple-length key, two values if the key is a double-length key,
or as one value if the key is a single-length key. The Key Values
field represents the KEY keyword on the control statement.
- 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 this panel, press ENTER.
If
you entered YES in the Group Labels field, the Group Label
panel appears. See Figure 145.
Figure 145. Specifying Multiple Key Labels on the Group Label Panel
CSFCSE11 ----------------- ICSF - Group Label Panel ------------------
COMMAND ===>
First label:
ATMBRANCH5M0001_________________________________________________
Enter at least one other label:
ATMBRANCH5M0020_________________________________________________
ATMBRANCH5M0030_________________________________________________
ATMBRANCH5M0050_________________________________________________
________________________________________________________________
________________________________________________________________
________________________________________________________________
________________________________________________________________
________________________________________________________________
________________________________________________________________
Press ENTER to add more labels or create and store control statement
Press END to exit to the previous panel without saving
- Enter any additional key labels you want KGUP to process with
the control statement.
The first label you entered in the Label
field of the Create ADD, UPDATE, or DELETE Key Statement panel appears
at the top of this panel. If you enter duplicate labels, an error
message appears on the right side of the panel and the cursor appears
on the duplicate label. If the syntax of the label is incorrect, an
error message appears and the cursor appears on the incorrect label.
- If you have more labels than will fit on this panel, press the
ENTER key when you have filled each line on the panel. An additional
Group Label Panel appears. Type the remaining labels and press ENTER.
ICSF writes
the control statement to the input control statement data set. You
return to the Create ADD, UPDATE, or DELETE Key Statement panel.
If you entered NO in the Group Labels field, you
do not access the Group Label panel. You remain on the Create ADD,
UPDATE, or DELETE Key Statement panel.
- Press ENTER to have ICSF write 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).
If you correct the error and press ENTER again, ICSF writes the
control statement to the control statement input data set.
If
a control statement was created, the message SUCCESSFUL UPDATE appears
on the right side of the top line of the panel, as shown in Figure 146.
Figure 146. Create ADD, UPDATE, or DELETE Key Statement Panel Showing Successful Update
-------------- ICSF - Create ADD, UPDATE, or DELETE Key Statement ------------
Specify control statement information below
Function ===> ADD___ ADD, UPDATE, or DELETE
Algorithm ===> DES DES or AES
Key Type ===> EXPORTER Outtype ===> ________ (Optional)
Label ===> ATMBRANCH5M0001_________________________________________________
Group Labels ===> NO_ NO or YES
or Range:
Start ===> ________________________________________________________________
End ===> ________________________________________________________________
Transport Key Label(s)
===> TKATMBRANCH5M0001_______________________________________________
===> ________________________________________________________________
or Clear Key ===> NO_ NO or YES
Control Vector ===> YES NO or YES
Length of Key ===> 16 8, 16 or 24 For AES: _________________________
Key Values ===>
________________ ,_______________ ,________________,_____________________
Comment Line ===> EXPORT TEST KEY________________________________________
Press ENTER to create and store control statement
Press END to exit to the previous panel without saving
- If you want to create another ADD, UPDATE, or DELETE 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.
- If you do not want to create another ADD, UPDATE, or DELETE control
statement, press END to return to the KGUP Control Statement Menu
panel.
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 147.
Figure 147. 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 148. 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 148. 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 149.
Figure 149. 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
CLRAES Clear AES Encryption/decryption key
CLRDES Clear Encryption/decryption key
DATA Encryption/decryption key
DATAM Double-length MAC generation key
DATAMV Double-length MAC verification key
DATAXLAT Data-translation key
s EXPORTER Export key-encrypting key
IMPORTER Import key-encrypting key
IPINENC Input PIN-encrypting key
MAC Message authentication key
MACVER Message verification key
NULL Dummy CKDS records
OPINENC Output PIN-encrypting key
PINGEN PIN generation key
PINVER PIN verification key
********************************BOTTOM OF DATA*********************************
- Type s to the left of the key type you want to specify.
In Figure 149, 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 150.
Figure 150. 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.
Steps for creating a SET control statement
The SET control statement specifies data for KGUP to send to a
KGUP exit routine. To create a SET control statement:
- Choose option 3 on the KGUP Control Statement Menu, as shown in Figure 151.
Figure 151. Selecting the Set Option on the KGUP Control Statement Menu Panel
CSFCSM00 ----------- ICSF - KGUP Control Statement Menu ------------
OPTION ===> 3
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 152. From this panel you can creates a SET
control statement. For information about the SET control statement
keywords, refer to Syntax of the SET Control Statement.
Figure 152. Create SET Control Statement Panel
CSFCSE30 ----------- ICSF - Create SET Control Statement -----------
COMMAND ===>
Specify installation data for exit processing
Installation Data ===> ____________________________________________________
Comment Line ===> _____________________________________________
Press ENTER to create and store control statement
Press END to exit to the previous panel without saving
- In the Installation Data field, enter the data to pass to a KGUP
installation exit.
- 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.
An example of a Create SET Control Statement
panel which passes date information to the installation exit is shown
in Figure 153.
Figure 153. Completing the Create SET Control Statement Panel
CSFCSE30 ----------- ICSF - Create SET Control Statement -----------
COMMAND ===>
Specify installation data for exit processing
Installation Data ===> BRANCH051992110119930131____________________________
Comment Line ===> Branch 5 POS terminal date information_________
Press ENTER to create and store control statement
Press END to exit to the previous panel without saving
- When you enter all the information on this panel, press ENTER.
ICSF writes
the control statement in the input control statement data set.
When
the control statement is created, the message SUCCESSFUL UPDATE appears
on the right side of the top line of the panel.
- Press END to return to the KGUP Control Statement Menu panel.
Steps for editing control statements
You can edit the control statement input data set that you specified
for this KGUP job. The control statement input data set contains the
control statements you created when you specified the control statement
input data set.
To edit the control statements you created:
- Choose option 4 on the KGUP Control Statement Menu panel, as shown
in Figure 154.
Figure 154. Selecting the Edit Option on the KGUP Control Statement Menu Panel
CSFCSM00 ----------- ICSF - KGUP Control Statement Menu ------------
OPTION ===> 4
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
The ISPF editor displays the control statement input data
set. An example of a data set called LARSON.CSFIN.TESTDS1P(TEST2)
with a SET, ADD, and RENAME control statement is shown in Figure 155.
Figure 155. Edit Control Statement Initial Display Panel
ISREDDE - LARSON.CSFIN.TESTDS1P(TEST2) - 00.00 --------------- COLUMNS 001 072
COMMAND ===> _ SCROLL ===> CSR
****** ***************************** TOP OF DATA ******************************
000001 /* TEST INSTALLATION DATA */
000002 SET INSTDATA('This is test installation data')
000003 /* EXPORT TEST KEY */
000004 ADD TYPE(EXPORTER),
000005 TRANSKEY(SENDTOBRANCH5JUNE99)
000006 LABEL(ATMBRANCH5M0001)
000007 /* EXPORT TEST KEY RENAMED */
000008 RENAME LABEL(JWL@SSIDEC97,JWL@SSIJUNE99) TYPE(EXPORTER)
****** **************************** BOTTOM OF DATA ****************************
- You can change any information on the control statements in the
data set. You can also add lines to the data set that contains comments
or control statements.
- To specify many similar control statements, copy lines in this
file and edit them to create additional control statements.
Note:
The panel does not check whether the control statements
that you change are syntactically correct.
Figure 156 shows the insertion of a comment line in the file.
Figure 156. Edit Control Statement Data Set with Insert
ISREDDE - LARSON.CSFIN.TESTDS1P(TEST2) - 00.00 --------------- COLUMNS 001 072
COMMAND ===> SCROLL ===> CSR
****** ***************************** TOP OF DATA ******************************
'' /* This comment was inserted using the editor */_
000001 /* TEST INSTALLATION DATA */
000002 SET INSTDATA('This is test installation data')
000003 /* EXPORT TEST KEY */
000004 ADD TYPE(EXPORTER),
000005 TRANSKEY(SENDTOBRANCH5JUNE99)
000006 LABEL(ATMBRANCH5M0001)
000007 /* EXPORT TEST KEY RENAMED */
000008 RENAME LABEL(JWL@SSIDEC97,JWL@SSIJUNE99) TYPE(EXPORTER)
****** **************************** BOTTOM OF DATA ****************************
- When you make any changes, press END to save the changes and return
to the KGUP Control Statement Menu panel.
|