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