home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / programs / comms_networking / irclient / !IRClient / Scripts / Docs / Prog / Scheduler < prev   
Encoding:
Text File  |  1997-01-01  |  1.5 KB  |  43 lines
  1. Scheduler
  2. ---------
  3.  
  4. This is a very simple scheduling module which provides very little control.
  5. To add a call back you should use :
  6.   PROCAddCallBack(name$,time,private)
  7. where :
  8.   name$ = the name of the module, or a prefixed name if many callbacks are used
  9.   time = number of cs from now to callback
  10.   private = a private value
  11.  
  12. To add a recurrant callback you should use :
  13.   PROCCallEvery(name$,time,private)
  14. where the values are as above.
  15.  
  16. To remove call backs, or call every's you should use :
  17.   PROCRemoveCallBack(name$,private)
  18. where :
  19.   name$ = the name as passed to AddCallBack
  20.           ALL instances of this name will be removed from the chain
  21.   
  22.  
  23. On being triggered, CallBacks will be overloaded through :
  24.   PROCOverload_CallBack(name$,private)
  25. which you should recognise and pass on otherwise. Uncaught CallBacks will
  26. raise an error in the server window.
  27.  
  28. More technical notes
  29. --------------------
  30. Call backs will occur after the minimum period has passed, but not before.
  31. The exact time cannot be guarenteed.
  32.  
  33. Routines which are called in CallBack MUST be fully re-entrant. It is
  34. theoretically possible that a CallBack may occur at any time, and possibly
  35. even whilst execution of another routine is progressing. It should be taken
  36. as given, however, that callbacks will not occur during 'simple' code, but
  37. only on procedure calls.
  38.  
  39. It will be possible in version 0.27 and later of IRClient to install
  40. callbacks in a more flexible manner, and this will probably not have the
  41. possibility of interupting executing code.
  42.  
  43.