Keywords › RINGDATA Keyword—Add Certificate to a Ring

RINGDATA Keyword—Add Certificate to a Ring

Valid on z/OS.

Use the RINGDATA to add a digital certificate to a key ring. The keyword RINGDATA specifies the ACID and certificate name (as specified by DIGICERT) of the digital certificate being added to the user.

This keyword has the following format:

TSS ADDTO(userid) KEYRING(8‑byte name) 
                  [LABLRING(237‑byte ring name)]
                  {RINGDATA(userid,digicert)}
                  {RINGDATA(CERTSITE,digicert)}
                  {RINGDATA(CERTAUTH,digicert)}
                  [DEFAULT]
                  [USAGE(PERSONAL|CERTSITE|CERTAUTH)]

userid,digicert

ACID and name of digital certificate

CERTSITE,digicert

This certificate is a site‑generated certificate

CERTAUTH,digicert

This certificate is from a certificate authority.

This keyword is used with:

• The commands ADDTO, REMOVE, and REPLACE
• The ACID types User, DCA, VCA, ZCA, LSCA, and SCA
• ACID(MAINTAIN) and MISC4(CERTUSER) authority for user IDs
• MISC4(CERTSITE) for CERTSITE ACIDs
• MISC4(CERTAUTH) for CERTAUTH ACIDs

Examples: RINGDATA keyword

This example specifies the ACID and certificate name of the certificate being added to the user key ring:

TSS ADDTO(user01) KEYRING(CASRING)
                  RINGDATA(user01,cert0001)

This example removes a certificate in a key ring:

TSS REMOVE(user01) KEYRING(CASRING)
                   RINGDATA(user01,cert0001)