home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 18 REXX / 18-REXX.zip / rxasyn20.zip / READ.ME < prev    next >
Text File  |  1994-12-31  |  4KB  |  104 lines
  1.  
  2.                                  RXASYNC
  3.  
  4.                        Version 2.0 - 26th Dec 1994
  5.  
  6.  
  7.               Copyright (c) 1993, 1994 by Crucial Applications
  8.                            All rights reserved.
  9.  
  10.  
  11.     The enclosed REXX DLL comprises a set of functions which are used to to
  12.     extend the REXX language by providing FULL exposure of the ASYNC
  13.     communications API.  In addition a number of higher level functions are
  14.     also provided to simplify the task of enabling REXX to be used as a
  15.     scripting language for serial communications control.
  16.  
  17.     They are by no means perfect but do function sufficiently well for the
  18.     author who uses them to provide a means of automating the collection of
  19.     mail from the BBS.  If you have any comments or suggestions for
  20.     improvement then I'd be glad to hear from you.
  21.  
  22.     Documentation has never been one of my strong points, so in order to
  23.     alleviate some grief on my part and disk space on yours I have elected
  24.     not to include a seperate set of documentation.
  25.  
  26.     The reason for this will become obvious when you examine the source
  27.     code file (RXASYNC.c) which contains all the necessary information on
  28.     every function in the package including syntax and examples.
  29.  
  30.     Further details on the settings and parameter values returned from the
  31.     calls to the ASYNC API are present in the header files which include
  32.     everything the standard OS/2 header file provides on the subject plus
  33.     all the missing (not to mention essential) definitions needed to
  34.     complete the picture.
  35.  
  36.     I do not expect novice users to be delving into this area too quickly,
  37.     if you are new to OS/2 or REXX then I'd like to suggest trying one or
  38.     two of the shareware OS/2 communications packages that provide
  39.     scripting facilities as these may well be of greater value to you.
  40.  
  41.                           --------------------
  42.  
  43.     If anyone is using the RXASYNC package and has been unable to get the
  44.     RxAsync.Cmd script to work with a COM port that has an 8250/16540 UART
  45.     then please alter the 'newFlags3' variable to '00000010'.
  46.  
  47.     This correctly adjusts the setting of buffering options in the
  48.     RxAsyncSetDcbInfo call for the non-buffered UART.
  49.  
  50.     (Many thanks to Andre Boisvert for pointing this out to me.)
  51.  
  52.     BTW. If you are unfamiliar with the DcbInfo options and are unable
  53.     to decipher the information in the (.h) header file, and don't have
  54.     the OS/2 Physical Device Driver reference,  then a good souce of
  55.     information is the SIOREF document supplied by Ray Gwinn with his
  56.     SIO drivers.
  57.  
  58.                           --------------------
  59.  
  60.     The DLL is fully upward compatible with the previous versions and
  61.     should function correctly with all existing scripts (bugs and
  62.     bug fixes not withstanding).
  63.  
  64.                           --------------------
  65.  
  66.     Enclosed is a zip file called RXSCRIPT.zip which contains sample
  67.     files from the BBS scripts that I currently use to access Bunyips
  68.     Cave BBS.  Bunyips run Maximus for OS/2 and my scripts currently
  69.     rely heavily on the content of prompts received and also utilise
  70.     the M2ZMODEM package among other things.
  71.  
  72.     Please _do_not_ expect these scripts to work for you (not without
  73.     some modification<g>), they have been included in order to show
  74.     how RxAsync is currently being used by the author and to hopefully
  75.     give some ideas to those of you using the RxAsync package.
  76.  
  77.     The scripts that should work are RXASYNC.cmd, RXMSG.cmd and
  78.     MDMRESET.cmd (asuming you use the correct modem parameters).
  79.  
  80.                           --------------------
  81.  
  82.     If you find RXASYNC useful then please send me a short message
  83.     telling me what you think and detailing what you are using it
  84.     for. This will help me in determining priorities of future
  85.     enhancements and hopefully give me a few more ideas for additions.
  86.  
  87.                           --------------------
  88.  
  89.     The author can be contacted (in order of preference) at:
  90.  
  91.          Bunyips Cave BBS    3:633/379
  92.  
  93.          Internet            itimms@ariel.ucs.unimelb.edu.au
  94.  
  95.          Compuserve          100236,1404
  96.  
  97.          Snail mail          Ian Timms,
  98.                              13 Cowper Street
  99.                              Footscray, Victoria,
  100.                              Australia, 3011
  101.  
  102.                           --------------------
  103.  
  104.