1 02/07/82  inq
 2 
 3 
 4 Syntax:  inq -key {args}
 5 
 6 
 7 Syntax as an active function:  [inq -key {args}]
 8 
 9 
10 Function:  A simplistic interface to the Inquire User Personal
11 Database System.
12 
13 
14 List of keys:
15 -get {userid} {field_names}
16     Returns the values of the given fields in the specified
17     user's entry.  If the userid is the null string or is not
18     given, then the userid of the caller is used.  If the
19     field_names are not specified, then all the fields are
20     returned.  If field_names are specified, then a userid must
21     be specified.
22 -getn last_name {field_names}
23     Like -get except that it searches for the entries whose
24     last_name fields are the given last_name.  This may return
25     data for more than one entry.
26 -set field_name_1 value_1 {... field_name_n value_n}
27     Sets the values of the specified fields in the calling user's
28     entry.  If the entry did not previously exist, it is created,
29     and the entry privacy flag is set on (see the -set_epriv key
30     below for instructions on changing this flag).
31 
32 -all_userids, -au
33     Returns the userid fields of every entry in the database.
34 -list, -ls
35     Returns all the valid field names.
36 -close
37     Closes the database, which is normally left open for the
38     duration of the process for efficiency.
39 
40 
41 -get_epriv
42     Returns the state of the privacy switch for the caller's
43     entry.
44 -set_epriv on|off
45     Sets the state of the privacy switch for the caller's entry
46     to the given value.  If the entry does not already exist it
47     is created.
48 -get_fpriv {field_names}
49     Returns the statse of the privacy switches of the specified
50     fields in the caller's entry.  If no field_names are
51     specified, then all are used.
52 -set_fpriv field_name_1 on|off {... field_name_n on|off}
53     Sets the states of the privacy switches of the specified
54     fields in the caller's entry.  If the entry did not already
55     exist it will be created, and the entry privacy switch will
56     be set on.