XALARM(1)           RISC/os Reference Manual            XALARM(1)



NAME
     xalarm - digital programmable alarm clock for X/Motif

SYNOPSIS
     xalarm [-toolkitoption ...]

DESCRIPTION
     xalarm is a programmable alarm clock that will send messages
     to  you at specified times.  An alarm message will appear in
     a window which you can make  go  away  or  "snooze"  on  it.
     Periodic  messages can also be programmed.  Pending messages
     can be viewed and removed from the system.

     xalarm looks like an alarm clock on your screen  and  is  an
     accurate clock (time, day, and date) when its not being pro-
     grammed.

     To use xalarm, you must be authorized to use the  Unix  `at'
     command on the machine on which you execute xalarm.

PROGRAMMING
     In the upper right hand corner of the xalarm  display  there
     are  three  toggle buttons labeled `day', `hour', and `min'.
     Only one of these may be pushed in at a time.   Pushing  one
     of  these  buttons  initiates programming mode.  Now use the
     `<<' and `>>' keys to move the day, hour, or minute  forward
     or  backward according to what time you wish the alarm to go
     off.  Push the `day' button to adjust the  day,  the  `hour'
     button  to  adjust  the hour, and the `min' button to adjust
     the minute.

     When you've set the time at which you want the alarm  to  go
     off,  push  the  `set' key in the lower right hand corner of
     the xalarm display.  Pushing this button will bring  up  the
     message  edit  window.   This  is a simple text editor where
     you'll type the message associated  with  this  alarm  time.
     When  you  are done typing in your message, you can push the
     `set' button to set the alarm and  you're  done.   If  you'd
     like  this  alarm  to go off at a regularly scheduled period
     time, push the `repeat' key.  A window  will  come  up  with
     three  sliders  on  it, one for days, one for weeks, and one
     for months.  You can move the sliders so that  your  message
     will  be  displayed every N days or every N weeks or every N
     months, where N can be from 1 to 31.  When you're satisfied,
     push the `OK' button to exit the slider window and then push
     `set' in the message edit window to set the alarm.

PENDING ALARMS
     The small button just below the AM/PM indicator on the  left
     hand  side  of the alarm display will bring up a window that
     allows you to view  or  remove  pending  alarms.   You  must
     select  an  alarm  with the mouse select button (usually the



                         Printed 1/24/91                   Page 1

XALARM(1)           RISC/os Reference Manual            XALARM(1)



     left one) and then push the appropriate `view'  or  `remove'
     button.   The `cancel' button exits that window without per-
     forming any action.

OPTIONS
     xalarm accepts all of the standard X  Toolkit  command  line
     options.   All of the xalarm resources can be specified with
     the -xrm X Toolkit command line option as well.

XDEFAULTS
     xalarm is made up of a number of Motif widgets.  It is built
     up  from  push  buttons,  toggles,  text  editors, selection
     boxes, etc.  As  such  it  inherits  all  of  the  resources
     belonging  to  these  widgets and all of these can be set by
     the user in .Xdefaults or other system resource files.   The
     Colors of the various pieces of xalarm are the most commonly
     customized resources.  Besides the widget resources,  xalarm
     also defines the following:

     filePath

          The fully qualified path to where alarm  messages  will
          be  stored.   By  default, alarm message files are kept
          in your $HOME directory.

     displayProgram

          The fully qualified path and name of the  program  used
          to  display  alarm messages.  This display program is a
          separate    X    window    program.     The     program
          `xalarm_display' comes with the xalarm installation and
          is used for this purpose.

     tickTock

          This default is set to `True' if  you  like  the  small
          dots  that  separate  the  hours  from  the  minutes on
          the segmented display to  blink.   Set  it  to  `False'
          if you don't like them blinking.

DIAGNOSTICS
     If you try to set an alarm for a time in the past, the  `<<'
     key will go blank and not function.  Using the `>>' key will
     enable it again.

     If you try to set an alarm for right now, a  message  dialog
     will appear and tell you the system has rejected the alarm.

BUGS
     If you are not authorized to  use  the  Unix  `at'  command,
     xalarm will dump core if you try to view pending messages.




 Page 2                  Printed 1/24/91

XALARM(1)           RISC/os Reference Manual            XALARM(1)



AUTHOR
     Andrew Peebles (MIPS Computer Systems Inc.)

SEE ALSO
     xalarm(1m), at(1)


















































                         Printed 1/24/91                   Page 3