home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / pocketbk / utilsm / notepad / npserv / ALARMS.TXT next >
Text File  |  1993-01-08  |  7KB  |  148 lines

  1. Notepad Alarm Server v1.3
  2.  
  3. About the Server
  4.  
  5. The Notepad Alarm server is a stand alone application that runs separate from Notepad.
  6.  
  7.  Filename: Npalarm.opo
  8.  
  9.  
  10. New in v1.1-1.3
  11.  
  12. Bug fix:
  13.  
  14. 1. Alarm now displays correct time in sys alarm window.
  15. 2. Snoozing after pressing silent wasn't adding the snooze time to the current time, but to time of the original alarm.
  16. 3. Long note was crashing the Alarm Server.
  17.  
  18. New Functions:
  19.  
  20. 1. Note shows in "Snooze Accept Reset" window in case you forget which note/alarm you are clearing.
  21. 2. Up arrow now shows todays alarms.
  22. 3. Help key window changed.
  23. 4. On/Esc now shells to the system, so you don't have to press the system button.
  24. 5. Alarm Server works with Banker.
  25. 6. Alarm Server auto detects time format -
  26.    12-24 hr plus all (mm-dd-yy) formats
  27.    Restart Npalarm to see new time format          after changinh.
  28.  
  29. Function
  30.  
  31. Its function is to queue up all Notepad alarms. Np no longer uses reminders, but now uses system alarms. All alarms will work like the built in Series 3 system alarms.  All alarm info is stored in the 
  32. "M:\Note\Set\alarm.dat" file.
  33. The main difficulty  associated with doing this was that the S3 using Opl/w does not have an easy way to make one's own alarms interact with the alarms used by Agenda and Time.  It was done using extended Opl. (IO commands, Os calls, Ipc)
  34.  
  35. How does it work?
  36.  
  37. The Alarm Server runs as a separate app, (Npalarm.opo) and runs in the backround, for the most part. As you set alarms in Np, messages are sent to the Server that there is new alarm information that needs to be looked at. When the Server receives this message, it does one of two things.
  38.  
  39.     1. Queue the alarm, if there are none already queued.
  40.     2. If the Server already has an alarm queued, it checks to see if there is a newer alarm now than the one that is currently queued, (which would be cancelled), or the current alarm information may have changed. Maybe you had an alarm set to go off at 3:00, but now you want it to ring at 5:00. In Np you would press Psion<Y> to reset alarm. After resetting the alarm Np will send a message to the server that alarm info has changed.
  41.  
  42. ** Note **
  43. All functions in Np that affect alarms send messages to the Alarm Server.
  44. For this reason it is important that the Server is running.
  45.  
  46. What if the Server is not running?
  47.  
  48. If the Server is not running the alarm info will still be saved to file, (M:\Note\Set\alarm.dat), but the alarms will not ring since they are not being queued to the Alarm device driver.
  49. They will ring however as soon as the Server is started. (which may be too late!)
  50.  
  51. How do I start the Server?
  52.  
  53. There are three ways to start it running. To make it easy, when you start Np, the Server will be launched automatically.
  54. The second way is to use the new hotkey in Np which is the <S> key alone. This prompts you to start the Alarm Server, if for some reason it didn't start when Np started, or it was shut down to free up memory, or what have you. The third way is from the system screen under the opl icon. (if you copied the Npalarm.opo to your \opo directory.)
  55.  
  56. The Npalarm.opo must be in one of two directories.
  57.  
  58. 1. Any \Note\Set directory
  59. 2. Any \Opo directory
  60.  
  61. I recommend keeping it in the \Opo directory since you will use it as a separate application at times. This way it will be easy to start running manually, since it will show up under the Opl icon.
  62.  
  63.  
  64. How is the Server useful without Notepad?
  65.  
  66. The Alarm Server is not a dumb backround program. It has full editing capabilities built into it, if you register the software.
  67. Here's a list of what it can do.
  68.  
  69.    1. Add new alarms
  70.    2. Edit time/date/message of an alarm
  71.    3. Cancel future and current alarms
  72. * 4. Show alarms due today
  73. * 5. Exit to system
  74.  
  75. If you are not registered, the alarms will still ring, but you wont get all the editing capabilities within the Alarm Server.
  76.  
  77. Adding new alarms is also a very nice function. Maybe you want to add a quick alarm, but Np is not running. You can go to the Server application, press Enter and add an alarm. It will not show up in Notepad as a note, but you will get your alarm.
  78.  
  79. Hotkeys
  80.  
  81. There are two new hotkeys in Notepad, one of which was already mentioned.
  82.  
  83. 1. <S>  = Start the Server
  84. 2. <J>  = Jump to Alarm Server(and back)
  85.  
  86. The <J> Jump to Server is a very nice convenience that makes it seem like the Server is really part of the Np application, which it is not. This way you don't have to press the system icon to change applications to get to the Server.
  87. Using the <J> hotkey you jump to the Alarm Server and using the same key you can jump back to Np.
  88.  
  89. Refresh
  90.  
  91. Refresh is a new routine in Np that is directly related to the new alarms.
  92. Here's how it works:
  93. Since the Alarm Server runs as a stand alone, you can never be sure that your alarm icons on individual notes are up to date. Therefore Np automatically does a refresh when opening a notepad. The refresh matches the notes that have alarm icons with the alarms in the alarm.dat file to see which alarms are still pending.
  94. If a note that was marked as having an alarm associated with it is no longer current, the alarm icon is taken off.
  95. This can be done manually if you have a notepad open for a while and want to check to see if they are all up to date. Use Psion<G> from within Np.
  96.  
  97. ** Note **
  98.  
  99. The only down side to having two separate applications is that if you edit an alarm while in the Alarm Server, Np will not update its own alarm info, and when you do a refresh, Np will think the alarm is no longer pending since the data has changed.
  100. This is due to that fact that the Alarm Server sends no messages to Np. The messages go one way only.(The same way as the Agenda app) So, edit Np alarms from within Np if you want to keep Np's info up to date.
  101. This shouldn't be a real problem since the Alarm Server never loses its alarm data.
  102. You may choose to control all alarm info from within the Alarm Server. It is set up to be able to operate this way if you find it more convenient.
  103.  
  104. Notepad functions that affect alarms
  105.  
  106. 1. Set alarm
  107. 2. Remove alarm
  108. 3. Show/Reset alarm
  109. 4. Deleting a note with an alarm
  110.     Option to cancel alarm.
  111. 5. Editing a note with an alarm
  112.          The alarm message will update.
  113.  
  114. **********************
  115. Alarm Server key commands
  116.  
  117. Enter = Add an Alarm
  118. Delete = Cancel current alarm
  119. Help = Key command list
  120. Tab = Editor 
  121. On = Info or System if reg'd
  122. O = Off
  123. T = Jump to Time app
  124. *Up arrow - Show alarns due today
  125.  
  126. Editor key commands
  127.  
  128. S = Sort alarm.dat
  129. Help = command list
  130. Delete = Delete an alarm from alarm.dat
  131.  
  132. *****************
  133.  
  134. *** Warning ***
  135.  
  136. Please note that if you exit the Alarm Server while in an open dialog, the Server will not be able to snooze an alarm when it expires. It will also cease to queue any new alarms. The editor will go go back to the main display after about 5 seconds of inactivity.
  137.  
  138. Please report any bugs or unusual happenings to:
  139.  
  140. Mark Esposito
  141. 70713,1407
  142. or
  143. Pelican Software Inc.
  144. P.O Box 741072
  145. Houston Tx. 77274-1072
  146. (713) 773-2803
  147.  
  148.