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.