almclk man page

     NAME
          almclk - set an alarm clock

     SYNOPSIS
          almclk [ -Vb ] [ -a time ] [ time ] [ AM/PM designation ] [
          message ]

     DESCRIPTION
          Almclk sets an alarm at your terminal similar to the way an
          alarm clock works.  When invoked, it runs in the background
          and when the alarm goes off, it will send a message to the
          invoker's terminal(s) or to the invoker as electronic mail
          if the invoker is not logged in.  In addition, if it can, it
          will pop up a window with the message (the user then needs
          to dismiss that window).  There is an optional message that
          can be specified when executing almclk so that this message,
          in addition to the default message (Alarm went off), is
          printed when the alarm goes off.  If the alarm is invoked
          more than eight minutes before it is due to go off, there is
          a five-minute warning issued to the terminal and a window is
          popped up if possible (but no message is sent via e-mail).

          The alarm can be terminated by executing a kill file that is
          placed in the invoker's bin directory when almclk is exe-
          cuted.  It is called killalm.<time>, where <time> is the
          time that the invoker specified when executing almclk.  The
          kill file is removed from the invoker's bin directory either
          when the invoker executes it or when almclk has completed.

     OPTIONS
          -V   print version number
          -b   banner the alarm messages instead
          -a   user specified army time (00:00 - 23:59)

     EXAMPLES
          almclk
               Prompts the invoker for the time when the alarm is to
               fire.  The alarm will fire at the specified time with
               the default message.

          almclk -V
               The version of this tool is displayed.

          almclk 12:00
               The alarm fires at noon if it was invoked between mid-
               night and noon, or it fires at midnight if it was
               invoked between noon and midnight.  That is, the alarm
               fires at the next 12:00.  Also, this example will print
               the default message.

          almclk 12:00 PM
               The alarm fires at the next noon (today if this was


               executed prior to noon, or tomorrow if this was exe-
               cuted after noon) with the default message.

          almclk 12:00 a.m. meeting time
               The alarm fires at the next midnight with the message
               meeting time following the default message.

          almclk -b 02:00 am meeting time
               The alarm fires at the next 2:00 AM with the bannered
               message meeting time following the bannered default
               message.

          almclk -ba 22:00 meeting time
               The alarm fires at the next 22:00 (or 10:00 PM) with
               the bannered message meeting time following the ban-
               nered default message.

     CAVEATS
          If the machine on which almclk was executed goes down before
          the alarm fires, and even if the machine comes back up
          before the alarm is supposed to fire, the alarm will never
          fire, and the kill file will be left lying around.  The
          almclk command must be re-executed to reinstate the alarm.

     PROVIDER
          Mark Tischler