28 lines
32 KiB
Plaintext
28 lines
32 KiB
Plaintext
1
|
||
|
||
Lisp Library Modules, Medley Release 1.0, NSMAINTAIN
|
||
1
|
||
|
||
Lisp Library Modules, Medley Release 1.0, NSMAINTAIN
|
||
NSMAINTAIN
|
||
1
|
||
|
||
NSMAINTAIN
|
||
1
|
||
|
||
|
||
NSMAINTAIN
|
||
6
|
||
|
||
NSMaintain(NSMAINTAIN NIL NSMaintain NIL NIL 203) allows you to view and modify objects in the Clearinghouse data base from inside Lisp. Similar operations are available when chatting to a Clearinghouse service(CLEARINGHOUSE% SERVICE NIL Clearinghouse% service NIL NIL 203).
|
||
Requirements
|
||
1
|
||
|
||
Xerox NS network environment with Clearinghouse server(s).
|
||
DES.LCOM.
|
||
Installation
|
||
1
|
||
|
||
Load NSMAINTAIN.LCOM from the library. This file automatically loads DES.LCOM. DES is currently only used by the Change Password command, so its loading can be omitted if you do not need that command.
|
||
Clearinghouse Concepts
|
||
1
|
||
|
||
The Clearinghouse maintains a distributed data base of objects, each of which has a set of properties. The objects(OBJECTS NIL objects NIL NIL 203) are such things as users, groups, and network servers; the properties(PROPERTIES NIL properties NIL NIL 203) are such attributes as a server address or a user's mailbox location.
|
||
Clearinghouse objects are partitioned into a three-level hierarchy: each object is contained in a domain, which in turn is part of an organization(ORGANIZATION NIL organization NIL NIL 203). A fully qualified object name is a three-part name in the form object:domain:organization. Similarly, a domain(DOMAIN NIL domain NIL NIL 203) name is a two-part name of the form domain:organization. Lisp maintains a notion of the default domain, which is typically the domain in which you and the servers in your immediate area are registered. When typing object names, you may omit the organization field or both domain and organization fields if they are the same as your default domain. Similarly, when typing a domain name, you may omit the organization field if it is the same as the default.
|
||
When printing the names of objects, the system usually elides the domain and/or organization, following the same rules. For example, for the object named "John Jones:Sales:ACME", the system would print "John Jones:" if the default domain were "Sales:ACME", or "John Jones:Sales" if the default domain were "Admin:ACME". NSMaintain, however, prints fully qualified names in certain places that do not need the compactness of the elided names, so as to reduce potential confusion. For the same reason, whenever NSMaintain prompts for an object name and you omit one or two of the fields, NSMaintain automatically echoes the defaults for you. You can change the defaults with the "Change Default Domain" command.
|
||
Any object in the Clearinghouse can have one or more aliases(ALIASES NIL aliases NIL NIL 203), which are Clearinghouse names that point directly to the object. An alias can be thought of as a "nickname", and can be used interchangeably with the "real name" for virtually all operations. For example, it is common practice to register users with their full names and provide at least one alias consisting of their last names.
|
||
Some objects in the Clearinghouse are groups, rather than individuals. Groups are described further in the section on group commands.
|
||
For more information on the Clearinghouse service, consult the Interlisp-D Reference Manual or the Clearinghouse documentation, which is part of the Network Systems documentation kit.
|
||
User Interface
|
||
1
|
||
|
||
NSMaintain runs in an Exec window. To start it up, evaluate:
|
||
(NSMAINTAIN(NSMAINTAIN (function) NIL NIL NIL 204)) [Function]
|
||
Starts an NSMaintain session. It prompts with "CH:" in the current window and awaits commands from you. Command names complete automatically following one- or two-letter inputs. Type Q, for the Quit command, when you wish to finish.
|
||
Most of the commands take as input from you one or more Clearinghouse object names. For many commands, NSMaintain offers you the same name as you last used in a similar context. For example, if you use the Describe command to learn about an object that is a group and then use the List Members command, NSMaintain offers you the group name just described. To accept the name, just press the carriage return; otherwise, start typing the desired name; <20><> |