home *** CD-ROM | disk | FTP | other *** search
/ RISC DISC 1 / RISC_DISC_1.iso / pd_share / utilities / cron / !Cron / !Help next >
Encoding:
Text File  |  1994-02-21  |  4.0 KB  |  89 lines
  1. Cron - Timed execution of commands
  2. ----------------------------------
  3.  
  4. Cron executes commands at specified dates and times. Regularly scheduled
  5. commands can be specified according to instructions found in a 'CronList' file.
  6. You can have several CronList files, although only one can be active at any
  7. time.
  8. When the module is loaded (typically in the boot sequence), Cron will wait for
  9. the desktop to start up. If the desktop is already running, you will need to
  10. say *Desktop to get Cron started.
  11. When started, Cron will be displaying the current time in an icon on the
  12. iconbar.
  13. At some convenient point (usually also in the boot file) you should issue a
  14. *CronList <filename> command.
  15. Cron will then know where the CronList is/should be placed, and the scheduling
  16. system will become active. The file does not need to exist, but it must be a
  17. possible filename on a read/write device.
  18.  
  19. Wimp interface
  20. --------------
  21.  
  22. Choosing 'List…' from the menu (or clicking Adjust on the icon) will display
  23. a list of the scheduled events.
  24. Double clicking on one of these will extract it from the list, and enable you
  25. to edit it. An event will not be triggered while it is being edited.
  26. Clicking 'Set' will put the event back into the list, ready to be triggered.
  27. Clicking 'Delete' will just close the window. The event is hereby removed.
  28. The editing of an event is described below.
  29.  
  30. Choosing 'Set…'from the menu (or clicking Select on the icon) will enable you
  31. to define a new event. Clicking 'Set' will register it, 'Delete' will discard
  32. it.
  33.  
  34. Editing events are done by using the various buttons in the edit/define window.
  35. The time displayed in an icon can be adjusted with the buttons below it.
  36. Select increases and Adjust decreases by the amount shown on the button.
  37.  
  38. The option buttons toggles some aspects on and off. Sometimes the buttons will
  39. fail to react on a click; this is because it would result in an illegal event.
  40.  
  41. The 'Action' can be set to any *command.
  42.  
  43. The 4 dates work like this:
  44.  
  45. 'First shot' defines the first time the event is triggered. Nothing will happen
  46. before this moment.
  47. 'Expires' can be set to a moment, where it is too late for the event to be
  48. useful. Events are only triggered while Cron is running of course, so it is
  49. possible that an event may be run much later that the 'First shot' dictated.
  50. Setting an appropriate expiry time will also avoid several repeating events to
  51. be executed if the computer have been off for a while (or if the clock is set
  52. forward).
  53. 'Repeat' can be set to cause the event to be repeated at the specified time.
  54. The repeat time will then be set forward by the same amount of time. If, for
  55. example, you set repeat a day after the first shot, the event will be triggered
  56. daily. Any pending events will be executed retroactively, so if you have an
  57. event that repeats after an hour, you will get 24 events in a row if you run
  58. Cron after a day of inactivity. This is why 'Expires' can be useful. (You could
  59. set it to expire after 59 minutes, then you would only get 1 event).
  60. 'Delete' can be set to a time where the event should be automatically removed
  61. from the list. It will only work in combination with 'Repeat'. If 'Repeat' is
  62. off, the event will always be deleted immediately after being executed.
  63.  
  64. System variables
  65. ----------------
  66.  
  67. Cron will use these variables if they are set:
  68.  
  69. Cron$TimeFormat        Controls how dates appear in the windows.
  70. Cron$IconTime        Controls how the time is displayed in the iconbar icon.
  71.  
  72. Both of these should be set to a standard timeformat string.
  73. The Cron$IconTime format will also control how often Cron checks the list to
  74. see if any events needs to be executed.
  75.  
  76. That's it
  77. ---------
  78.  
  79. You might want to know what happens if some of the times coincide. They have
  80. different priorities.
  81. 'Delete' has the highest priority, so if you are past the delete time, the
  82. event will be deleted, no matter what.
  83. Second priority is 'Expire'. If the first shot is at the same time at it
  84. expires, it will expire, and the event will not be run.
  85. 'First shot' and 'Repeat' have the same (lowest) priority, they can never
  86. coincide.
  87.  
  88. Thomas Olsson, 21 Feb 1994
  89.