Keywords › KEYRING Keyword—Add a Key Ring to a User

KEYRING Keyword—Add a Key Ring to a User

Valid on z/OS.

Use the KEYRING keyword to:

• Add a key ring to an individual user. A user can be a member of more than one key ring. The ring name is unique within the user, and the name you specify in KEYRING identifies the key ring for a user.
• List information about a keyring.

When used with ADDTO, this keyword has the following format:

TSS ADDTO(acid) KEYRING(8‑byte‑ring‑name)

When used with LIST, this keyword has the following format:

TSS LIST(SDT) KEYRING(ALL)

When used with LIST and VSAM/R12 is used, this keyword has the following format:

TSS LIST(ACIDS) KEYRING(ALL)

For each certificate connected to the key ring, the following information is displayed:

• Name of the certificate
• Owner of the certificate
• Label assigned to the certificate
• DEFAULT status of the certificate within the ring
• Usage within the ring

Key rings can be listed for ACID types user, CERTAUTH, and CERTSITE.

This keyword is used with:

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