---------------------------------------------------------------------------
Space Telescope Science Institute Tools Group DECUS Atlanta '89 Submissions
---------------------------------------------------------------------------

This saveset contains all source, objects, and executables for a series
of tools developed in the OSB Tool Group at the Space Telescope Science 
Institue in Baltimore Md.  

The source languages include VAX C, FORTRAN, SCAN, MACRo, and MESSAGE.  
If you do not have one of these compilers, yuo can still link with the objects.

There are LaTeX documents for most of the tools also included.  The
LaTeX include files have also been included should you want to try
to LaTeX these.

Some of the tools have logical names associated with them that you will
need to define before running/building the tool.

Tool descriptions follow:

===========================================================================

Tool:		Check Map (CKMAP) Tool

Description:	The CKMAP tool scans a VMS link map for PSECT 
		mismatches and undefined symbols and reports 
		these accordingly.

===========================================================================

Tool:		Disk Report Tool

Description:	The Disk Report tool scans one or more directory log files 
		creating a series of reports summarizing disk space 
		utilization.

===========================================================================

Tool:		Show Merged CMS Classes

Description:	The Show Merged CMS Classes tool compares all of the elements
		in a CMS library class (typically an SPR class) to see if they 
		are also inserted, or ``merged'' into another class (typically 
		a PENDING class) in that same CMS library.


===========================================================================

Tool:		Image Definition Tool (IMGDEF)

Description:	An image definition file contains the information on how 
		to build an executable image.  It is the primary input to 
		IMGDEF, which is used to produce an options file, an MMS 
		file to describe the LINK process, and an MMS file for 
		building the image and its components. 

===========================================================================

Tool:		Remote CMS Server

Description:	The Remote CMS tool provides an interface to CMS libraries 
		on a different DECnet node.  This lets the user issue CMS 
		commands that access a CMS library on a different VAX 
		without having to log onto that node.

===========================================================================

Tool:		DCOPY Tool (Delete/Copy Tool)

Description:	The DCOPY is a modified version of the VMS COPY command that
		deletes a file in the destination directory before it copies 
		into it. Before it copies the file to the destination 
		directory, it checks for the existence of the file, and if it 
		exists already AND the revision date of the existing file is 
		older than the revision date on the file to be copied, DCOPY 
		deletes the file.  This is useful when disk space is tight on 
		the destination device.  Stretched logicals are also supported 
		such that only the first version of a file is copied over a 
		stretched directory list.

===========================================================================

Tool:		MMS Generator For Source (MMSGEN)

Description:	The MMSGEN tool is used to generate a compile MMS for files 
		with the following extensions:  .FOR, .EQF, .EQE, .FBL, .C, 
		.SCN, .MSG, .MAR, .MBL, .X.  It scans one or more input 
		files creating one or more MMS files with the correct 
		dependency list and action lines to build or compile to target
		object file.

===========================================================================

Tool:		Link Check Tool (LNKCHK)

Description:	
		The Link Check tool verifies the existence of all input	
		files on a link command, passing the command onto the Linker 
		if all inputs exist.  Link Check is a workaround for a bug 
		in the Linker that causes it to go into an endless loop when 
		processing many objects with logical searchlists when one of 
		the objects is missing (either from the command line or an 
		options file).

===========================================================================