filename.users

contains specific data relevant to each individual authorized user on the system.

Each user should have their own unique logon item-id in the 'users' file. The tcl-stack item for each user uses the same item-id as the logon item-id in the 'users' file.

The simplest means of updating user items is to use the Update processor from the dm account, using the command u users item-id, where the item-id is a new or existing item-id in the 'users' file.

The attributes in the 'user's' file are:

0 (item-id) Usually the users initials.
1 Name
2 Address
3 Zip
4 Phone
5 Unused
6 User's retrieval and update keys. See 'retrieval locks'.
7 Optional logon password(s). See 'password'.
8 Privilege level. See 'system privileges'.
9 User session options:
a Updates accounting history file at logoff.
g Stops at GFE's and offers option to '(L)ogoff, (C)ontinue, or (Q)uit.'
i Indicates that the item-id of the tcl-stack accessed will be the same as the pib number. (AP 6.2 or higher)
m Invokes GFE handler on any GFE encountered. See 'gfe handler'.
p Causes phantom processes initiated by this user-id to terminate and wrap up, rather than simply going to sleep when a GFE is encountered. (AP 6.1 and higher releases only).
r Restarts account logon procedure or macro on any <break>.
t{'command'} Restarts account logon procedure on any attempt to go to TCL. An optional TCL command may be specified in quotes immediately after the 't' option to force execution of an alternate command in this situation. This TCL command may contain spaces and/or options, but cannot contain other double-quotes. (AP 6.2 or higher)
10 unused.
11 Unused
12 User logon macro. This is the same as a TCL macro without the macro type code, (in attribute 1) which is assumed to be 'n' (for 'non-stop'). Any number of TCL commands may be placed on attributes 12 and beyond (multi-valued). Each command will be executed before the user is logged on. Typical logon commands might include 'logto master.dictionary', 'sp-assign form.queue', 'brk-level', 'bulletin.board' and so on.