home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 563.lha / Notify_v1.0 / Notify.doc < prev    next >
Encoding:
Text File  |  1991-09-25  |  2.6 KB  |  79 lines
  1.  
  2.                                 Notify
  3.  
  4.                          © 1991 Stefan Sticht
  5.  
  6.                          Freely distributable
  7.  
  8.  
  9. This  small  program's  purpose  is to make AmigaOS 2.0's notification
  10. mechanism  available  to script files.  For example you have a network
  11. environment which only allows to copy files from one Amiga to another.
  12. With  Notify you can write a script, which waits for a special file at
  13. a  special  location.   If  this file arrives at the special place, it
  14. gets executed as a script file.  So you're able to execute commands on
  15. another amiga just by copying a file.  Notify in a network environment
  16. is just an example.  You may imagine different purposes for Notify.
  17.  
  18.  
  19. What is notification?
  20. ---------------------
  21. AmigaOS  2.0  has  a  new  mechanism  called  notification.  With this
  22. mechanism a program can get informed, when a file or the contents of a
  23. directory  changes.   A  program  on the Amiga can ask the OS:  please
  24. send me a message, when the file foo:foobar gets changed.  Then the OS
  25. sends a message when foo:foobar gets created, modified or deleted.
  26.     Notification  is't possible on every file system.  If notification
  27. on  the  specified  file  isn't  possible,  Notify  returns this error
  28. message:   "Error:   packet request type unknown".  The return code is
  29. set   to   10.    Notification   is   possible  with  old  filesystem,
  30. fastfilesystem  and  with  the  filesystem  of  the  ram  disk.  Other
  31. filesystem have to be tested first, if they support notification.
  32.  
  33.  
  34. Usage:
  35. ------
  36.   File/A,Times/K/N,Quiet/S
  37.  
  38.   File  <name>   - a file or directory to get notified about
  39.   Times <number> - after how many notifies should Notify return
  40.   Quiet          - don't output anything
  41.  
  42.  
  43. Examples:
  44. ---------
  45. "Notify t:test"
  46. Notify waits until the file t:test gets created, modified, deleted.
  47.  
  48. "Notify t:test times 5"
  49. Notify waits until the file t:test has been changed five times.
  50.  
  51. "Notify t:test times 5 quiet"
  52. Same as above, but no messages are printed.
  53.  
  54. "Notify ENV: quiet"
  55. Notify waits until a file in the directory env:  gets created or
  56. changed.
  57.  
  58.  
  59. Return codes:
  60. -------------
  61. 20 - Notify couldn't be started
  62.      Problems:  Kickstart 2.0 (V37.xxx) not available
  63.                 error in command line arguments
  64.                 out of memory
  65.  
  66. 10 - Notification isn't possible. See error message.
  67.      You may also examine DOS's errorcode in Result2.
  68.  
  69. 5  - Break detected: Notify got a Ctrl-C signal.
  70.  
  71.  
  72.  
  73. Have fun with it!
  74.  
  75. Stefan Sticht          email:
  76. Biberecker Weg 40a     cbmvax.commodore.com!cbmehq!cbmger!edith!sticht
  77. D-8390 Passau 18       or IWSTICHT@ibm.rz.uni-passau.de
  78. FRG                    Fido: Stefan Sticht (2:242/77:4)
  79.