z/OS Cryptographic Services ICSF Administrator's Guide
Previous topic | Next topic | Contents | Index | Contact z/OS | Library | PDF


Syntax of the DELETE Control Statement

z/OS Cryptographic Services ICSF Administrator's Guide
SA22-7521-17

DELETE control statements instruct KGUP to remove key entries from the CKDS.

The DELETE control statement has this syntax:

Figure 128. DELETE Control Statement Syntax
DELETE

   {LABEL(label1[,...,label64]) | RANGE(start-label,end-label)}

   TYPE(key-type)
LABEL (label1[,...,label64])
This keyword defines the names of the key entries for KGUP to delete from the CKDS. KGUP deletes a separate entry for each label.

You must specify at least one key label, and you can specify up to 64 labels with the LABEL keyword. For the general rules about key label conventions and uniqueness, see General Rules for CKDS Records.

On a KGUP control statement, you must specify either the LABEL or RANGE keyword.

RANGE (start-label, end-label)
This keyword defines the range of the multiple labels that you want KGUP to delete from the CKDS.

The label consists of between 2 and 64 characters that are divided as follows:

  • The first 1 to 63 characters are the label base. These characters must be identical on both the start-label and end-label and are repeated for each label in the range. For the general rules about key label conventions and uniqueness, see General Rules for CKDS Records.
  • The last 1 to 4 characters form the suffix. The number of digits in the start-label and end-label must be the same, and the characters must all be numeric. These numeric characters establish the range of labels KGUP creates. The start-label numeric value must be less than the end-label numeric value.
TYPE(key-type)
Because you can use the same label in entries with different key types, this keyword specifies the type of key that is being deleted.

To Delete Keys

You can use a KGUP control statement to remove a key or a range of keys from the CKDS. This statement shows the syntax when you delete keys from the CKDS:

   DELETE  LABEL(label) or RANGE(start-label,end-label)
   TYPE(data,dataxlat,exporter,importer,ipinenc,mac,macver,
   null,opinenc,pingen, or pinver)

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014