home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 18 REXX / 18-REXX.zip / rxipc.zip / REXXIPC.TXT < prev    next >
Text File  |  1996-01-14  |  4KB  |  190 lines
  1. $Id: rexxipc.txt 1.6 1996/01/14 11:56:48 SFB Rel $
  2.  
  3. $Title: RexxIPC distribution text. $
  4.  
  5. Copyright (c) Serge Brisson, 1994, 1995.
  6.  
  7.  
  8. REXXIPC V1.30-000
  9. -----------------
  10.  
  11.  
  12. DESCRIPTION
  13.  
  14. The RexxIPC library provides access to OS/2 Inter
  15. Process Communication capabilities for Rexx programs.
  16. Threads, named pipes, semaphores (event, mutex and
  17. muxwait) and queues are supported.
  18.  
  19.  
  20. DISTRIBUTION
  21.  
  22. The copyright owner allows the free distribution
  23. of the following files, as long as they are kept
  24. together, unmodified:
  25.  
  26.     REXXIPC.DLL -- The library.
  27.     REXXIPC.INF -- The documentation.
  28.     REXXIPC.TXT -- This text.
  29.     TESTIPC.CMD -- A test program.
  30.     TESTIPC.CFG -- A test configuration.
  31.     FILE_ID.DIZ -- Identification.
  32.  
  33. The latest version of these files should be found
  34. on CompuServe in library 6 of forum OS2DF1.
  35.  
  36.  
  37. INSTALLATION
  38.  
  39. The file REXXIPC.DLL should be put in a directory
  40. listed in the LIBPATH statement (CONFIG.SYS).
  41.  
  42. For easy access, the file REXXIPC.INF may be put in
  43. a directory listed in the BOOKSHELF statement (also
  44. in CONFIG.SYS).
  45.  
  46. The following Rexx commands should be executed, either
  47. at system startup, or at the beginning of the Rexx files
  48. using RexxIPC:
  49.  
  50.     call RxFuncAdd 'IPCLoadFuncs', 'REXXIPC', 'IPCLoadFuncs'
  51.     call IPCLoadFuncs
  52.  
  53. Please note that the third parameter of the call to
  54. RxFuncAdd ('IPCLoadFuncs') is case sensitive.
  55.  
  56. When executing the TestIPC program, the file TESTIPC.CFG
  57. must be in the same directory as TESTIPC.CMD.
  58.  
  59.  
  60. PROBLEMS
  61.  
  62. Since this library is used in a production environment,
  63. the author is interested in problem reports.
  64.  
  65. Although this is not a guarantee, informations on serious
  66. difficulties may lead to a post of a corrected library.
  67.  
  68. The author (Serge Brisson) usually logs in once
  69. a week on CompuServe (73547,3112).
  70.  
  71. Internet: sfb@acm.org
  72.  
  73.  
  74. NOTE
  75.  
  76. The documentation assumes that the user has other sources
  77. of information on the OS/2 Control Program API.
  78.  
  79.  
  80. HISTORY
  81.  
  82. V1.00 February 1994
  83.  
  84.     Initial release version.
  85.  
  86.     Released in March for free distribution.
  87.  
  88.  
  89. V1.01 March 1994
  90.  
  91.     The Proc module (ProcSendSignal, ProcSet*Priority) is added.
  92.  
  93.  
  94. V1.02 April 1994
  95.  
  96.     The PipeConnectAsync function is added to close a window
  97.     in the interaction with I/O redirected processes.
  98.  
  99.     The IPCContext routines are added to support multi-thread
  100.     functions (like PipeConnectAsync).
  101.  
  102.     The SemMuxWait functions are added.
  103.  
  104.  
  105. V1.03 April 1994
  106.  
  107.     A window in thread context processing is closed.
  108.  
  109.     The PipePeek function is added.
  110.  
  111.     Hypertext links are added to the documentation.
  112.  
  113.  
  114. V1.04 April 1994
  115.  
  116.     The functions SemStartTimer and SemStopTimer are added.
  117.  
  118.     Support for shared unnamed semaphores is added.
  119.  
  120.  
  121. V1.05 April 1994
  122.  
  123.     The function IPCContextWait is added.
  124.  
  125.     Index entries are added to the documentation.
  126.  
  127.     PipeDisConnect is renamed to PipeDisconnect.
  128.     SemMuxWait functions are renamed to SemMuxwait.
  129.     SemMuxwaitDelete is renamed to SemMuxwaitRemove.
  130.  
  131.  
  132. V1.10 July 1994
  133.  
  134.     Second release version.
  135.  
  136.     Released in August for free distribution.
  137.  
  138.  
  139. V1.11 October 1994
  140.  
  141.     Fixed a potential problem by a more systematic use
  142.     of tiled memory for read/write on pipes.
  143.  
  144.  
  145. V1.12 May 1995
  146.  
  147.     The function PipeSetSem is added.
  148.  
  149.     The function ProcCreateThread is added.
  150.     IPCContextQuery gets an optional thread parameter.
  151.     The function IPCContextResult is added.
  152.  
  153.  
  154. V1.13 May 1995
  155.  
  156.     The documentation is updated.
  157.  
  158.     Local distribution.
  159.  
  160.  
  161. V1.20 June 1995
  162.  
  163.     Released for free distribution.
  164.  
  165.  
  166. V1.21 August 1995
  167.  
  168.     The function PipeReadAsync is added.
  169.     The function PipeWriteAsync is added.
  170.     The semaphore open functions can now open unnamed
  171.     semaphores.
  172.     The function ProcGetThreadInfo is added.
  173.  
  174.     The TestIPC program is added.
  175.     Expected return codes are added to the documentation.
  176.  
  177.     Released in September for free distribution.
  178.  
  179.  
  180. V1.30 October 1995
  181.  
  182.     The Queue functions are added.
  183.     The documentation is updated.
  184.     A bug in keyword recognition is found and corrected.
  185.  
  186.     Released in January for free distribution.
  187.  
  188. ---
  189.  
  190.