home *** CD-ROM | disk | FTP | other *** search
/ Meeting Pearls 3 / Meeting_Pearls_III.iso / Pearls / comm / Mail+News / UMS11 / Doc / english / login.txt < prev    next >
Text File  |  1995-06-15  |  3KB  |  80 lines
  1.  
  2.   Different servers
  3.   ~~~~~~~~~~~~~~~~~
  4.  
  5.   You  can  have  multiple  UMS  servers  (message-bases)  on  one
  6. machine. Each server is identified by its SERVERNAME. The function
  7. UMSRlogin()  and  most  UMS tools allow to specify the name of the
  8. server  to  use  as  a parameter in their command-line or in their
  9. GUI.  If  you  don't  explicitly  specify  the server, the default
  10. server  of  you machine is used. The name of the default server if
  11. given  in  the shell- or environment-variable "UMSSERVER". If this
  12. variable  doesn't  exist,  the  default  server  is  simply  named
  13. "default".
  14.  
  15.   An environment-variable "umsmb.<servername>" must exist for each
  16. server you want to run on your machine. It indicates the full path
  17. to  the  specific  message-base (which has its own "ums.config, of
  18. course). Similarly an environment-variable "umsfiles.<servername>"
  19. is  required  for  each  message-base,  if you want to use the new
  20. feature of attached files.
  21.  
  22.   A SERVERNAME should only consist of simple characters (e.g. only
  23. letters and digits), since special characters might be troublesome
  24. for  names  of  shell-variables.  Some  are  even used for special
  25. purposes, as explained in the next chapter.
  26.  
  27.  
  28.   Networking
  29.   ~~~~~~~~~~
  30.  
  31.   Different means of inter-process-communication (IPC) can be used
  32. for  contacting a UMS server from a UMS client. They are addressed
  33. by  the  SERVERNAME, which currently can have one of the following
  34. formats:
  35.  
  36. 1) Local, using Exec-messages:  <servername>
  37. 2) Remote, using Envoy:         <servername>@<hostname>
  38. 3) Remote, using AmiTCP:        <hostname>:<servicename>
  39. 4)                   or:        <hostname>:<portnumber>
  40.  
  41.   <servername> is the SERVERNAME as discussed above.
  42.  
  43.   <hostname>  is the name of the machine the UMS server is running
  44. on, given in the syntax of the used network.
  45.  
  46.   <servicename>  is  the  name  of  an  IP-service,  as defined in
  47. "AmiTCP:db/services"..
  48.  
  49.   <portnumber>  is  an  explicit, decimal socket-portnumber. To be
  50. used  e.g.  if  the  "services"  file  is  not  properly set up or
  51. different on the client- and server-machine.
  52.  
  53.  
  54.   "Fake" Logins
  55.   ~~~~~~~~~~~~~
  56.  
  57.   In order to use the new (V11) function UMSDupAccount() even with
  58. programs  that  don't  know  about  it,  a  "fake"  login has been
  59. implemented into ums.library:
  60.  
  61.   if  a login is attempted with an empty username and the password
  62. is  a  decimally  written, valid UMS account, UMSDupAccount() will
  63. silently  be used instead of UMSRLogin(). I.e. the client will use
  64. the  old  login,  although  it's  another process. This will _not_
  65. create  a  new  login  concerning  the UMS server! _No_ new set of
  66. logins-flags will be created.
  67.  
  68.   Example: name="" password="815"
  69.  
  70.  
  71.   In  order to create a new login with new login-flags etc for the
  72. same  user,  another  "fake login" silently retrieves username and
  73. password  from  an  already existing account. For this purpose you
  74. must  again  use an empty username and a decimally written account
  75. as  password,  but  the  account number must be preceded by an "@"
  76. character.
  77.  
  78.   Example: name="" password="@815"
  79.  
  80.