                                GIVE README
                                ===========

                                Version 101

             Copyright (c) GreenHouse Software & Consulting 1995



GIVE is a newly designed and developed product by GreenHouse Software
& Consulting. It is intended to enable the system manager to give a
set of files, belonging to a specified number of users, to a new set
of users. This is required when restructuring user IDs on a system,
and a typical task when introducing security!


Loading GIVE to your system

1. Place the floppy into a PC which is connected to your Tandem system.
2. Use IXF/TTE/PCT or any other transfer mechanism to transfer the file
   GIVE.100 in binary mode to your Tandem system.
3. Use IXF/TTE/PCT or any other transfer mechanism to transfer the file
   GIVELIST.101 in normal mode to your Tandem system.
4. After the successful load, get to the TACL prompt and volume over to the
   place where you have GIVE as well as GIVELIST loaded to.
5. Use FUP to change the file code of GIVE from 0 to 100:
   FUP ALTER GIVE,CODE 100
6. GIVE is now ready to use, so

                PLEASE READ THE FOLLOWING INFORMATION!




Command syntax to run GIVE:

   [run] GIVE/[IN<uplist>[,OUT<logfile>]/filenametemplate [old,user new,user]

where

  uplist           = user pair list
                     is an EDIT type file
                     is used when GIVE runs in batch mode
  logfile          = file where GIVE reports all actions to
  filenametemplate = files which have to be given to the new users
                     supports all wild card characters
  old,user         = actual owner ID of files in filenametemplate
                     format is aaa,bbb where aaa and bbb = 0 .. 255
  new,user         = target owner ID of files in filenametemplate
                     format is aaa,bbb where aaa and bbb = 0 .. 255


GIVE runs in two modes:

  1. Command Mode
  2. Batch Mode


1. Command Mode
---------------

This mode enables the user to execute GIVE on a set of files, where
only one old and one new user can be specified.
To give ALL disk files, belonging to 100,5 to the new ID of 182,48,
and to produce a log in the Spooler location $S.#GIVE,
run GIVE with the following command:

  GIVE /OUT $S.#GIVE/ $*.*.* 100,5 182,48


2. Batch Mode
-------------

In batch mode, the disk files of a pre-defined list of users is given
to the new ones. This mode should be used when a larger set of user
IDs has to be changed at once.

To give all files belonging to

  255,255  to  182,48
  100,5    to   30,32
   13,46   to   12,24

where these files reside on the volumes named $GHS*, and to display
all GIVE activities on the home terminal, do the following:

1. Prepare a small EDIT type file, e.g. GIVELIST, and add a line for
   each user pair:
   255,255   182,48
   100,5      30,32
    13,46     12,24

2. Run GIVE with the command;

  GIVE/IN GIVELIST/$GHS*

In case you like to have the results logged in a file named
RESULTS, add an OUT clause in the start-up message:

  GIVE/IN GIVELIST,OUT RESULTS/$GHS*

If RESULT exists, it is opend and the GIVE actions are written to it.
If RESULT does NOT exists, it is created as an EDIT type file.


Log results:

GIVE displays/logs the following information:

      file name                            old ID      new ID  GUARDIAN
                                                                error
-----------------------------------------+-------------+-------+-------------
\SEQUOIA.$GHS1.GIVE.GIVE . . . . . . from  255,255  to  100,005  12
\SEQUOIA.$GHS1.GIVE.README . . . . . from  255,255  to  100,005  0
\SEQUOIA.$GHS1.GIVE.RESULTS. . . . . from  255,255  to  100,005  12
\SEQUOIA.$GHS1.GIVE.RESULTS. . . . . set PROGID failed:  48
\SEQUOIA.$GHS1.GIVE.RESULTS. . . . . set LICENSE failed: 48








 ------------------------------------------------------------------------------
!
!                           Example GIVELIST file
!                           =====================
!
!                                Version 100
!
!
!             Copyright (c) GreenHouse Software & Consulting 1995
!
! File format:
!
! - all lines, beginning with an exclamation mark (!) or a
!   double minus sign (--) are treated as comment lines.
!   These first lines are comment lines.
!
! - ID pair entries have the format:   old,id  new,id
!   old,id  ID is the user ID which has to be changed to  new,id.
!   Both ID's are in the format aaa,bbb, where aaa and bbb are in the
!   range of 0 .. 255.
!   An example would be:   100,5  182,48
!   Only the first two ID's are taken into account. Everything that follows
!   the two ID's is ignored and can be used as comment (see below).
!
!
! Limitation:
!
! The number of users GIVE can process at once is limited to 5,000. But I hope
! that this limit is never reached.
! In case you really have that many users to rename, run GIVE several times.
!
!
! Alles klar?
!
! ----------+---------------+--------------------------------------------------
!   Old     |     New       |                  Comment
! User ID   |   User ID     |
! ----------+---------------+--------------------------------------------------
!                           |
   100,5         30,30      |      sa.carl     -> hallo.hallo
   255,255       13,13      |      super.super -> test.manager
   245,245      182,48      |      hallo.hallo -> ghs.carl
!                           |
! ----------+---------------+--------------------------------------------------
