filename.users Definition/Access: General

filename.users

Command filename.users Definition/Access: General
Applicable release versions: AP
Category Access: General (65)
Description 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.
Syntax
Options
Example
:up md,users,  ge

users  'ge' size=318

name       George Elvin
address    Shipping & Receiving
zip
phone      x.449
keys
password
privilege  sys2
options    n
macro      logto dm
10 set-sym gsym
11 brk-level
12 bulletin.board new
13 tcl-hdr-off
Purpose
Related tcl.admin.maint
tcl.case
proc.logon
tcl.tcl
tcl.choose.term
tcl.term-type
tcl.set-term
passwords
security
system.privileges
restricted.system.access
filename.tcl-stack
tcl.case-off
user-id
file.lock.codes
basic.retrieval.locks
gfe.handler
group.format.error
account
tcl.phantom
tcl.lu
filename.accounts
dm.account
logon