home *** CD-ROM | disk | FTP | other *** search
/ Aminet 18 / aminetcdnumber181997.iso / Aminet / util / rexx / Biomonitor.lha / BioMonitor.dox < prev    next >
Encoding:
Text File  |  1997-02-03  |  6.0 KB  |  151 lines
  1.          BioMonitor.rexx - A background supervisor script for BioWare
  2.  
  3.                               Created 24-10-94
  4.                  (c) 1993 Karl Mottram / BIFROST Industries
  5.  
  6.  
  7.                                - DISCLAIMER -
  8.  
  9. This ARexx Script is Public Domain, and as such may go ANYWHERE you care to
  10. send it, with the following conditions:
  11.  
  12. Any alterations you make to it, please send a copy to the Author. Just to
  13.      let me know what has happened to my Pet-Hobby Software.
  14.  
  15. You may add ANY documentation into the Archive you like, including
  16.      Any "Downloaded From......BBS" Files, ".DisplayMe" files, Credits for
  17.      added work done, Ego-Boosters of any sort, basically I don't care,
  18.      BUT, You DO NOT Have the right to alter in any way the original Dox file.
  19.  
  20. Apart from that, do as you like, post where you want, distribute!
  21.  
  22. If you use it, I'd be pleased to hear from you, and any Donations you wish
  23. to send will encourage me to write more and better stuff. Ideas, Donations,
  24. Death-Threats, Photos of sexy females, Marriage Proposals, HOWDY-Letters
  25. etc can be sent to me at any of the Addresses at the bottom of this file.
  26.  
  27. This archive may be placed in any P.D. Library, including the FishDisks,
  28. but I'd like to know about it please. A copy of the appropriate disk would
  29. be a nice gesture.
  30.  
  31.  
  32.                              - THE BASIC IDEA -
  33.  
  34. This just gets run asynchronously in the background, opens and monitors BIOPORT
  35. for any BioWare sending requests to it, Pops open a window on the workbench and
  36. displays ALERTS to it.
  37.  
  38.  
  39.                             - GETTING STARTED -
  40.  
  41. Unpack this into a system dir, like REXX:  or S:  and add a line into your
  42. startup-sequence as follows:
  43.  
  44.     Run rx <PATH>:/BioMonitor.rexx
  45.  
  46. Now open your fave text editor.  Edit the .rexx file to customise the paths
  47. etc.  and you're away.  Either reboot, or retype the s-s addition into a shell
  48. to kick it over.  Only V2.0+ of any BioWare will access this util, and until
  49. v2.5 TOPS, they will work well enough without it.  After a short while, all
  50. BioWare will not be able to run without this mini-server, but they will be
  51. faster, smaller and cleaner - we have the technology.  :>
  52.  
  53. Into your Startup-Sequence you should also add a section with the following
  54. entries:
  55.     Assign REXX:             s:
  56.     c:loadlib libs:rexxmathlib.library
  57.     c:loadlib libs:rexxsupport.library
  58.     c:loadlib libs:rexxarplib.library
  59.     c:loadlib libs:req.library
  60.     Sys:System/RexxMast >NIL:
  61.     c:waitforport REXX
  62.     c:rxlib rexxmathlib.library 5 -30 0
  63.     c:rxlib rexxsupport.library -5 -30 0
  64.     c:rxlib rexxarplib.library -10 -30 0
  65.     c:rxlib req.library -5 -60 2
  66.  
  67.  
  68.                      - USING BIOMONITOR IN YOUR SCRIPTS -
  69.  
  70. Well, I would prefer that I be the only one to use it, but if you want to send
  71. info to it from your own scripts, I guess that's OK. MODIFYING BioMonitor.* IN
  72. ANY WAY IS PROHIBITED. If you do incorporate it's use into a util-script, I
  73. would appreciate it if you sent me a copy, so I can see if anything else could
  74. be added to the monitor to make the job easier. See BioMonitor.args for
  75. details about function calls and their results.
  76.  
  77.  
  78.                                 - HISTORY -
  79.  
  80. 24-10-94: v1.0 *UNRELEASED*
  81.      Started with a basic framework.  Lots of bugs, and I thought of a few
  82.      problems that might arise, so thought I'd fix them before I released it.
  83.  
  84. 25-10-94: v1.1 *RELEASED*
  85.     Now handles ALERTS - which are just notes posted in the window on WB - and
  86.     NOTIFY requests - which append to the SpyFile for later expansion.  I have
  87.     plans for that file, but don't yet know how to impliment them exactly, but
  88.     all BioWare notes to there at present.
  89.  
  90. 26-10-94: v1.2 *RELEASED*
  91.     Geez, don't ya hate it when you make siully little mistakes that stop
  92.     everything running smoothly?!  Now added the Monitor.log so I can get
  93.     accurate feedback from my beta-testers and check on the operation of the
  94.     Monitor itself.
  95.     To the Testers:  If stuff-ups occur - SEND ME THE MONITOR.LOG FILE PLEASE
  96.  
  97. 22-11-94: v1.3 *RELEASED*
  98.     Just cleaned up the output a bit.  Now, rather than just writing
  99.     DisplayText to the Monitor.log, it prefaces it with 'ALERT  :  '
  100.     Just to clean it up some.
  101.  
  102. 07-01-95: v1.4 *UNRELEASED*
  103.     Just screwing around and figured on possible multiple-invocation problems,
  104.     so added CheckEnv: and the ENV: flag stuff. Damn, have to add a sortof
  105.     "On Exit, del EnvFlag" thing. Hmmm.. It'll stay v1.4 thou.
  106.  
  107. 01-05-95: v1.5 *UNRELEASED*
  108.     Just playing around. Had asome ideas to make it more flexible, and so far
  109.     they seem to be holding together. Added the adaption for my ZapDisk script
  110.     that formats disks in a nicer way and logs reports to BioMonitor.log.
  111.  
  112. 02-06-96: v1.6 *UNRELEASED*
  113.     Got tired of my WB layout, fiddled with it. Realised I'd have to change
  114.     the monitor's output window dimensions, and it hit me that it was a waste
  115.     of time plowing through the sourse to change the bloody win's co-ords, so
  116.     I did a little cut-n-paste from Reminder!.rexx and added the ENVFile
  117.     routines. Now, you need only edit ENV:Monitor.env. Co-Ords are in
  118.     standard CON: order - XPos YPos XSize YSize.
  119.  
  120. 03-02-97: v1.7 *UNRELEASED*
  121.     Added the EXECUTE module, just because I've been meaning to, but never
  122.     really got around to it before. :} Will probably need some work yet, but
  123.     at this point, I don't have any real need for it. Maybe as things
  124.     progress.
  125.  
  126.  
  127.                              - THANX SECTION -
  128.  
  129.      William Hawes -   Who wrote ARexx. A nice, cute, Fairly-Simple
  130.                        Language. Which I could never live without.
  131.                        ARexx (c) 1987 William S. Hawes.
  132.  
  133.     Alex Gian     -   ARexx columnist for Amiga Computing magazine for writing
  134.                        such an easy-to-follow explaination of how to monitor a
  135.                        port. Thanx, even thou you'll never read this.
  136.  
  137.      My Beta-Testers - For Beta-testing of course! <GRIN>
  138.  
  139. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  140.  
  141. UseNET:
  142.      karl@bifrost.manawatu.gen.nz    - Main source of communication.
  143.  
  144. SnailMail:
  145.      BIFROST Industries
  146.      P.O. Box 678
  147.      Palmerston North
  148.      New Zealand
  149.  
  150. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  151.