Keywords › LABLRING Keyword—Key Ring Label

LABLRING Keyword—Key Ring Label

Valid on z/OS.

Use the LABLRING keyword to specify a 237 byte label to associate with the key ring. This label must be unique to the key ring, because it is used to identify the key ring. This field is optional.

If not specified, the 8‑byte KEYRING name is automatically added to the LABLRING.

If KEYRING is specified with LABLRING, KEYRING takes precedence, except in ADDTO transactions.

This keyword has the following format:

TSS LIST(acid) [KEYRING(8‑byte ring name)]
               [LABLRING(237‑byte ring label)]

This keyword is used with:

• The commands ADDTO, REMOVE, LIST, and REPLACE
• The ACID types User, DCA, VCA, ZCA, LSCA, and SCA
• ACID(MAINTAIN) and MISC4(CERTUSER) authority

Examples: LABLRING keyword

This example adds a key ring to a user's ACID record:

TSS ADDTO(acid) KEYRING(8‑byte key ring name)
               [LABLRING(237‑byte ring name)]

This example adds a key ring with a label name:

TSS ADDTO(USERA) KEYRING(USERARNG)
                 LABLRING('USERA KEYRING FOR z/OS')

This example replaces a label name:

TSS REPLACE(USERA) KEYRING(USERARNG)
                   LABLRING('USERA KEYRING FOR z/OS')