RTOOLS
                          ======

RTOOLS is a set of tools to perform remote commands on OS/390
UNIX System Services.

In many cases they can be used as a substitute for the remote UNIX
commands
        o  rcp and 
        o  rsh

which are not available for OS/390. 

For many "every day tasks" the commands from RTOOLS have a more convenient
user interface than the underlying Parallel Environment commands mcp and 
poe. The main idea is to provide the target systems
as command line arguments -- in contrast to poe applications
which require a file with the host names and a count argument.

The following commands are provided:

        o rcopy:  copies files to one or more remote machines
        o rdcopy: recursively copies a directory to remote machines
        o rdo:    executes a command on remote machines
           - in contrast to orexec:
              o  user name and password need not be specified on command 
                 line
              o  the password is prompted for
              o  the command can be executed on more than 1 host
              o  no user change on remote system possible

Prerequisites:

        o Parallel Environment (R4+UW43171, R5+UW44308 or R6 and higher)
        o A command called 'hostname' that returns the TCP/IP hostname of 
          the machine it is running on (a very simplistic version of such 
          a command is provided with RTOOLS).

Installation:

        1. Get the tar-file rtools.tar in the UNIX System Services HFS
           and enter/rlogin-to UNIX System services

        2. Unpack the rtools.tar archive:

           Assume the file rtools.tar is in your home directroy and you 
           want to perform the installation from a new directory called 
           MYINSTALL in your home directroy then do the following:
           
              $ cd
              $ mkdir MYINSTALL           # create installation directory
              $ mv rtools.tar MYINSTALL   # move rtools.tar to inst. directory
              $ cd MYINSTALL              # goto to installation directory
              $ tar xvof rtools.tar

           a directory RTOOLS containg all files for the installation
           will be created within MYINSTALL

           Clearly you can unpack rtools.tar from any directory where 
           you have write access including your home directory.
           In the latter case the commands 2 - 4 must be ommitted.

        3. Follow the instructions in RTOOLS/README