
   GIVE is a utility which lets the (otherwise unprivileged) user copy files
   into a subdirectory of other people's accounts.  Copying is controlled by
   the destination user, in a file called GIVE.AUTH$USERS.  Files that are
   copied become the property of the destination user, and cannot be
   changed by the sender after being given.  GIVE maintains logfiles in
   recipients' directories, showing who gave what files, and when they
   were given.

   GIVE requires an installed, privileged executable, with the following
   privileges:

        WORLD, OPER - to send a broadcast message to the destination user
        BYPASS - to create destination files & directories
        SYSLCK - to synchronize access across a cluster

   To build GIVE:

        NOTE: only sources are distributed in this package.  If you do
        not have the VAX C compiler, contact the author for the objects
        or executables.

        $ MMS           ! if you have MMS, this will build GIVE.EXE

                - or -

        $ @BUILD-GIVE   ! if you don't have MMS, this will build

   To install GIVE:

        1. Create a directory to store (at least):
                GIVE.EXE, GIVE.CLD, GIVE-STARTUP.COM, and
                SAMPLE-GIVE.AUTH$USERS.  
        2. Edit GIVE-STARTUP.COM to change the definition of
                GIVE_DIR to point to your directory.
        3. Add GIVE-STARTUP.COM to your system startup.
        4. Either add GIVE.CLD to your DCLTABLES (not required, but if not
                done, people need to do a $ SET COMMAND GIVE_DIR:GIVE
                to use GIVE).  To add GIVE.CLD to DCLTABLES:
                $ SET COMMAND/TABLE=SYS$COMMON:[SYSLIB]DCLTABLES -
                             /OUTPUT=SYS$COMMON:[SYSLIB]DCLTABLES GIVE.CLD
                $ INSTALL REPLACE SYS$LIBRARY:DCLTABLES
        5. Add the help file to the system help library, if desired:
                $ LIBRARY/HELP/INSERT SYS$LIBRARY:HELPLIB.HLB GIVE.HLP

   To use GIVE:

        (Recipient): 1. $ GIVE/SETUP to get a template authorization file
                     2. Edit the authorization file to add people who can
                        GIVE files.
        (Sender):    1. GIVE filename username

   Questions or problems with GIVE should be directed to Tom Hopson,
   mgrthh@rosevc.rose-hulman.edu (Internet) or mgrthh@rhit (Bitnet).

