GMAT -- Graphical Multiprocessing Analysis Tool Please direct inquiries or reports to: GMAT Tool User Systems Division, LCC Dept. Lawrence Livermore National Laboratory P.O. Box 808, L300 Livermore, CA 94550 Active development on this product has stopped, therefore, there is no longer support for bugfixes or enhancements. *************************************************************************** This is a new release of GMAT that includes both an X-window implementation and a Sunview implementation. The conversion from Sunview to X-windows was done by CRI while participating in a collaborative effort with LLNL. They have subsequently granted to LLNL : "a non-exclusive, perpetual, royalty-free, worldwide license to use, copy, modify, translate and distribute this software." They also disclaim any responsibility for the correct performance of the software or any subsequent version distributed by LLNL by including the following notice: * Copyright Cray Research, Inc. Unpublished. All rights reserved. * Cray Research warrants and provides support for this software * only when distributed and used under the terms of a license * agreement with Cray Research. * FOR PRODUCT DISTRIBUTED IN ANY OTHER MANNER, CRAY RESEARCH DISCLAIMS * ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED * WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL * CRAY RESEARCH BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA * OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OF * THIS SOFTWARE. *************************************************************************** DOCUMENTATION: To print out the document run: eqn gmat.ms | tbl | psroff -ms (if you do not have the postscript output drivers then you need to get into the document and edit the .ft CO directives, change them to something that will print out a fixed width font and use the appropriate ditroff driver. The document can also be obtained by writing the above address and requesting UCID-21348. The LLNL document UCID-21348 describes the Sunview version of GMAT. The X-window version of GMAT uses the Athena toolkit; it does not have the same look and feel of the Sunview version. The functionality is essentially the same, however. *************************************************************************** GENERATION and TESTING: The makefiles are as follows: Xmakefile: X11 on sun for CTSS or CRAY logs. Smakefile: Sunview on sun for CTSS or CRAY logs. Nmakefile: X11 on Cray - untested by me for this release. To make the X-window tools do the following: cd state make -f Xmakefile xstategraph cd ../time make -f Xmakefile xtimeline To make the Sunview tools do the following: cd state make -f Smakefile stategraph cd ../time make -f Smakefile timeline Example log files are in the directory examples : They are compressed and encoded. To retrieve them (traceCTSS,traceCRAY) from (trc.CTSS.Z , trc.CRAY.Z) : touch traceCTSS.Z chmod 664 traceCTSS.Z uudecode trc.CTSS.Z uncompress traceCTSS.Z similarly for traceCRAY. The NLTSS logfile is traceCTSS (the included User_Actions file belongs to it). The Cray logfile is traceCRAY. *************************************************************************** (c) Copyright 1987 by the Regents of the University of California. All rights reserved. This work was produced under the sponsorship of the U.S.Department of Energy. The Government retains certain rights therein. Notice This computer code material was prepared as an account of work sponsored by the United States Government. Neither the United States nor the United States Department of Energy, nor any of their employees, nor any of their contractors, subcontractors, or their employees, makes any warranty, express or implied, or assumes any legal liability or responsibility for the accuracy, completeness or usefulness of any information, apparatus, product or process disclosed, or represents that its use would not infringe privately-owned rights. ************************************************************************* DISCLAIMER This document was prepared as an account of work sponsored by an agency of the United States Government. Neither the United States Government nor the University of California nor any of their employees, makes any warranty, express or implied, or assumes any legal liability or responsibility for the accuracy, completeness or usefulness of any information, apparatus, product or process disclosed, or represents that its use would not infringe privately owned rights. Reference herein to any specific commercial products, process, or service by trade name, trademark, manufacturer, or otherwise, does not necessarily constitute or imply its endorsement, recommendation, or favoring by the United States Government or the University of California. The views and opinions of authors expressed herein do not necessarily state or reflect those of the United States Government thereof, and shall not be used for advertising or product endorsement purposes. Work performed under the auspices of the U.S. Department of Energy by Lawrence Livermore National Laboratory under contract number W-7405-Eng-48. *********************************************************************** ACKNOWLEDGEMENTS This tool was initially developed by Susan Campbell, Scott Sikora, Mark Seager and Robert Strout during the summer of 1987, at Lawrence Livermore National Laboratory, working with additional guidance and help from Mary Zosel, Nancy Werner, and Bruce Kelly. Later enhancements were done by Nancy Werner. After CRI converted GMAT to X-windows (Athena widget set), Nancy tested this version, made some minor bug fixes and put it under SCCS code control in 10/90. The tool was inspired by the MAT (Multitasking Analysis Tool) developed at LLNL for the Cray supercomputers. The desire to supply a graphical interface for MAT was heightened by the appearance of the Schedule display tool developed at Argonne National Laboratory by J. Dongarra and D. Sorenson. It was from this tool that we began our development. Though only two routines from that tool remain in this source, we are very grateful to Dongarra and Sorenson for their support by allowing us access to their source code. This helped greatly as an example from which we could learn how to use the SunView windowing system, and in turn greatly accelerated our development effort. The multiprocessing event data that is generated for MAT and GMAT is patterned after a similar tool designed by Cray Research, Inc. and called MTDUMP. The format of the event data, library routines to collect the data on the Livermore Computer Center's (LCC) X-MP multiprocessing machines (NLTSS system), and the MAT tool that produces an ascii display of the data were designed and implemented by Bruce Kelly and Robert Strout. The microtasking mechanism supported at LCC was modified to produce trace information by Nancy Werner. Additionally, Mark Seager has produced a Cray multitasking compatibility library to provide a multitasking capability and to generate the trace data on an Alliant FX/8.