home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / desktop / alarm91.arj / ALARM.DOC < prev    next >
Text File  |  1991-06-18  |  5KB  |  142 lines
  1.                                   Alarm Clock
  2.                                   -----------
  3.                                     91/6/11
  4.                           Copyright 1991 Julian Byrne
  5.             Electrical and Computer Systems Engineering Department
  6.              Monash University, Clayton, Victoria, 3168, Australia
  7.                      Internet: julian.byrne@monash.edu.au
  8.  
  9. Introduction
  10. ------------
  11.  
  12. These PC programs (ALARM.EXE and CLOCK.COM) allow hundreds of alarms to be set
  13. years in the future. They're designed to conveniently and reliably remind you
  14. about events such as anniversaries, appointments, birthdays, holidays and
  15. knockoff time. They're also designed to be unobtrusive; once installed they
  16. will only be visible when an alarm is triggered or needs to be set - unlike
  17. some other programs they do not need to be manually checked every day.
  18. CLOCK.COM is a small memory resident program. ALARM.EXE is a normal program
  19. which is used to control CLOCK.COM.
  20.  
  21. These programs are freeware. You may copy and use them. You may not sell them.
  22. Usual disclaimers apply.
  23.  
  24. Installation
  25. ------------
  26.  
  27. 1. Put the files ALARM.EXE, CLOCK.COM and ALARM.DAT onto your boot disk.
  28.  
  29. 2. Put these lines at the start of the AUTOEXEC.BAT file on your boot disk:
  30.  
  31.         CLOCK
  32.         ALARM
  33.  
  34.    If these lines are placed after any SET or PATH command then CLOCK will
  35.    occupy more memory than is necessary.
  36.  
  37. 3. [Optional] Place the line "COUNTRY = ?" in your CONFIG.SYS file where "?"
  38.    is your country code, normally your country's international phone dialling
  39.    (ISD) prefix. This defines the format that MSDOS and ALARM will use to
  40.    display dates and times.
  41.  
  42. 4. Reset your computer. The alarm file, normally ALARM.DAT, will be stored
  43.    in the same directory as ALARM.EXE. If an environment variable "ALARM"
  44.    is defined then it is assumed to be the name of the file where the alarms
  45.    will be stored.
  46.  
  47. Setting an alarm
  48. ----------------
  49.  
  50.         alarm set
  51.  
  52. Use arrow keys, digit keys, and Enter key to select:
  53.  
  54. 1. The date and time you want the alarm to go off.
  55.    The day of the week of the alarm is displayed for verification.
  56. 2. The interval you want the alarm to repeat at. eg. daily or weekly (7 days).
  57.    A repeat interval of all zeroes means don't repeat.
  58. 3. The tune you want to play when the alarm goes off.
  59. 4. The message you want displayed when the alarm is silenced.
  60.  
  61. Any alarms that come due while ALARM is running are ignored until it exits.
  62.  
  63. Silencing an alarm
  64. ------------------
  65.  
  66.         alarm
  67.  
  68. When you run ALARM it does these things:
  69.  
  70. 1. Load the alarm file.
  71. 2. Turn off any alarm currently audible.
  72. 3. Act on command given by the user, in this case none.
  73. 4. Display any alarms which have become due, updating repeating alarms,
  74.    and the current date and time.
  75. 6. Place on file any changes, saving the old alarm file in a backup,
  76.    normally ALARM.BAK.
  77. 7. Ready the next alarm to sound.
  78.  
  79. Cancelling a pending alarm
  80. --------------------------
  81.  
  82.         alarm reset
  83.  
  84. Use the up/down arrow, Home/End and digit keys to select the alarm you want
  85. to discard and then press the Enter key. This is not used to clear an alarm
  86. which is already audible, but one which would've sounded in the future.
  87.  
  88. List all pending alarms
  89. -----------------------
  90.  
  91.         alarm list
  92.  
  93. The current date and time is included in the list so you can see how close the
  94. alarms are. This listing can be redirected to file ("ALARM LIST > ALARM.LST")
  95. if needed.
  96.  
  97. Edit alarm tunes
  98. ----------------
  99.  
  100.         alarm edit
  101.  
  102. Use the arrow and digit keys to modify existing tunes, or create a new tune if
  103. you aren't happy with the selection of noises/tunes provided. The tune
  104. currently being editted is played so that you can hear what you've done. All
  105. tunes created are stored in the alarm file. One new tune can be created for
  106. each run. The tunes supplied were done by ear. No guarantees as to their
  107. correctness or musical enjoyment! :^)
  108.  
  109. Technical details
  110. -----------------
  111.  
  112. CLOCK is a 352 byte memory resident program which counts timer interrupts
  113. (There are 18.2/second on the PC) and plays a tune when a count is reached.
  114. ALARM calculates how many timer interrupts there are between the current time
  115. and the next due alarm, and sets CLOCK accordingly, together with the tune
  116. selected by the user. When CLOCK starts playing it's tune the user runs ALARM,
  117. which lists all alarms which have come due since the last time ALARM was run.
  118. ALARM then configures CLOCK for the next one.
  119.  
  120. CLOCK uses the hardware clock tick interrupt vector (08H) rather than the BIOS
  121. provided clock tick vector (1CH) as some programs are badly behaved when
  122. taking over the BIOS vector and stop CLOCK from working correctly.
  123.  
  124. Microsoft Windows Users
  125. -----------------------
  126.  
  127. CLOCK should be invoked before Windows is started. ALARM can be made
  128. convenient to use by creating a separate PIF file and icon for each type of
  129. ALARM invocation (eg. ALARM SET, ALARM RESET etc.). The mouse can then be used
  130. to set and reset alarms. Specifying windowed, not fullscreen, operation means
  131. that the program will better fit into the Windows environment. Make sure that
  132. there is never more than one copy of CLOCK and ALARM running simultaneously.
  133.  
  134. Limits
  135. ------
  136.  
  137. 992 pending alarms.
  138.  99 different alarm tunes.
  139.  52 notes and rests in an alarm tune.
  140.  32 characters in an alarm message and tune name.
  141.  
  142.