MODEL Function—Create a New User from a Model

Command Functions › MODEL Function—Create a New User from a Model

MODEL Function—Create a New User from a Model

Use the MODEL command function to generate the TSS commands to create an acid of the same type (using an existing acid as a model). The MODEL command generates a list of TSS commands, which you can review and edit as necessary. Executing the commands creates the acid specified in the ACID keyword.

Note: If you use the MODEL command, and the DIAGSYM option in DFSORT is YES, you must have a SYSOUT DD in the CA Top Secret started task.

The generated commands represent most of the information available from a TSS LIST(modelacid) DATA(ALL) command. All attributes and data set and resource permissions are modeled by commands. Fields that are not modeled include:

Passwords or passphrases
Digital certificate and keyring segments:
Create/Modify date time
Last used info
ACID List entries
ADMINBY
ASUSPEND/VSUSPEND/PSUSPEND
Data Set Ownership information
Resource Ownership information

The INTO keyword specifies the data set where the TSS commands are written. You must specify this keyword to write commands to a PDS data set. You can view or edit the generated TSS commands.

If the INTO keyword is not specified, the TSS commands that are produced by the MODEL command are displayed to the user who issued the command.

The administrator executing the command must have:

Admin authority for DATA(all)
Scope over the acid being modeled

When the MODEL command is executed, the first record in the output is a comment containing the following information:

The command
The user acid being modeled
The date and time of the model
Identification of the TSS administrator who issued the command
Identification of the system on which the command was executed
Identification of the user acid used as a model

An example comment is as follows:

/*MODEL ACID NEWCAS   STORED 02/18/10-10.45.51 BY MASTER1  ON XE15 USING CASSIE

This keyword has the following format:

TSS MODEL USING(modelacid) ACID(newacid)
TSS MODEL USING(modelacid) ACID(newacid) [INTO(datasetname[(membername)])]

modelacid

Specifies the acid to use as a model. All resources and permissions from this acid are copied to the new acid.

newacid

Specifies the name of the acid that will be modeled after the acid specified in the USING keyword. The name can be a new acid name or an existing acid name. If you specify an existing acid name and want to use TSS commands produced by the MODEL commands without changing them, delete the existing ACID before executing the TSS commands.

datasetname[(membername)]

(Optional) Specifies the name and optionally a member name of the PDS data set where the model output commands are stored. If the keyword INTO is not specified, the TSS commands produced by the MODEL command are displayed to the user who issued the MODEL command.

Default for membername: Value specified in the ACID keyword. However, if the first character of the ACID value is a number, you must supply a member name that does not start with a number.

Examples: MODEL function

This example generates TSS model command output for the new acid NewRac using existing acid Rachael. The specified command generates the output in a user-specified member in a MVS PDS data set named KOTPA01.RACHAEL.MODEL (member name Rachaelk).
```
TSS MODEL USING(Rachael) ACID(NewRac) INTO(kotpa01.rachael.model(Rachaelk))
```
This example generates the model command output for the new acid NewRac using existing acid Rachel in the MVS PDS data set named KOTPA01.RACHAEL.MODEL (without a member name). The member is set to the acid name in the ACID keyword NewRac.
```
TSS MODEL USING(Rachael) ACID(NewRac) INTO(kotpa01.rachael.model)
```

In this example, the INTO keyword is omitted, and the command output appears on screen of the user (or appears as batch output if the command is executed from batch):

TSS MODEL USING(cassie) ACID(newcas)

Command output:

/*MODEL ACID NEWCAS   STORED 02/18/10-14.41.53 BY MASTER1  ON XE15 USING CASSIE
/*Please edit any CREATE commands by adding a PASSWORD keyword to the command
TSS CRE(NEWCAS) NAME('CASSIE E. KOT') TYPE(USER) DEPT(SYSDEPT)
TSS ADD(NEWCAS) GROUP(OMVSGRP)
TSS ADMIN(NEWCAS) MISC4(CERTAUTH CERTUSER CERTGEN  CERTEXPO CERTCHEK)
TSS ADD(NEWCAS) FAC(CICSPROD)
TSS ADD(NEWCAS) FAC(TSO)
TSS ADD(NEWCAS) KERBNAME(CASSIE1PRINCIPAL)
TSS ADD(NEWCAS) MAXTKTLF(0000086400)
TSS ADD(NEWCAS) HOME(/U)
TSS ADD(NEWCAS) DFLTGRP(OMVSGRP)
TSS0300I  MODEL    FUNCTION SUCCESSFUL