       			       Free software BY
		     Project Software & Development, Inc.

     This  software  is  furnished for free and may be used and  copied as
     desired. This software or  any  other copies  thereof may be provided
     or  otherwise  made  available  to any other person.  No title to and
     ownership of  the  software  is  hereby transferred or allowed. 

     The information in this software is subject to change  without notice
     and  should  not  be  construed  as  a commitment by PROJECT SOFTWARE
     AND DEVELOPMENT, INC.

     PROJECT SOFTWARE assumes no responsibility for the use or reliability  
     of this software on any equipment whatsoever.

	Project Software & Development, Inc.
	14 Story St.
	Cambridge, Ma. 02138
	617-661-1444

	Program:	RSXMSG.MAC
	Author:		Robin Miller
	Date:		Fall 1984

     Description:

	This module contains several routines which allow a programmer to
     output  error message text instead of the normal error numbers we've
     all seen too many times.  The routines are based on several routines
     available on the VMS Operating System.  The routines are:

	SIGNAL - Displays an error message to the terminal.  The facility
		 name is always system when using the routine.

	GETMSG - Gets  the error message text.  The error message text is
		 passed  back in a user specified buffer.  This is useful
		 if  you want the error message displayed on a particular
		 place on the screen (my VTL program does this).

	PUTMSG - Puts an error message to the terminal. This is different
		 from  the  SIGNAL  routine  in  that you can specify the
		 facility  name, and other parameters such as whether the
		 severity code and symbol name should be displayed.

     These  routines  use  less than 1KW of memory and are well worth it.
     The  FORTRAN  calling  convention  is  used by the GETMSG and PUTMSG
     routines so they can be used by FORTRAN programs. Hooks are in place
     to  access  an RMS error message file but since I don't use RMS this
     file was never created.

     All my programs on this SIG tape submission use these routines. Each
     program  has  a  module  called xxxERR.MAC which contains an general
     interface to these error routines.

     The  error message file (RSX11M.MSG) must be placed in LB:[1,2].  If
     the  file  doesn't exist, the error numbers will be displayed.  This
     file, which is fixed length records of 64 bytes each, was created by
     a BASIC program (included if I can find it).


     ERRDIS.CMD
     ----------
	This  command file allows easy generation of error log reports on
     either  RSX-11M  or  RSX-11M+.  When executing this command file, it
     asks  a  series  of  questions  about  the  type  of error report to
     generate,  then generates the appropriate command line for the error
     report  generator (RPT).  On RSX-11M+, you can optionally submit the
     error report command file to batch to free up your terminal.

     TECO MACROS
     -----------
	Several  useful  TECO macros are included in this directory.  The
     SEARCH macro allows searching through a series of files, SEE creates
     an   output   file  with  non-printable  characters  displayed,  EDT
     simulates  the  EDT  editor, DRAW allows you to draw boxes and lines
     using  the  arrow  keys  of  the  VT100,  and SQU is the macro which
     squishes  TECO  macros  (.TES)  files  to make them run faster.  The
     SEARCH and SQU macros are normally distributed with the TECO kit.
