Keywords › INSTDATA Keyword—Record ACID Information

INSTDATA Keyword—Record ACID Information

Valid on z/OS, z/VSE, and z/VM.

Use the INSTDATA keyword to record or remove information about an ACID. Up to 255 characters of information about an associated ACID may be used for convenient record keeping, or for interrogation by a user‑written Installation Exit.

This keyword has the following format:

TSS ADDTO(acid) INSTDATA([']installation data['])

TSS REPLACE(acid) INSTDATA([']installation data['])

When used with TSS ADD, CA Top Secret adds installation data to the end of any existing data. The new data is concatenated, but cannot extend beyond 255 characters.

When used with TSS REPLACE, CA Top Secret replaces any installation data. The new data is limited to 255 characters.

Installation data:

• Must be delimited by single quotes if it contains blanks, lower case or special characters
• Is automatically uppercased unless OPTIONS(73 or 16) were set during TSS startup

This keyword is used with:

• The commands CREATE, REPLACE, ADDTO, REMOVE, and WHOHAS
• The ACID types User, DCA, VCA, ZCA, LSCA, SCA, MSCA, DEPARTMENT, DIVISION, and ZONE
• MISC1(INSTDATA) authority

Examples: INSTDATA keyword

This example adds INSTDATA to ACID QO66:

TSS ADDTO(QO66) INSTDATA('JUNE 90')

'JUNE 90', is added to the end of the INSTDATA which exists for QO66.

Administrators may remove the entire INSTDATA field for an ACID, but cannot remove specific portions.

This example removes ALL INSTDATA for QO66.

TSS REMOVE(QO66) INSTDATA

Note: Use the TSS REPLACE (INSTDATA) to totally replace old data with new data.