OVERVIEW
--------

EnvoyARexx emulates ARexx-ports on your local machine. Incoming
ARexx-messages will be forwarded to a remote machine (via Envoy). Only
the remote machine actually runs the respective ARexx-application
(host). The result of each ARexx-command will be returned to your
local machine.

EnvoyARexx is beta, so don't blame me...


DISCLAIMER/COPYRIGHT
--------------------

As usual... All rights belong to me, all risks belong to you.

Copyright © 1995 Alexander Stirmlinger, freeware, provided "as-is",
commercial usage not allowed!



USAGE
-----

EnvoyARexx has to be controlled via ARexx (port: ENVOYAREXX). At the
moment, EnvoyARexx's host understands only 3 commands:

CONNECTHOST <Remote_machine> <Remote_ARexx-port> <Local_ARexx-port>

  (the <Local_ARexx-port> argument is optional)

DISCONNECTHOST <ARexx-port>

QUIT


Here is an example how to connect to Term's ARexx-port on a remote
machine (the remote machine's name is A2000):

1. Start EnvoyARexx on both machines.

2. Start Term on the remote machine (A2000).

3. Type   rx 'address ENVOYAREXX CONNECTHOST A2000 TERM'
   on your local machine.

   (EnvoyARexx will now create a port 'TERM' on the local machine)

4. Type   rx 'address TERM SEND LOCAL "Only Amiga makes it possible\n\r"'
   on your local machine.

   (Term will now output the text; please refer Term's ARexx-manual)

5. Type   rx 'address ENVOYAREXX DISCONNECTHOST TERM'
   on your local machine.

   (EnvoyARexx will now close the 'TERM'-port on the local machine)

6. Type   rx 'address ENVOYAREXX QUIT'
   on both machines to quit EnvoyARexx.


Of course, you can run ARexx-scripts on your local machine. The scripts
will have no clue, that their host is actually running on an other
machine in your network.


COMPATIBILITY
-------------

I've tested EnvoyARexx successfully with the following programs:

Term (4.3a), Spot, ADM, Scout, Ed, OEd, HiTex, NetCall, PhoneCall.

Term 4.2 crashed when I tested it with EnvoyARexx. However, 4.3a works
fine.


BETA-VERSION/FUTURE VERSIONS
----------------------------

As mentioned, EnvoyARexx is beta. I released this version on the Aminet
to find out, if anyone finds this program useful and worth to develop
in the future. So, please let me know...


Alexander Stirmlinger
EMail: alex@picard.unterland.de
Fido:  2:246/1045.11


HISTORY
-------

0.1b  : First public beta-version

0.2b  : CONNECTHOST-command changed. EnvoyARexx is now able to create
        local ports with different names than the remote ports.

        EnvoyARexx does not longer send fixed-size data-packets. Therefore,
        a faster command-execution can be noticed.

        It's now possible to connect to the 'COMMAND' "port" on the remote
        machine. All commands sent to the COMMAND-port will be
        synchronously executed via SystemTagList ().

        Debug-output removed.