SMALLalarm

        Copyright (c) 1989 - David S. Egan  - All Rights Reserved


        SMALLalarm was written to fullfill a need that I felt lacking
    with the CLOCK program supplied by Commodore-Amiga on the
    Workbench disk.  I needed an alarm that could accomodate several
    different "times" as well as using the minimum amount of RAM (us
    A1000 512k owners are stingy that way!).  This program will occupy
    approximately 25k of memory (54k when a requester is open).  I
    also wrote this program to learn how to send a message to an
    already running program.  I've made this software as easy to use
    as I could, as well as observing the Amiga Operating System rules.
    If you encounter a problem with this software, please try to
    notify me so that I can fix the problem(s).  See the end of this
    document for ways to reach me.

        I am releasing this program, SMALLalarm, as Public Domain
    software but still retain all the rights to the program.  In other
    words, don't use my program except as I intended it:  for a person
    to use as a stand alone alarm on their Amiga.  It may be freely
    distributed, providing that this file is included with it.  If you
    find some use for this software in another product or piece of
    software, get in touch with me.

    USAGE:   (SMALLalarm will track a maximum of five (5) alarms)

        WORKBENCH:

          Click on SMALLalarm ICON.
              A requester opens up, allowing you to enter the time and
              text that you desire.  When things look the way you want
              them, click on the "OK" gadget and I'll take care of the
              rest.  If you decide that you aren't interested in a new
              alarm after all, click on the "CANCEL" gadget, and the
              program will go away.

              Please note that these are standard AMIGA Intuition
              gadgets, so they behave as you are probably used to. To
              clear the text in a gadget press Right-Amiga-X; also the
              text gadget scrolls.


        CLI:

          RUN SMALLalarm [+]hh:mm  [text]
                         (brackets signify optional parameters.  They
                          are not part of the actual parameter(s)).

              where:  +       is optional
                                signifies a time of plus hh:mm hours
                                from now.  Note that if you use the +,
                                I will let you specify almost any
                                mm, so be careful here or your
                                timer won't go off for quite some
                                time!

                      hh:mm   is MANDATORY
                                This is the time that you want the
                                alarm to go off.  Note that this is
                                in 24 hour clock nomenclature.  For
                                example, if you want the alarm to go
                                off at 11:15 PM, use 23:15.  If you
                                wanted an alarm at 9:18 AM, use 9:18.
                                If you enter a time with out the
                                colon (:), I treat it as minutes and
                                let you have anything here, so
                                again, be careful.  If you enter
                                something that I don't like, I'll tell
                                you!

                      text    is optional
                                This is upto 40 characters of text
                                that you want the alarm to remind you
                                of.  If you have spaces in the text,
                                surround the whole string with double
                                quotes "just like this".

    *  Note:  The use of the CLI command RUN is necessary for the
              first invocation of the program.  If you forget the RUN,
              the CLI that started the program will wait until
              SMALLalarm finishes.  If SMALLalarm is already running,
              you can request another alarm, without the use of the
              RUN command.  This functions the same way as POPCLI.  I
              send a message to the already running SMALLalarm about
              your new alarm request, and then the second invocation
              of the program exits, freeing the CLI. To be safe,
              always use the RUN command prepended to SMALLalarm (RUN
              SMALLalarm)!

              Also note that if you start SMALLalarm without any
              parameters, I'll open the requester for you to enter
              your time and text.  In that case, see the WORKBENCH
              instructions!

    Finally-  The WORKBENCH screen is forced to the front when your
              alarm goes off.  A system Requester pops up with your
              alarm text in it.  I figured that this would really get
              your attention, especially if you are involved in
              something else that has opened another screen. To kill
              the Requester, click on the "OK" gadgets, or use
              Left-Amiga B or V (See AmigaDOS 1.2 enhancer manual,
              page 3).  If you want to get back to what you were
              doing, click on the Screen-To-Back gadget in the upper
              corner until your application re-appears!


How to find me.

              GEnie:        EMAIL D.EGAN
              Amiga-INN:    (714)272-5881 Steve Taylor - SYSOP
                            (Truly a fine BBS - So. Calif area).


        Again, if you find something deadly wrong with this, let me
        know.  I'd really hate to cause anybody grief with this
        program.  I tested it as well as I could!  If you have any
        comments about this program, please feel free to contact me.

        If you have any ideas for software that YOU would like to
        have/see, let me know at the above methods.  I might be
        interested too!

Thanks,
   Dave Egan  B-)