UIC [307,25] CONTAINS:

1.  A RATFOR LIBRARY, RATLIB, FOR USE WITH THE RATFOR PREPROCESSOR WRITTEN
	BY DAVE SYKES AND CONTAINED (HOPEFULLY) IN UIC [373,6]
	OF THIS TAPE.  THIS IS BASICALLY THE SAME LIBRARY
	AS ORIGINAL PRODUCE BY DAVE ARGUE IN UIC [345,5] ON THE CHICAGO (SPR 78)
	TAPE AND UPDATE BY RICHARD MICHAUD IN UIC [321,1] ON THE NEW ORLEANS
	(SPR 79) TAPE.  SOME MINOR BUGS HAVE BEEN FIXED AND CHANGES
	MADE FOR COMPATIBLILITY WITH THE SYKES RATFOR.

    NOTE THE THE VERSION OF RATFOR PRESENTED ON THIS TAPE REPRESENTS THE
	BASELINE VERSION FOR THE SIG WORKING GROUP ON STRUCTURED FORTRAN.

    THE COMMAND FILE "MAKLIB.CMD" BUILDS THE LIBRARY.  DOCUMENTATION
	IS FOUND IN "RATLIB.DOC" AND "RATLIB.RNO".

2. PERFORMANCE MEASUREMENT TOOLS (PROFILERS) FOR F4P

	TIMER -- INDICATES HOW MUCH TIME IS SPENT IN EACH SUBROUTINE.

		THIS IS A MODIFICATION OF THE ROUTINE SUBMITTED
		AS PART OF THE ORIGINAL RATFOR LIBRARY BY DAVE ARGUE.
		THE ONLY CHANGES ARE THAT THE FLOATING POINT INSTRUCTIONS
		HAVE BEEN ELIMINATED AND THE DATA TYPES FOR THE COUNTS
		CHANGED FROM REAL TO DOUBLE INTEGER.



	MEASUR -- PROVIDES THE INFORMATION GIVEN BY TIMER AS WELL AS
		HOW MANY TIMES EACH SUBROUTINE IS CALLED.

	TRACE -- PROVIDES A COMPLETE TRACE OF SUBROUTINES CALLS.

	THE ROUTINES ALL USE THE FORTRAN TRACEBACK CHAIN AND REQUIRE
	ONLY A SINGLE CALL AT THE BEGINNING OF THE MAIN PROGRAM TO
	EXECUTE.

	THE LAST 2 PROGRAM REQUIRE A PATCH TO THE $NAM ROUTINE IN THE F4P OTS.
	SOME OF THE ROUTINES ARE WRITTEN IN RATFOR.  THE GENERATED FORTRAN CODE
	IS PROVIDED.  THE COMMAND FILE "MAKPERFRM.CMD" DOES ALL THE WORK
	NECESSARY TO PLACE THESE ROUTINES IN THE LIBRARY "PERLIB.OLB"
	(INCLUDE CREATING THE PATCH TO $NAM).

	DOCUMENTATION IS FOUND IN "PERFRM.DOC" AND "PERFRM.RNO".

	FOR THOSE WHO WISH TO DO THEIR OWN THING, MOST OF TRACE IS WRITTEN
	IN RATFOR (AND THUS TRANSLATED INTO FORTRAN).  REPLACE THE MODULE
	TRACEP AND YOU CAN DO ANYTHING YOU LIKE.  TRACEP IS CALLED AT
	THE ENTRY OF EACH SUBROUTINE AND HANDED THE SUBROUTINE NAME.

	I HOPE TO PROVIDE A VERSION OF THESE ROUTINES THAT WORK WITH FOR
	ON THE NEXT TAPE.

	I WOULD APPRECIATE HEARING OF ANY PROBLEMS, COMMENTS, OR IMPROVEMENTS
	ANYONE MIGHT HAVE TO THESE ROUTINES.

	STEVE LAZARUS
	FORD AEROSPACE AND COMMUNICATIONS CORPORATION
	MAIL STOP X-90
	3939 FABIAN WAY
	PALO ALTO, CA.  94303
	(415) 494-7400 X6291

