Using KGUP control statements

You use control statements to specify the function you want the key generator utility program (KGUP) to perform. You use job control language (JCL) to submit the control statements to KGUP. You can create and submit KGUP control statements either on your own or using the KGUP panels. OPKYLOAD control statements cannot be created using the KGUP panels.

You specify information to KGUP using an ADD, UPDATE, DELETE, RENAME, SET or OPKYLOAD control statement. You use keywords on the control statement to specify:
  • The function KGUP performs
  • Information about the key that KGUP processes

For example, if you specify the KEY keyword on an ADD control statement, you supply a key which KGUP adds to the CKDS in an entry.

This topic describes the syntax of the control statements with their keywords. Use these rules when interpreting the syntax of the control statements:
  • Specify uppercase letters and special characters as shown in the examples.
  • Lowercase letters represent keyword values that you must specify.
  • A bar (|) indicates a choice (OR).
  • Ellipses (...) indicates that multiple entries are possible.
  • Braces ({ }) denote choices, one of which you must specify.
  • Brackets ([ ]) denote choices, one of which you may specify.
Control statements in the Control Statement Input data set may not be longer than 71 characters including the continuation character.

The parse routine allows you to abbreviate a keyword in a control statement to the least number of characters that uniquely identify the keyword. To avoid conflicts in abbreviations, it is a good practice to fully spell out all keywords in the statements.