$Id: rexxipc.txt 1.4 1995/06/24 12:47:57 SFB Rel $

$Title: RexxIPC distribution text. $

Copyright (c) Serge Brisson, 1994, 1995.


REXXIPC V1.13
-------------


DESCRIPTION

The RexxIPC library is designed to supply basic
Inter Process Communication capabilities for Rexx
programs.  This is accomplished by supplying a near
one-to-one API to the Named Pipe, Event Semaphore
and Mutex Semaphore OS/2 system services.


DISTRIBUTION

The copyright owner allows the free distribution
of the following files, as long as they are kept
together, unmodified:

    REXXIPC.DLL -- The library.
    REXXIPC.INF -- The documentation.
    REXXIPC.TXT -- This text.

The latest version of these files should be found
on CompuServe in library 6 of forum OS2DF1.


INSTALLATION

The file REXXIPC.DLL should be put in a directory
listed in the LIBPATH statement (CONFIG.SYS).

For easy access, the file REXXIPC.INF may be put in
a directory listed in the BOOKSHELF statement (also
in CONFIG.SYS).

The following Rexx commands should be executed, either
at system startup, or at the beginning of the Rexx files
using RexxIPC:

    call RxFuncAdd 'IPCLoadFuncs', 'REXXIPC', 'IPCLoadFuncs'
    call IPCLoadFuncs

Please note that the third parameter of the call to RxFuncAdd
('IPCLoadFuncs') is case sensitive.


PROBLEMS

Since this library is used in a production
environment, the author is interested in problem
reports.  Although this is not a guarantee,
informations on serious difficulties may lead
to a post of a corrected library.

The author (Serge Brisson) usually logs in once
a week on CompuServe (73547,3112).

Internet: sfb@acm.org


NOTE

The documentation assumes that the user has other sources
of information on the OS/2 Control Program API.


HISTORY

V1.00 February 1994

    Initial release version.

    Released in March for free distribution.


V1.01 March 1994

    The Proc module (ProcSendSignal, ProcSet*Priority) is added.


V1.02 April 1994

    The PipeConnectAsync function is added to close a window
    in the interaction with I/O redirected processes.

    The IPCContext routines are added to support multi-thread
    functions (like PipeConnectAsync).

    The SemMuxWait functions are added.


V1.03 April 1994

    A window in thread context processing is closed.

    The PipePeek function is added.

    Hypertext links are added to the documentation.


V1.04 April 1994

    The functions SemStartTimer and SemStopTimer are added.

    Support for shared unnamed semaphores is added.


V1.05 April 1994

    The function IPCContextWait is added.

    Index entries are added to the documentation.

    PipeDisConnect is renamed to PipeDisconnect.
    SemMuxWait functions are renamed to SemMuxwait.
    SemMuxwaitDelete is renamed to SemMuxwaitRemove.


V1.10 July 1994

    Second release version.

    Released in August for free distribution.


V1.11 October 1994

    Fixed a potential problem by a more systematic use
    of tiled memory for read/write on pipes.


V1.12 May 1995

    The function PipeSetSem is added.

    The function ProcCreateThread is added.
    IPCContextQuery gets an optional thread parameter.
    The function IPCContextResult is added.


V1.13 May 1995

    The documentation is updated.

    Local distribution.


V1.20 June 1995

    Released for free distribution.


---