home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / pocketbk / utilsm / notepad / alrmserv2 / ALARMS.TXT next >
Text File  |  1993-01-26  |  11KB  |  217 lines

  1. Notepad Alarm Server v2.0
  2.  
  3. Press Psion<*> to view outline...
  4.  
  5. Some comments in this file are directed to Notepad users. If you use the Alarm Server as a standalone app, just skip over Notepad comments. 
  6.  
  7. About the Server
  8.  
  9. The Notepad Alarm server is a stand alone application that runs separate from Notepad. It doesn't need to be registered anymore to be fully functional, but I would hope that if you like it and use it, you would be willing to register Notepad($29). On Compuserve it can be done by typing Go Swreg at the command prompt. The Alarm Server is a great productivity tool, and is the result of many hours of programming and testing.
  10.  
  11.  Filename: Npalarm.opo
  12.  
  13.  
  14. New in v2.0
  15.  
  16. 1. Settings are now set in the Alarm Server -  Psion<Z>
  17. 2. New key  S = Set sound On/Off
  18. 3. New key  H = About Alarm Server
  19. 4. New key  A = to Agenda app
  20. 5. New key  B = Battery status
  21. 6. New key  Sh<Del> = Cancel todays alms
  22. 7. Space bar - Show current alarm mess.
  23. 8. Timer for setting sound off for a specified period of time.
  24. 9. Tommorrow option in settings
  25. 10. Jump to Time works in any language.
  26.  
  27. Settings (Psion<Z>)
  28.  
  29. The new settings feature will let you set three options in the Alarm Server.
  30.  
  31. 1. Snooze Minutes
  32. 2. Tommorrow time
  33. 3. Auto sort in Edit mode
  34.  
  35. These options were controlled in Notepad before version 2.0. It makes more sense to control these settings from within the Alarm Server. The settings file that is created to hold these settings is called "M:\Note\set\AS_Set.np4". It is a small file so it stays on drive M:
  36. Note that your settings in Notepad for snooze wont work anymore. A new version of Np will be released soon.
  37.  
  38. Snooze Minutes:
  39. Choose the number of minutes you want the snooze button to snooze the current alarm for.
  40.  
  41. Tommorrow time:
  42. Tommorrow time applies to the new Reset button called "Tommorrow". This allows you to reset an alarm to a specified time the following day. This option is only available at the time when the alarm rings.
  43.  
  44. Auto Sort in Edit mode:
  45. Auto sort will tell the Server to sort the alarm.dat file at two times.
  46. 1. When pressing Tab to go into edit mode
  47. 2. When updating an alarm in edit mode
  48.  
  49. Set sound On/Off    ( <S> key )
  50. Setting the sound On or Off will set the sound globally on the Series 3, not just for the Alarm Server. Note that the Alarm Servers On/Off settings may not be the same as yours, so you may need to adjust these from the system screen after using the Alarm Servers On/Off. Alarm Server Off will set all sound off. On will set all sound on, loud buzzer, key click on.
  51.  
  52. This option is really an emergency off switch. ( In a meeting and can't be bothered by alarms coming out of your pocket every few minutes.)
  53.  
  54. On/Off Timer function
  55.  
  56. When setting sound on/off you can select Timer as an option. If you select Timer you can turn the sound off for a specified period of time. The sound will turn back on when the time is up. When set, the alarm icon is displayed in the main screen.
  57. Note also that this timer is an absolute timer and will wake up the machine when the specified time is up so the sound can be turned back on. Of course, it wont be able to if an alarm has subsequently gone off and the S3 is waiting for you to clear this alarm. Use the C key at any time to cancel the timer and turn the sound back on.
  58.  
  59. Battery status   ( <B>  key  )
  60.  
  61. Press the <B> key and get the status of the batteries.
  62.  
  63. To Agenda    (  <A> key  )
  64.  
  65. This will allow you jump to the Agenda application if running.
  66.  
  67. Function of Alarm Server
  68.  
  69. Its function is to queue up all Notepad/ Banker/Personal  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 
  70. "M:\Note\Set\alarm.dat" file.
  71. 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)
  72.  
  73. How does it work?
  74.  
  75. The Alarm Server runs as a separate app, (Npalarm.opo) and runs in the backround, for the most part. As you set alarms , 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.
  76.  
  77.     1. Queue the alarm, if there are none already queued.
  78.     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.
  79.  
  80. ** Note **
  81. All functions in Np that affect alarms send messages to the Alarm Server.
  82. For this reason it is important that the Server is running.
  83.  
  84. What if the Server is not running?
  85.  
  86. 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.
  87. They will ring however as soon as the Server is started. (which may be too late!)
  88.  
  89. How do I start the Server?
  90.  
  91. There are three ways to start it running. To make it easy, when you start Np, the Server will be launched automatically.
  92. 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.)
  93.  
  94. Npalarm.opo
  95.  
  96. The Npalarm.opo must be in one of two directories.
  97.  
  98. 1. Any \Note\Set directory
  99.     or
  100. 2. Any \Opo directory
  101.  
  102. 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.
  103.  
  104.  
  105. How is the Server useful without Notepad?
  106.  
  107. The Alarm Server is not a dumb backround program. It has full editing capabilities built into it.
  108.  
  109. Here's a list of what it can do.
  110.  
  111. 1. Add new alarms
  112. 2. Edit time/date/message of an alarm
  113. 3. Cancel future and current alarms
  114. 4. Show alarms due today
  115. 5. Cancel alarms due today
  116. 6. Exit to system
  117. 7. Hot keys jump to Time,Agenda,System
  118. 8. Temporarily turn off S3 sound
  119.  
  120. Adding new alarms
  121.  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.
  122.  
  123. Editing alarms with the Editor (Tab)
  124. In the Edit mode you will see a scrollable list displaying all alarms in the Alarm.dat file. 
  125.  
  126. Editor key commands
  127.  
  128. Enter = Edit alarm
  129. S = Sort alarm.dat
  130. Help = command list
  131. Delete = Delete an alarm from alarm.dat
  132.  
  133. These functions are self explanatory.
  134. Enter to begin editing.
  135. Sorting will reorder alarms by date,
  136. although not by time.
  137. Delete will delete any alarms except the currently queued alarm. The current alarm can be deleted from the main screen by pressing the Delete key.
  138.  
  139. Cancelling alarms
  140. All alarms can be cancelled. The alarm that is currently queued can be cancelled (deleted) by pressing the Delete key in the main Alarm Server screen. Any other alarm can be cancelled in Edit mode by pressing the delete key while highlighting the alarm you wish to delete.
  141.  
  142. ***  Note  ***
  143. If you want to reset an alarm, don't cancel it. Go to the Edit mode, press Enter and reset the info for the alarm.
  144.  
  145. Notepad Hotkeys
  146.  
  147. There are  two hotkeys in Notepad that link to the Server.
  148.  
  149. 1. <S>  = Start the Server
  150. 2. <J>  = Jump to Alarm Server(and back)
  151.  
  152. 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.
  153. Using the <J> hotkey