home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 496.lha / BackTalk_v1.30 / Changes_1.30.pp / Changes_1.30
Encoding:
Text File  |  1991-04-07  |  8.1 KB  |  233 lines
  1. Added in 1.30
  2. ---------------
  3.  
  4. Added to the functionality of ONSTRING/OFFSTRING by adding 42 new ARexx
  5. commands.   The documented function and documented messages to "BT_msg" for
  6. ONSTRING and OFFSTRING remain the same.  The new commands are ...
  7.  
  8. ONSTRING1  Usage: ONSTRING1 <string>
  9.    Behaves exactly as ONSTRING (as doc'ed in the manual) except that it
  10.    is a unique command.  When <string> is found in the input stream
  11.    BackTalk sends a message to your ARexx script; ARG0 will be MATCH1.
  12.  
  13. ONSTRING2  Usage: ONSTRING2 <string>
  14.    See ONSTRING1.  ARG0 will be MATCH2.
  15.  
  16. ONSTRING3  Usage: ONSTRING3 <string>
  17.    See ONSTRING1.  ARG0 will be MATCH3.
  18.  
  19. ONSTRING4  Usage: ONSTRING4 <string>
  20.    See ONSTRING1.  ARG0 will be MATCH4.
  21.  
  22. ONSTRING5  Usage: ONSTRING5 <string>
  23.    See ONSTRING1.  ARG0 will be MATCH5.
  24.  
  25. ONSTRING6  Usage: ONSTRING6 <string>
  26.    See ONSTRING1.  ARG0 will be MATCH6.
  27.  
  28. ONSTRING7  Usage: ONSTRING7 <string>
  29.    See ONSTRING1.  ARG0 will be MATCH7.
  30.  
  31. ONSTRING8  Usage: ONSTRING8 <string>
  32.    See ONSTRING1.  ARG0 will be MATCH8.
  33.  
  34. ONSTRING9  Usage: ONSTRING9 <string>
  35.    See ONSTRING1.  ARG0 will be MATCH9.
  36.  
  37. ONSTRING10  Usage: ONSTRING10 <string>
  38.    See ONSTRING1.  ARG0 will be MATCH10.
  39.  
  40. ONSTRING11  Usage: ONSTRING11 <string>
  41.    See ONSTRING1.  ARG0 will be MATCH11.
  42.  
  43. ONSTRING12  Usage: ONSTRING12 <string>
  44.    See ONSTRING1.  ARG0 will be MATCH12.
  45.  
  46. ONSTRING13  Usage: ONSTRING13 <string>
  47.    See ONSTRING1.  ARG0 will be MATCH13.
  48.  
  49. ONSTRING14  Usage: ONSTRING14 <string>
  50.    See ONSTRING1.  ARG0 will be MATCH14.
  51.  
  52. ONSTRING15  Usage: ONSTRING15 <string>
  53.    See ONSTRING1.  ARG0 will be MATCH15.
  54.  
  55. ONSTRING16  Usage: ONSTRING16 <string>
  56.    See ONSTRING1.  ARG0 will be MATCH16.
  57.  
  58. ONSTRING17  Usage: ONSTRING17 <string>
  59.    See ONSTRING1.  ARG0 will be MATCH17.
  60.  
  61. ONSTRING18  Usage: ONSTRING18 <string>
  62.    See ONSTRING1.  ARG0 will be MATCH18.
  63.  
  64. ONSTRING19  Usage: ONSTRING19 <string>
  65.    See ONSTRING1.  ARG0 will be MATCH19.
  66.  
  67.  
  68. OFFSTRING1  Usage:  OFFSTRING1 <no argument> | <string>
  69.    Behaves exactly as OFFSTRING (as doc'ed in the manual) except that it
  70.    is a unique command.  When <string> is found in the input stream
  71.    BackTalk sends a message to your ARexx script; ARG0 will be OFF1.
  72.  
  73.    NOTE:  If you give OFFSTRINGn an argument ...
  74.           The input stream is searched for the argument string.
  75.           When it is found a message is sent to ARexx and the
  76.           corresponding ONSTRINGn (it it exists) is cleared.
  77.           If you change the argument to OFFSTRINGn before a match
  78.           is found in the input stream, all you have done is changed
  79.           the search string and NOT cleared the corresponding
  80.           ONSTRING (if it exists).  This means you may do a
  81.           
  82.           OFFSTRING "test"
  83.           if later in your ARexx script you do a
  84.           OFFSTRING "news"
  85.           BEFORE a match on "test" is made, you will have changed
  86.           the search criteria from "test" to "news".
  87.          
  88.           If you do NOT give OFFSTRINGn an argument ...
  89.           A message is sent to ARexx immediately and the
  90.           corresponding ONSTRINGn (if it exists) is cleared.
  91.  
  92.           What this means is that OFFSTRINGn can be used as a "one shot"
  93.           "signal me when this string is found".  Very much like WAITFOR
  94.           with the exception being that your ARexx script will have to
  95.           be looking for the message from BackTalk signaling the string
  96.           was found.  (WAITFOR does not reply to ARexx until the string
  97.           is found and therefore effectively stops further execution of
  98.           your ARexx script until a match is found).
  99.  
  100. OFFSTRING2  Usage: OFFSTRING2 <string>
  101.    See OFFSTRING1.  ARG0 will be OFF2.
  102.  
  103. OFFSTRING3  Usage: OFFSTRING3 <string>
  104.    See OFFSTRING1.  ARG0 will be OFF3.
  105.  
  106. OFFSTRING4  Usage: OFFSTRING4 <string>
  107.    See OFFSTRING1.  ARG0 will be OFF4.
  108.  
  109. OFFSTRING5  Usage: OFFSTRING5 <string>
  110.    See OFFSTRING1.  ARG0 will be OFF5.
  111.  
  112. OFFSTRING6  Usage: OFFSTRING6 <string>
  113.    See OFFSTRING1.  ARG0 will be OFF6.
  114.  
  115. OFFSTRING7  Usage: OFFSTRING7 <string>
  116.    See OFFSTRING1.  ARG0 will be OFF7.
  117.  
  118. OFFSTRING8  Usage: OFFSTRING8 <string>
  119.    See OFFSTRING1.  ARG0 will be OFF8.
  120.  
  121. OFFSTRING9  Usage: OFFSTRING9 <string>
  122.    See OFFSTRING1.  ARG0 will be OFF9.
  123.  
  124. OFFSTRING10  Usage: OFFSTRING10 <string>
  125.    See OFFSTRING1.  ARG0 will be OFF10.
  126.  
  127. OFFSTRING11  Usage: OFFSTRING11 <string>
  128.    See OFFSTRING1.  ARG0 will be OFF11.
  129.  
  130. OFFSTRING12  Usage: OFFSTRING12 <string>
  131.    See OFFSTRING1.  ARG0 will be OFF12.
  132.  
  133. OFFSTRING13  Usage: OFFSTRING13 <string>
  134.    See OFFSTRING1.  ARG0 will be OFF13.
  135.  
  136. OFFSTRING14  Usage: OFFSTRING14 <string>
  137.    See OFFSTRING1.  ARG0 will be OFF14.
  138.  
  139. OFFSTRING15  Usage: OFFSTRING15 <string>
  140.    See OFFSTRING1.  ARG0 will be OFF15.
  141.  
  142. OFFSTRING16  Usage: OFFSTRING16 <string>
  143.    See OFFSTRING1.  ARG0 will be OFF16.
  144.  
  145. OFFSTRING17  Usage: OFFSTRING17 <string>
  146.    See OFFSTRING1.  ARG0 will be OFF17.
  147.  
  148. OFFSTRING18  Usage: OFFSTRING18 <string>
  149.    See OFFSTRING1.  ARG0 will be OFF18.
  150.  
  151. OFFSTRING19  Usage: OFFSTRING19 <string>
  152.    See OFFSTRING1.  ARG0 will be OFF19.
  153.  
  154.  
  155. OFFSTRINGALL  Usage:  OFFSTRINGALL
  156.    This will clear all outstanding OFFSTRINGn and ONSTRINGn
  157.    calls.
  158.  
  159. GETLINE  Usage: GETLINE
  160.    Returns the line of text from the input stream.  Most useful when
  161.    used with ONSTRING.  Something in the line of text triggered ONSTRING
  162.    and you can get the entire line of text to parse for context or get
  163.    other information from it.
  164.  
  165. RESET  Usage: RESET
  166.    This is recommended to be used immediately before the "exit" command
  167.    in your ARexx scripts.  It will clear all outstanding ONSTRINGn and
  168.    OFFSTRINGn calls, restore screen display if DISPLAYOFF was called, 
  169.    and UNBLOCK user input if BLOCK was called.  The main purpose of this 
  170.    command is to tell BackTalk that the script has terminated and there 
  171.    is no longer any reason to be checking the input stream for matches 
  172.    if you had used ONSTRINGn/OFFSTRINGn.  Of course, RESET can be used 
  173.    at any time in an ARexx script if you wish the above actions to take 
  174.    place.
  175.  
  176. QCD  Usage: QCD
  177.    Queries the state of Carrier Detect.  Returns the string "ON" if
  178.    you are online, "OFF" if you aren't.
  179.  
  180.  
  181.                           !!!!! IMPORTANT !!!!!
  182.  
  183. In all of your ARexx scripts that call ONSTRINGn and/or OFFSTRINGn,
  184. make sure that in your getpkt() loop you've got something similiar to...
  185.  
  186. when arg0 = 'DIE' then do
  187.    closeport("BT_msg")
  188.    /* other clean up stuff here */
  189.    exit
  190. end
  191.  
  192. This is _VERY_ important.  If you have a ARexx script running that is
  193. waiting for events (currently the only implemented BackTalk ARexx calls
  194. that will generate these events are the ONSTRINGn and OFFSTRINGn calls)
  195. and you terminate BackTalk, BackTalk will not be able to fully terminate
  196. until your ARexx script exits the getpkt() loop.  During BackTalk's
  197. termination process, it will check if the port BT_msg is open.  If it
  198. is, BackTalk will send the "DIE" message to BT_msg.  It is up to your
  199. script to properly exit the getpkt() loop and exit.  The termination
  200. of the ARexx script will signal BackTalk to complete its termination
  201. process.
  202.  
  203.  
  204. Changes in 1.30
  205. ---------------
  206. Added a BT.CFG version check.  If you are not running a current version
  207. BT.CFG file you will be presented a requester informing you of this.  The
  208. program defaults will then be used.  When you next "Save Configuration" 
  209. from the Configuration menu the correct file format will be written to
  210. BT.CFG.  This is here strictly for future enhancements.  If the BT.CFG
  211. file format were to change in the future and you did not delete BT.CFG
  212. when running that version of the program, strange things could happen.
  213. With the version check you are informed of the file format change, 
  214. program defaults will be used, and the next time you save the configuration
  215. everything will be updated.
  216.  
  217. Fixes in 1.30
  218. -------------
  219. There was a problem with OFFSTRING.  If you had an OFFSTRING <string> set,
  220. and it was executed, the <string> was not cleared.  So the next time you
  221. did an ONSTRING if the old OFFSTRING argument showed up in the input stream
  222. it would turn off the current ONSTRING.
  223.  
  224. Fixed a potential guru when attempting to open the capture buffer when
  225. it was already opened.
  226.  
  227. Explicitly close BT_msg on termination in case the user didn't do so
  228. in the ARexx script in which BT_msg was opened.
  229.  
  230. Misc in 1.30
  231. ------------
  232.  
  233.