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