filename.users Definition/Access: General, master.dictionary Definition/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

master.dictionary

Command master.dictionary Definition/General
Applicable release versions: AP, R83
Category General (155)
Description file which contains verbs, procs, macros, menus, connectives, default attribute-defining items, and file-defining items - both local ("d-pointers") and synomym ("q-pointers").

There is one master dictionary (md) file for each account. When a new account is created, a standard set of vocabulary items are copied into the new account's md. File-defining items ("d-pointers") and synonym-defining items ("q-pointers") are two types of file pointers found in an md. File-defining items point to files within the current account. Synonym-defining items can point to files either within the current account or within other accounts.

Attributes 2 and 3 of file-defining items in an account md contain the base fid and modulo respectively of the file dictionary to which the item points.

The usage and definition of the attributes in the master dictionary file-defining item are:

Attribute 0: item-id. Contains the name of the file being defined.

Attribute 1: Dictionary Code

This attribute must contain a "d". Along with the character d, the following options are also available:

l Log any updates to the system transaction logger.

p Primary filespace contains only pointer items.

s Item-ids are case sensitive.

x Do not save file contents on file save. File does not exist on restore.

y Do not save file contents on file save. An empty file of the same modulo exists after restore.

Attribute 2: Base. Attribute 2 contains the base frame number of the associated file.

Attribute 3: Modulo. Attribute 3 contains the number of contiguous frames in the primary file space of the file. The default is 37.

Attribute 4: Reserved and Unavailable

Attribute 5: Retrieval Lock

In the md, this attribute controls access to dictionaries. Any one of the user's multi-valued lock codes in attribute 5 of the user's item in the users file must match the first lock code specified in this attribute in order to access the appropriate dictionary. Multiple lock codes are separated by value marks within this attribute.

Attribute 6: Update Lock

The update lock attribute controls access to account master dictionaries or file dictionaries for update. One of the user's lock codes in attribute 6 of the user's item in the users file must match the first lock code specified in this attribute in order to update the appropriate dictionary. Multiple lock codes are treated as multiple values and are separated by value marks within this attribute.

Attribute 7: Password(s). Attribute 7 contains the optional account password(s) required to access the master dictionary. The encrypted password(s) is/are displayed. Passwords may be multi-valued.

Attribute 8: Reserved and Unavailable

Attribute 9: Attribute type: Justification

The attribute type contains codes used to specify justification. See "attribute-type" for a description of justification types.

Attribute 10: Column Width

The column width attribute is used to define the number of character spaces to be allocated for displaying the data within the attribute on Access reports.

Attribute 11: Reserved and Unavailable

Attribute 12: Reserved and Unavailable

Attribute 13: Reallocation. This attribute is used in the save and restore process to redefine the value of the modulo of the associated file.

Attribute 17: Description. This attribute is used for comments and descriptions concerning the function of the file. To change the information in the "mds" file, use UP. Items can be added, deleted, or modified by executing one of the following command sequences from the dm account:

u mds account.name

create-account account.name

account-maint account.name

UP displays the contents of attributes 1 through 10 (with default values in place for new accounts). To add to the contents of attribute 13, move the cursor to the end of attribute 10, press <return> three times and add the new modulo surrounded by parentheses to resize the master dictionary in attribute 13.
Syntax
Options
Example
Purpose
Related filename.md
tcl.listverbs
attribute-type
account
pointer.item