home *** CD-ROM | disk | FTP | other *** search
/ Meeting Pearls 3 / Meeting_Pearls_III.iso / Pearls / comm / Mail+News / UMS11 / Doc / english / Bouncer.doc next >
Text File  |  1993-09-15  |  3KB  |  70 lines
  1.  
  2.                 BOUNCER
  3.                 ~~~~~~~
  4.  
  5. Format:   BOUNCER <name> <password> [SERVER <server>] [TIMEOUT <timeout>]
  6. ~~~~~~~           [SHOWBOUNCED] [HIDEBOUNCE] [NODEMODE] [TEST]
  7.  
  8. Template: NAME/A,PASSWORD/A,SERVER/K,TIMEOUT/K/N,SHOWBOUNCED/S,
  9. ~~~~~~~~~ HIDEBOUNCE/S,NODEMODE/S,TEST/S
  10.  
  11. Purpose:  Take care of not exportable messages.
  12. ~~~~~~~~
  13.  
  14. Specification:
  15. ~~~~~~~~~~~~~~
  16.  
  17. In  some  cases  it might be possible that a UMS-system is not able to
  18. route  a  message to it's intended destination. E.g. a mail is written
  19. to  a local user that does not exist. Or an exporter tells UMS that an
  20. error  occured  while  exporting  a  message  (see  also: ums.library/
  21. CannotExport()).
  22.  
  23. In  these cases BOUNCER informs the author of such a message about the
  24. problem  that  had  occured.  This  is  done  by  writing  a so-called
  25. "bounce-mail". In NODEMODE or if the receiver is a local user, this is
  26. addressed  to  the  author of the bounced message. Otherwise the local
  27. user "Sysop" is used.
  28.  
  29. If you use UMS in FULLNODE-mode you should run BOUNCER regularly, e.g.
  30. once  every  day.  Otherwise  you'd  have to care about each erraneous
  31. message yourself.
  32.  
  33. If you use UMS in leave-mode (i.e. not FULLNODE-mode), you should also
  34. run  BOUNCER,  e.g.  after  every  import. This makes sure that you're
  35. always  informed  when  an  exporter  was unable to export one of your
  36. messages  (this  is  currently  most important for users of the German
  37. MausNet).
  38.  
  39.  
  40. Invocation:
  41. ~~~~~~~~~~~
  42. you  must  specify  a  valid  username/password  combination.  You may
  43. specify  a  UMS-server  if  you  don't want to use the default-server.
  44. BOUNCER must only be used by users with SYSOP privilege. It won't work
  45. when used with a UMS account that has no SYSOP privilege.
  46.  
  47. You  may  specify  the  TEST  option.  This  allows  you  to  see what
  48. bounce-mails BOUNCER would write, whithout actually doing so.
  49.  
  50. Other options:
  51.  
  52. NODEMODE  --
  53.   this should be used when running the UMS system in FULLNODE-mode. It
  54. enables writing bounce-mails to remote users.
  55.  
  56. TIMEOUT  -- 
  57.   if  this is specified, BOUNCER will also act an messages that are at
  58. least <timeout> days waiting to be exported. Otherwise they might wait
  59. forever if the exporters don't tell UMS they cannot export it.
  60.  
  61. SHOWBOUNCED --
  62.   leave  the bounced messages new for the invoking user. Normally they
  63. are  be  marked  as old so the sysop does not nedd to mess around with
  64. already bounced messages.
  65.  
  66. HIDEBOUNCE  --
  67.   don't  make  the  written  bounce-mails  new  for the invoking user.
  68. Normally they are made new, so that the sysop sees what is going on on
  69. his system.
  70.