ACCOUNT command

Use the ACCOUNT command and its subcommands to manage the entries in the user attribute data set (SYS1.UADS) and in the broadcast data set. You can execute the command and subcommands in either a time-sharing session or as a batch job.

The UADS contains information about each terminal user who is authorized to use TSO/E. In turn, TSO/E uses that information to regulate access to the system.

The broadcast data set can contain notices and mail for the user IDs defined in SYS1.UADS.

The syntax of the ACCOUNT command is:

ACCOUNT

Allocate SYS1.UADS as SHR prior to using the ACCOUNT command. When issued from a batch environment, the ACCOUNT command and its subcommands access the broadcast data set via the SYSLBC DD name. If no SYSLBC DD statement is specified in the job, the active broadcast data set will be used by the command. If a SYSLBC DD statement is specified in the job, the referenced data set will be used as the broadcast data set.

The ADD, CHANGE, DELETE, and LIST subcommands contain a positional parameter that is designated as the nodelist. Each item in the nodelist (that is, userid, password, acct-nmbr, proc) is designated as a node in a hierarchical structure, with userid at the highest level and proc at the lowest level.

The syntax definitions of the ADD, CHANGE, and DELETE subcommands, are presented in two forms for each subcommand.

  1. for ADD
    • create mode - add new TSO/E users, that is, create new entries in SYS1.UADS and broadcast data set
    • add mode - add data (nodes, attributes) to existing entries in SYS1.UADS
  2. for CHANGE
    • change data (nodes, attributes) in entries in the UADS, and user IDs in the broadcast data set
    • change only the requirements of a procedure (or procedures)
  3. for DELETE
    • delete particular node(s) from an entry (or entries) in the UADS
    • delete an entire entry or delete a node together with all lower-level associated nodes