Keywords › REALMNAME(Local Realm) Keyword—Local Realm Name

REALMNAME(Local Realm) Keyword—Local Realm Name

Valid on z/OS.

Use the REALMNAME keyword to specify the fully qualified names of a local realm name.

This keyword has the following format:

TSS ADDTO(SDT) REALM(KERBDFLT) 
               REALMNAME('kerberos‑realm‑name')
               MINTKTLF(max‑ticket‑life) 
               MAXTKTLF(max‑ticket‑life)
               DEFTKTLF(default‑ticket‑life)
               KERBPASS(kerberos‑password)
               CHKADDRS

kerberos‑realm‑name

Specifies the unqualified name of the local realm.

You can use any character except the (X'61') character. Do not use any of the EBCDIC variant characters to avoid problems with different code pages.

Use the single quotes if:

• Parentheses, commas, blanks, or semicolons are entered as part of the name, the character string must be enclosed in single quotes.
• A single quote is part of the name and the entire character string is enclosed in single quotes, use two single quotes together to represent each single quote with the string.
• The first character of the name is a single quote. Enter the string within single quotes, with two single quotes entered for the single quote.

Regardless of the case used, CA Top Secret rolls the name of the local Network Authentication and Privacy Service realm to upper case. This does not ensure that a valid kerberos‑realm‑name has been specified.

Maximum length: 117 characters

This keyword is used with:

• The commands ADDTO, REMOVE, and REPLACE LIST
• The ACID types User, DCA, VCA, ZCA, LSCA, and SCA
• MISC3(SDT) authority
• MISC8(LISTSDT) authority to list KERBNAME in the SDT

Example: REALMNAME keyword

This example creates the default local realm record with a realm name of Local.ca.com:

TSS ADDTO(SDT) REALM(KERBDFLT)
               REALMNAME(LOCAL.CA.COM)
               MINTKTLF(30)
               MAXTKTLF(86400)
               DEFTKTLF(36000)
               KERBPASS(CHILDREN)
               CHKADDRS