USING Keyword—Specify a Model ACID

Keywords › USING Keyword—Specify a Model ACID

USING Keyword—Specify a Model ACID

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

Use the USING keyword to specify an existing ACID to use as a model when you are performing the following activities:

Creating a new ACID based on the specified ACID model.
Modeling an existing ACID after the specified ACID model.

For a CREATE command, the model ACID information that is available from a TSS LIST(modelacid) DATA(BASIC,TSO) command is copied to the ACID, along with the INSTDATA, TSO DFLT, SMS, CICS, OMVS, and WORKATTR DATA information.

Note: CA Top Secret also copies the password information; however, CA Top Secret does not copy any PHRASE that is assigned to the ACID. Information that is not copied by CREATE USING (such as PERMITs) must be explicitly granted to the new ACID after the CREATE. To determine which information you need to grant, use the COMPARE command to compare the two ACIDs.

The MODEL command produces TSS commands that contain the user ID specified by the ACID keyword, with resources and permissions from the user ID specified in the USING keyword.

This keyword has the following format:

TSS CREATE(newacid) USING(model_acid)

TSS MODEL ACID(new_acid) USING(model_acid) INTO(dataset_name(member_name))

model_acid: Specifies the acid whose information will be copied.
new_acid: Specifies the ACID that will be modeled after the ACID specified in the USING keyword. For a MODEL function, you can specify a new ACID name or an existing ACID name. If you specify an existing ACID name, and you want to use the TSS commands produced by the MODEL commands without changing them, you must delete or rename the existing ACID before executing the TSS commands.
dataset_name(member_name): Specifies the data set name and member into which CA Top Secret generates MODEL command output for the new ACID.

This keyword can be used with:

The commands COMPARE, CREATE, and MODEL
The ACID types User, Profile, DEPARTMENT, ZONE, DCA, VCA, ZCA, LSCA, SCA, and MSCA
ACID(MAINTAIN) authority and DATA(ALL) (for a MODEL function)
Note: For a CREATE function, all rules of scope and administrative authority are supported. If the model ACID is outside the scope of the administrator (or has an information field that requires authority that the administrator does not have), the CREATE function fails.

Example: Create an ACID Based On an Existing ACID

This example creates an ACID (USER02) that is modeled after existing ACID USER01 (including USER01's name and password):

TSS CREATE(USER02) USING(USER01)

Example: Create an ACID with an Assigned Name and Password

This example gives USER02 the name John Smith and initial password SMIJO01. Passwords expire every seven days.

TSS CREATE(USER02) USING(USER01)
                   NAME('JOHN SMITH')
                   PASSWORD(SMIJO01,7,EXP)

Example: Omit an Information Field from a New ACID

To omit an information field from the new ACID, enter the keyword with no value specified in the parentheses. This example omits the INSTDATA keyword from USER02:

TSS CREATE(USER02) USING(USER01)
                   INSTDATA()

All ACID attributes in USER01 not desired in USER02 must be explicitly removed from USER02 after the CREATE. ACID attributes (SUSPEND and NORESCHK) have no values to nullify with () string values and therefore cannot be nullified within the CREATE syntax.

Example: Model an Existing ACID After a Model ACID

This example generates the model command output for new ACID NewRac (by using existing ACID Rachael) and places the output in MVS PDS data set HORKR02.RACHAEL.MODEL without a member name. The member will be set to the ACID name in the ACID keyword NewRac:

TSS MODEL USING(Rachael) ACID(NewRac) INTO(horkr02.rachael.model)

More information:

COMPARE Function—Compare ACIDs