UMSMM 1.3 -*- UMS Mail Monitor -*- ©1994 Thomas Schwarz ======================================================= based on Sabot V1.7 by Scott Ellis ================================== Documentation ============= Description: ------------ UMSMM is basically a clone of Sabot by Scott Ellis, adapted for use with UMS. What UMSMM does is check your UMS messagebase for mail for a given user and do things when some unread mail is there or arrives. Checks for new mail can be triggered either by watching a file or directory for changes using the AmigaDOS notification mechanism or by waiting specific amounts of time. What UMSMM always does is display an AppIcon on your Workbench screen showing you the status of your private UMS "mailbox". If there is no unread mail for you it displays an icon illustrating an "empty mailbox". If there are one or more unread mail messages waiting or something arrives, then the icon changes to a "full mailbox" icon with the number of new messages displayed, until you read your mail. UMSMM can launch programs under three different circumstances: o Mail arrives o Mouse-Click on the AppIcon o Files dropped onto the AppIcon Call Syntax: ------------ KMSMM is started from either the command line or from an Icon with appropriate ToolTypes. All options are optional unless otherwise stated: UMSMM NAME/A,PASSWORD/A,SERVER/K,MA=MAIL/K,NM=NOMAIL/K,NO=NOTIFY/K, TI=TIMER/K/N,XPOS/K/N,YPOS/K/N,CC=CLICKCOMMAND/K,CS=CLICKSTACK/K/N, MC=MAILCOMMAND/K,MS=MAILSTACK/K/N,DC=DROPCOMMAND/K,DS=DROPSTACK/K/N, CQ=CLICKQUIT/S Functionality: -------------- Now let's have a deeper look at the available options: NAME/A The name of the UMS user who's mailbox is to be checked. PASSWORD/A The corresponding UMS account password. SERVER/K Logical name of the UMS server to be addressed. MA=MAIL/K Name of icon to be shown to indicate the presence of unread mail (without ".info" extension). Def: "Filled" NM=NOMAIL/K Name of icon to be shown to indicate that there is *no* new mail (without ".info" extension). Def: "Empty" NO=NOTIFY/K Name of the file or directory to be monitored. Everytime this changes, a new check for mail is done. Def: No checks TI=TIMER/K/N Number of seconds between mail checks. Def: No checks XPOS/K/N Horizontal icon position in pixels. If left out, the icon will be free floating in the X direction. YPOS/K/N Vertical icon position in pixels. If left out, the icon will be free floating in the Y direction, too. CC=CLICKCOMMAND/K Command to be executed when AppIcon is double-clicked (e.g. running your mail-/newsreader). CS=CLICKSTACK/K/N Stacksize which CLICKCOMMAND is to be run with. If CLICKCOMMAND was omitted, CLICKSTACK has no effect. MC=MAILCOMMAND/K Command to be executed when new mail arrives (e.g. playing a sound sample). MS=MAILSTACK/K/N Works according to CLICKSTACK, but for MAILCOMMAND. DC=DROPCOMMAND/K Command to be executed when icons are dropped on the AppIcon. This command is executed once for each icon dropped with the name of the icon appended to it (e.g. a command to send the dropped files as mail). Commands that UMSMM executes are run asynchronously, so if you drag 100 icons onto UMSMM's AppIcon, it will start 100 new processes. That can make for a really slow system ;-) DS=DROPSTACK/K/N Works according to CLICKSTACK, but for DROPCOMMAND. CQ=CLICKQUIT/S Quit after launching CLICKCOMMAND. History: -------- V1.0 + Initial release V1.1 + Lost some memory when started from workbench + If the number of new mails changed, the new number was not displayed + Several cleanups + Two new icons (mt*.info) contributed by Ralf Garbade. Thanks Ralf! V1.2 + Some memory wasn't freed under error conditions + MagicWB-Icons contributed by Jochen Borgmann. Thanks Jochen! + Added CLICKQUIT switch (suggested by Ibrahim Tertemiz) + If started via a project icon, the tooltypes of this one override the corresponding main tooltypes (suggested by Hartmut Goebel) V1.3 + Now checking ViewAccess, too and removed checking of PostPoned flag. To do: ------ Find a better way for triggering mail checks. Perhaps in a future version of UMS there will be some mechanism to send some signal to external programs when special conditions like the arrival of mail are met? Distribution: ------------- "UMSMailMon" is distributed under the terms of the "GNU GENERAL PUBLIC LICENSE" which is included in the UMSMM archive. It would be nice, if I would be informed of any modifications or further developments of UMSMM to coordinate and include them in new releases. Author information: ------------------- It's me :-) Thomas Schwarz Gieshügeler Straße 26 97218 Gerbrunn Germany Email: blacky@bmagic.mayn.sub.de Thomas_Schwarz@wue.maus.de Acknowledgements: ----------------- This program is heavily based on source code taken from the "Sabot" package written by Scott Ellis. The two icons "mt*.info" in the "MoreIcons" drawer were contributed by Ralf Garbade. My thanks go to Ralf! Disclaimer: ----------- This product is meant for educational purposes only. Any resemblance to real persons, living or dead is purely coincidental. Void where prohibited. Some assembly required. List each check separately by bank number. Batteries not included. Contents may settle during shipment. Use only as directed. No other warranty expressed or implied. Do not use while operating a motor vehicle or heavy equipment. Postage will be paid by addressee. Subject to CAB approval. This is not an offer to sell securities. Apply only to affected area. May be too intense for some viewers. Do not stamp. Use other side for additional listings. For recreational use only. Do not disturb. All models over 18 years of age. If condition persists, consult your physician. No user-serviceable parts inside. Freshest if eaten before date on carton. Subject to change without notice. Times approximate. Simulated picture. No postage necessary if mailed in the United States. Breaking seal constitutes acceptance of agreement. For off-road use only. As seen on TV. One size fits all. Many suitcases look alike. Contains a substantial amount of non-tobacco ingredients. Colors may, in time, fade. We have sent the forms which seem to be right for you. Slippery when wet. For office use only. Not affiliated with the American Red Cross. Drop in any mailbox. Edited for television. Keep cool; process promptly. Post office will not deliver without postage. List was current at time of printing. Return to sender, no forwarding order on file, unable to forward. Not responsible for direct, indirect, incidental or consequential damages resulting from any defect, error or failure to perform. At participating locations only. Not the Beatles. Penalty for private use. See label for sequence. Substantial penalty for early withdrawal. Do not write below this line. Falling rock. Lost ticket pays maximum rate. Your cancelled check is your receipt. Add toner. Place stamp here. Avoid contact with skin. Sanitized for your protection. Be sure each item is properly endorsed. Sign here without admitting guilt. Slightly higher west of the Mississippi. Employees and their families are not eligible. Beware of dog. Contestants have been briefed on some questions before the show. Limited time offer, call now to insure prompt delivery. You must be present to win. No passes accepted for this engagement. No purchase necessary. Processed at location stamped in code at top of carton. Shading within a garment may occur. Use only in well-ventilated area. Keep away from fire or flame. Replace with same type. Approved for veterans. Booths for two or more. Check here if tax deductible. Some equipment shown is optional. Price does not include taxes. No Canadian coins. Not recommended for children. Prerecorded for this time zone. Reproduction strictly prohibited. No solicitors. No alcohol, dogs, or horses. No anchovies unless otherwise specified. Restaurant package, not for resale. List at least two alternate dates. First pull up, then pull down. Call toll free before digging. Driver does not carry cash. Some of the trademarks mentioned in this product appear for identification purposes only. Record additional transactions on back of previous stub. Decision of judges is final. This supersedes all previous notices. Quote of the day: ----------------- The trouble with having an open mind, of course, is that people will insist on coming along and trying to put things in it. -- (Terry Pratchett, Diggers)