home *** CD-ROM | disk | FTP | other *** search
/ Meeting Pearls 3 / Meeting_Pearls_III.iso / Pearls / comm / Mail+News / UMS11 / Doc / english / UMSMM.doc < prev    next >
Text File  |  1994-10-09  |  9KB  |  221 lines
  1.  
  2.  
  3.  
  4.           UMSMM 1.3 -*- UMS Mail Monitor -*- ©1994 Thomas Schwarz
  5.           =======================================================
  6.  
  7.                     based on Sabot V1.7 by Scott Ellis
  8.                     ==================================
  9.  
  10.  
  11.  
  12.                                 Documentation
  13.                                 =============
  14.  
  15.  
  16.  
  17. Description:
  18. ------------
  19.  
  20. UMSMM is basically a clone of Sabot by Scott Ellis, adapted  for  use  with
  21. UMS.
  22.  
  23. What UMSMM does is check your UMS messagebase for mail for a given user and
  24. do  things  when  some unread mail is there or arrives. Checks for new mail
  25. can be triggered either by watching a file or directory for  changes  using
  26. the AmigaDOS notification mechanism or by waiting specific amounts of time.
  27.  
  28. What UMSMM always does is display  an  AppIcon  on  your  Workbench  screen
  29. showing you the status of your private UMS "mailbox". If there is no unread
  30. mail for you it displays an icon illustrating an "empty mailbox". If  there
  31. are one or more unread mail messages waiting or something arrives, then the
  32. icon changes to a "full mailbox" icon  with  the  number  of  new  messages
  33. displayed, until you read your mail.
  34.  
  35. UMSMM can launch programs under three different circumstances:
  36.  
  37. o Mail arrives
  38.  
  39. o Mouse-Click on the AppIcon
  40.  
  41. o Files dropped onto the AppIcon
  42.  
  43.  
  44.  
  45. Call Syntax:
  46. ------------
  47.  
  48. KMSMM is started from  either  the  command  line  or  from  an  Icon  with
  49. appropriate ToolTypes. All options are optional unless otherwise stated:
  50.  
  51. UMSMM NAME/A,PASSWORD/A,SERVER/K,MA=MAIL/K,NM=NOMAIL/K,NO=NOTIFY/K,
  52.       TI=TIMER/K/N,XPOS/K/N,YPOS/K/N,CC=CLICKCOMMAND/K,CS=CLICKSTACK/K/N,
  53.       MC=MAILCOMMAND/K,MS=MAILSTACK/K/N,DC=DROPCOMMAND/K,DS=DROPSTACK/K/N,
  54.       CQ=CLICKQUIT/S
  55.  
  56.  
  57.  
  58. Functionality:
  59. --------------
  60.  
  61. Now let's have a deeper look at the available options:
  62.  
  63. NAME/A            The name of the UMS user who's mailbox is to be checked.
  64. PASSWORD/A        The corresponding UMS account password.
  65. SERVER/K          Logical name of the UMS server to be addressed.
  66. MA=MAIL/K         Name of icon to be shown to indicate the presence of
  67.                   unread mail (without ".info" extension). Def: "Filled"
  68. NM=NOMAIL/K       Name of icon to be shown to indicate that there is *no*
  69.                   new mail (without ".info" extension). Def: "Empty"
  70. NO=NOTIFY/K       Name of the file or directory to be monitored. Everytime
  71.                   this changes, a new check for mail is done. Def: No checks
  72. TI=TIMER/K/N      Number of seconds between mail checks. Def: No checks
  73. XPOS/K/N          Horizontal icon position in pixels. If left out, the icon
  74.                   will be free floating in the X direction.
  75. YPOS/K/N          Vertical icon position in pixels. If left out, the icon
  76.                   will be free floating in the Y direction, too.
  77. CC=CLICKCOMMAND/K Command to be executed when AppIcon is double-clicked
  78.                   (e.g. running your mail-/newsreader).
  79. CS=CLICKSTACK/K/N Stacksize which CLICKCOMMAND is to be run with. If
  80.                   CLICKCOMMAND was omitted, CLICKSTACK has no effect.
  81. MC=MAILCOMMAND/K  Command to be executed when new mail arrives
  82.                   (e.g. playing a sound sample).
  83. MS=MAILSTACK/K/N  Works according to CLICKSTACK, but for MAILCOMMAND.
  84. DC=DROPCOMMAND/K  Command to be executed when icons are dropped on the
  85.                   AppIcon. This command is executed once for each icon
  86.                   dropped with the name of the icon appended to it
  87.                   (e.g. a command to send the dropped files as mail).
  88.                   Commands that UMSMM executes are run asynchronously,
  89.                   so if you drag 100 icons onto UMSMM's AppIcon, it will 
  90.                   start 100 new processes. That can make for a really slow
  91.                   system ;-)
  92. DS=DROPSTACK/K/N  Works according to CLICKSTACK, but for DROPCOMMAND.
  93. CQ=CLICKQUIT/S    Quit after launching CLICKCOMMAND.
  94.  
  95.  
  96.  
  97. History:
  98. --------
  99.  
  100. V1.0 + Initial release
  101. V1.1 + Lost some memory when started from workbench
  102.      + If the number of new mails changed, the new number was not displayed
  103.      + Several cleanups
  104.      + Two new icons (mt*.info) contributed by Ralf Garbade. Thanks Ralf!
  105. V1.2 + Some memory wasn't freed under error conditions
  106.      + MagicWB-Icons contributed by Jochen Borgmann. Thanks Jochen!
  107.      + Added CLICKQUIT switch (suggested by Ibrahim Tertemiz)
  108.      + If started via a project icon, the tooltypes of this one override
  109.        the corresponding main tooltypes (suggested by Hartmut Goebel)
  110. V1.3 + Now checking ViewAccess, too and removed checking of PostPoned flag.
  111.  
  112.  
  113.  
  114. To do:
  115. ------
  116.  
  117. Find a better way for triggering mail checks. Perhaps in a  future  version
  118. of  UMS  there  will  be  some  mechanism  to  send some signal to external
  119. programs when special conditions like the arrival of mail are met?
  120.  
  121.  
  122.  
  123. Distribution:
  124. -------------
  125.  
  126. "UMSMailMon" is distributed under the terms  of  the  "GNU  GENERAL  PUBLIC
  127. LICENSE" which is included in the UMSMM archive.
  128.  
  129. It would be nice, if I would be informed of any  modifications  or  further
  130. developments of UMSMM to coordinate and include them in new releases.
  131.  
  132.  
  133.  
  134. Author information:
  135. -------------------
  136.  
  137. It's me :-)
  138.  
  139. Thomas Schwarz
  140. Gieshügeler Straße 26
  141. 97218 Gerbrunn
  142. Germany
  143.  
  144. Email: blacky@bmagic.mayn.sub.de
  145.        Thomas_Schwarz@wue.maus.de
  146.  
  147.  
  148.  
  149. Acknowledgements:
  150. -----------------
  151.  
  152. This program is heavily based on source code taken from the "Sabot" package
  153. written by Scott Ellis.
  154.  
  155. The two icons "mt*.info" in the "MoreIcons" drawer were contributed by Ralf
  156. Garbade. My thanks go to Ralf!
  157.  
  158.  
  159.  
  160. Disclaimer:
  161. -----------
  162.  
  163. This product is meant for educational purposes  only.  Any  resemblance  to
  164. real persons, living or dead is purely coincidental. Void where prohibited.
  165. Some  assembly  required.  List  each  check  separately  by  bank  number.
  166. Batteries  not  included.  Contents may settle during shipment. Use only as
  167. directed. No  other  warranty  expressed  or  implied.  Do  not  use  while
  168. operating  a  motor  vehicle  or  heavy  equipment. Postage will be paid by
  169. addressee.  Subject  to  CAB  approval.  This  is  not  an  offer  to  sell
  170. securities.  Apply  only  to  affected  area.  May  be too intense for some
  171. viewers. Do  not  stamp.  Use  other  side  for  additional  listings.  For
  172. recreational  use only. Do not disturb. All models over 18 years of age. If
  173. condition persists,  consult  your  physician.  No  user-serviceable  parts
  174. inside.  Freshest if eaten before date on carton. Subject to change without
  175. notice. Times approximate.  Simulated  picture.  No  postage  necessary  if
  176. mailed  in  the  United  States.  Breaking  seal  constitutes acceptance of
  177. agreement. For off-road use only. As seen on TV. One size  fits  all.  Many
  178. suitcases   look  alike.  Contains  a  substantial  amount  of  non-tobacco
  179. ingredients. Colors may, in time, fade. We have sent the forms  which  seem
  180. to be right for you. Slippery when wet. For office use only. Not affiliated
  181. with the American Red Cross. Drop in any mailbox.  Edited  for  television.
  182. Keep  cool; process promptly. Post office will not deliver without postage.
  183. List was current at time of printing. Return to sender, no forwarding order
  184. on   file,  unable  to  forward.  Not  responsible  for  direct,  indirect,
  185. incidental or consequential damages resulting from  any  defect,  error  or
  186. failure  to  perform.  At  participating  locations  only. Not the Beatles.
  187. Penalty for private use. See label for sequence.  Substantial  penalty  for
  188. early  withdrawal.  Do not write below this line. Falling rock. Lost ticket
  189. pays maximum rate. Your cancelled check is your receipt. Add  toner.  Place
  190. stamp here. Avoid contact with skin. Sanitized for your protection. Be sure
  191. each item is properly endorsed. Sign here without admitting guilt. Slightly
  192. higher  west  of  the  Mississippi.  Employees  and  their families are not
  193. eligible. Beware of dog. Contestants have been briefed  on  some  questions
  194. before  the  show.  Limited time offer, call now to insure prompt delivery.
  195. You must be present to win. No passes  accepted  for  this  engagement.  No
  196. purchase necessary. Processed at location stamped in code at top of carton.
  197. Shading within a garment may occur. Use only in well-ventilated area.  Keep
  198. away  from  fire  or  flame. Replace with same type. Approved for veterans.
  199. Booths for two or more. Check here if tax deductible. Some equipment  shown
  200. is  optional.  Price  does  not  include  taxes.  No  Canadian  coins.  Not
  201. recommended for children. Prerecorded  for  this  time  zone.  Reproduction
  202. strictly  prohibited.  No  solicitors.  No  alcohol,  dogs,  or  horses. No
  203. anchovies unless otherwise specified. Restaurant package, not  for  resale.
  204. List at least two alternate dates. First pull up, then pull down. Call toll
  205. free before digging. Driver does not carry cash.  Some  of  the  trademarks
  206. mentioned  in  this product appear for identification purposes only. Record
  207. additional transactions on back of previous stub.  Decision  of  judges  is
  208. final.
  209.  
  210. This supersedes all previous notices.
  211.  
  212.  
  213.  
  214. Quote of the day:
  215. -----------------
  216.  
  217. The trouble with having an open mind, of course, is that people will insist
  218.               on coming along and trying to put things in it.
  219.                        -- (Terry Pratchett, Diggers)
  220.  
  221.