	Test Suite for RPC system
	=========================

This set of files is used for testing both the RPC compiler and the run-time
system. It is the first general test of a new port or a new version of the
compiler. As the number of possibilities to test is a bit large, the files
are named according to the following convention:

						BIG_CLI_FOR.FOR
	1. Test suite name. ---------------------^
	2. Function ---------------------------------^
	3. Target environment/programming language ------^
	4. File type as usual -------------------------------^

1. Test suite name.

	   BIG -	Tests each basic data type
	   NEST -	Tests composite types
	   FRED -	FORTRAN-compatible data types
	   TIME -	Performance test (F. Cane)
	   TWO -	Client uses both TIME and BIG servers to test >1 link

	Note:	The RPC package name of test suite xxx is xxxSUB.

2. Function

	   PROG - Client program (.x, .obj)
	   SUB  - Server subroutines (.x, .obj)
	   CLI  - Client stub (.x, .obj), client image (.exe)
	   SER  - Server stub (.x, .obj), server image (.exe)
	   MAKE - Recompile and link a package for one language (.com)

	   OPEN - Initialise routine to open stub	(obsolete)
	   ATTACH - (same for server)			(obsolete)

3. Target environment/programming language (x)

	   FOR  - FORTRAN
	   PAS  - Pascal
	   C    - C
	   PIL  - PILS
	   TCP  - C, linked and compiled to run over TCP/IP

4. File type as usual

		______________________________________

The following general command files run the code:

	@MAKE_<lang>	<package>

		Generate all files necessary to run, from sources.

	@CLI <package> <client language> <server language> <medium>

		Client runs from terminal task, server started by DECNET
		or spawn (for TCP),
		and runs under same user. Requires command file
		[RPC]<package>_SER_<server langage>.COM
		to exist for running over DECNET (default).

	@SERVER <package> <client language> <server language>

		Server runs from terminal task, client started by DECNET,
		and runs under same user. Requires command file
		[RPC]<package>_CLI_<client langage>.COM
		to exist.

	$ MMS clean_generatable

		Reduces disk space required by deleting anything which
		can be generated (about 5000 blocks).

	$ MMS clean			! removes junk
	$ MMS clean_all			! removes intermediate files

 
