Keywords › ARCHIVE Keyword—Archive a User's Security Record

ARCHIVE Keyword—Archive a User's Security Record

Valid on z/OS.

Use the ARCHIVE keyword on a LIST or DELETE command to archive a user’s permissions and resources into the form of TSS commands. The produced TSS commands can be stored in a PDS data set and used to restore the user in the future.

Important! Use ACID(MAINTAIN) and DATA(ALL) authority to archive the entire ACID. Anything less than DATA(ALL) provides only partial ACID archival. For example, DATA(BASIC) archive only the basic information.

This keyword has the following format:

TSS LIST(acid) ARCHIVE INTO(dataset_name[(member_name)])
TSS DELETE(acid) ARCHIVE INTO(dataset_name[(member_name)])

acid

Identifies the user ACID.

dataset_name

Specifies the name of a data set in which you want to store the security record information.

Important! You must specify a data set name that does not already exist. Additionally, you must have authorization to access the data set as specified in the command. For example, if you specify to archive into a USER01.SAMPLE data set, you must be authorized to data sets that start with USER01.

member_name

Specifies the name of a member in the specified data set.

Note: If member_name is omitted from the INTO keyword, the acid name is used as the member name. However, if the first character of the ACID name is a number, you must supply a member name that does not start with a number.

When you use the ARCHIVE keyword, the first record in the output is a comment containing the following information:

• Command
• User ACID being modeled
• Date and time of the archive
• TSS administrator who issued the command
• System on which the command was executed

The following example shows a comment:

/*ARCHIVE  CASSIE   STORED 02/17/10-09.54.00 BY MASTER1  ON XE15

This keyword is used with:

• The commands LIST and DELETE
• The ACID types User, DCA, VCA, ZCA, LSCA, and SCA
• ACID(MAINTAIN) authority and DATA(ALL) authority

Example: Archive a User's Security Record

This example archives user security record information into a member named MYARCHIVE in the data set USER01.SAMPLE.ARCHIVE:

TSS LIST(CLRK99) ARCHIVE INTO(USER01.SAMPLE.ARCHIVE(MYARCHIVE))