1 02/13/84  add_mail_table_entry
 2 
 3 Syntax:  add_mail_table_entry name {address} {-control_args}
 4 
 5 
 6 Function:  adds an entry to the mail table and specifies the entry's
 7 mailing address.  This command is used by system administrators to
 8 specify names, usually names of users on other systems, that can be
 9 used to designate mailboxes (Person_id.Project_id), mailing lists, and
10 Forum meetings.  The name must not already exist in the mail table or
11 the person name table (PNT).  Names are not distinguished by case
12 (e.g., Sackman and sackman are the same name).
13 
14 
15 Arguments:
16 name
17    is a string that specifies the name to be given to this mail table
18    entry.  It must be enclosed in quotation marks if it contains blank
19    spaces.
20 address
21    is a destination specifier, that is, a mailing address in the form
22    used by the -mailbox or -user control arguments (see below).  It can
23    be used instead of the -mailbox or -user control arguments.
24 
25 
26 Control arguments:
27 -acs_path path
28    specifies the Access Control Segment (ACS) which controls who may
29    update the entry's mail address.  rw access to the ACS indicates
30    that a user may update the entry.  If this is not specified or is
31    the null string, only users with access to mail_table_priv_ may
32    update the entry.
33 -alias name
34    specifies an alternate name for the name being defined.  If this
35    control argument is specified multiple times, all the names are
36    defined as aliases for the entry.
37 -log path
38    specifies the pathname of a logbox and is equivalent to
39    -mailbox >udd>Project_id>Person_id>Person_id.sv.mbx
40 
41 
42 -mailing_list path, -mls path
43    specifies the name of a mailing list.  The suffix "mls" is added if
44    necessary.  The archive component pathname convention is accepted.
45 -mailbox path, -mbx path
46    specifies the pathname of a mailbox.  The suffix "mbx" is added if
47    necessary.
48 -meeting path, -mtg path
49    specifies the pathname of a Forum meeting.  The suffix "control" is
50    added if necessary.
51 -save path, -sv path
52    specifies the pathname of a savebox.  The suffix "sv.mbx" is added
53    if necessary.
54 
55 
56 STR -at FSystem {-via RelayN...-via Relay1}
57    specifies an address on another computer system.  STR identifies the
58    user (or group of users) to receive the message and is not
59    interpreted in any way by the local system.  FSystem is the name of
60    the foreign system where the address is located.  If the optional
61    -via control arguments are not present, FSystem must be one of the
62    names of a foreign system in the local system's network information
63    table (NIT).  If, however, the -via control arguments are specified,
64    the foreign system name does not need to be known to the local
65    system.
66 
67 
68    If the -via control arguments are specified, they identify an
69    explicit route to be used to reach the foreign system.  In this
70    case, Relay1 must be one of the names of a foreign system in the
71    local system's NIT.  Mail destined for this foreign address is
72    forwarded to the system identified in Relay1.  From there it is
73    forwarded to the system identified as Relay2, etc.  until it reaches
74    the system identified as RelayN, where it is delivered to the system
75    on which the foreign address actually resides.  When the NIT is
76    querried for either FSystem or Relay1, the query is performed in a
77    case insensitive manner.
78 -user Person_id.Project_id
79    specifies the given user's default mailbox under the specified
80    project.  This control argument is equivalent to
81    -mailbox >udd>Project_id>Person_id>Person_id.mbx
82 
83 
84 Access required:  The user must have e access to the gate
85 mail_table_priv_.