USING Keyword—Model ACID

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

Use the USING keyword to create an ACID of the same type using an existing ACID as a model.

The model acid information available from a TSS LIST(modelacid) DATA(BASIC,TSO) is copied to the ACID in the CREATE USING command along with the TSO DFLT, SMS, CICS, OMVS, and WORKATTR DATA information. The model must exist before copies are created from it.

Note: In addition to the information from TSS LIST DATA(BASIC), the TSO DFLT DATA information and password information are also copied. If the ACID has a PHRASE assigned to it the PHRASE is not copied.

This keyword has the following format:

TSS CREATE(newacid) USING(modelacid)

This keyword is used with:

The command CREATE
The ACID types User, Profile, DEPARTMENT, ZONE, DCA, VCA, ZCA, LSCA, SCA, and MSCA
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 which requires an ADMIN authority that the administrator does not have, the CREATE function fails.

Examples: USING keyword

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

TSS CREATE(USER02) USING(USER01)

This example gives USER02 a name of John Smith with an initial password of SMIJO01. Passwords expire every every seven days:

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

To omit an information field from the new ACID, enter the keyword with no value specified in the parentheses. In this example,the INSTDATA keyword is omitted 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. Information not copied by CREATE USING (such as PERMITs) must be explicitly granted to the new ACID after the CREATE.