========================================================
(C)1995 Institute for New Generation Computer Technology
(Read COPYRIGHT for detailed information.)
========================================================

	How to Install a Distributed Pool (PIMOS version)
	-------------------------------------------------

[Using object files already provided]

1. Extract all files from 'dpool_pimos.tar.Z' and put them on an
appropriate directory(*). The target directory will be referred to by
<DPOOL>.

	% mkdir <DPOOL>
	% cd <DPOOL>
	% zcat dpool_pimos.tar.Z | tar xvf -

*) It is assumed that users use 'cfep' utility and a UNIX file system,
and communicate with PIMs using the 'telnet' command. If you can't use
'cfep' utility, you have to transfer all files to FEP machines by
'ftp' command. When you transfer object files like *.sav, you have to
set "representation type" to "image", otherwise; set it to "ascii".

2. Login on PIMOS and start listener. Change the current directory to 
<DPOOL>.

	[1] cd("<DPOOL>").

3. A distributed pool for PIMOS provides not only source files but
also object files. After you select one from among
'obj/{owner-migration, owner-fixed, access-info}/dpool.sav', use the
'load' command(*).

	[1] load("./obj/owner-migration/dpool.sav").

*) All the distributed pool of owner-migration, owner-fixed,
access-info is compiled with the same module name. When you do the
'load' command in the same package (name space provided by PIMOS) more
than once, previous loaded objects will disappear and last loaded
objects will be effective. Avoiding such a case, you do well to load
each object to separate modules.

See PIMOS manual on how to define a new package, change packages for
details. A simple example is given below.

% inherit the package 'pimos'and make a new package 'newpackage'
[1] package:define("newpackage","pimos"). 

% change the current default package to a new package 'newpackage'
[2] dfp("newpackage").


4. Compile programs using a distributed pool and execute it.

[Compiling source files]

3. Select source files among src/{owner-migration, owner-fixed,
access-info} to compile, and change the current directory to there.

For example, we have to do the following instructions to compile a
distributed pool of owner-migration type(*).

	[2] cd("src/owner-migration").
	[3] compile(["cache.kl1","manager.kl1","directory.kl1",
	    "dpool_util.kl1"]).

*) Please be careful of the file 'compile.param' which contains
compiling parameters. A compiled distributed pool is registered to not
the current package but the package designated by variables 'package'
and 'working_packages' in the 'compile.param'. Therefore, you have to
change their values of their variables to default package name.

[OPTION] The distributed pool registered to a package currently can
be stored in a file using the following instructions.

In the case of storing objects of a distributed pool in the file
'new_dpool.sav'.

	[4] unload:program([distributed_pool],"new_dpool.sav").


