========> [VAX87D.COY]AAAREADME.TXT;1 <========


===============================================================================
                 Dale E. Coy - Los Alamos National Laboratory
===============================================================================

<<<<<<<<<<<<<<< This Submission Supersedes ..... >>>>>>>>>>>>>>>>
Sub-Directories .DM$SD, COLORS, and WPE are complete replacements 
for our previous submissions of programs DM, SD, COLORS, and WPE.

This submission contains eight sub-directories:

(1)  DM$SD - Contains both DM and SD. =========================================

DM Version 7.2A - An extensive revision of the John C. Hayre / Rich Gregory
Directory Management package, using SMG$ for windowing, with several new
extensions. 

SD Version 4.3A - A revision of Alan L. Zirkle's Set Default program, entirely
executable (no .COM), with user interface improvements. 

These are both updates of our Spring 87 submission.  Function additions include
recognizing VT-300 terminals, and ability to disable dynamic highlighting. Bug
fixes, of course.  We consider these to be production programs.


(2)  WPE Version 2.4 =========================================================

A "complete" and extended implementation of WPS-PLUS
(TM) for editing ASCII files, including some Language Sensitive features for 
.COM files. Two-window editing, the most useful features of EVE-PLUS, etc.
Built on TPU and EVE, so it's inherently extendable.  Full help and
documentation. A finished version, but added features are promised for the
future. 

DM, SD, and WPE work well together, or separately.


(3)  COLORS Version 4.1 ======================================================

A package for managing and setting "default" colors for VT-241 and VT-340
terminals.  Revision to our Spring 87 submission:  Completely restructured to
provide capability of working with VT-340 terminals. 

(4)  WPELSE Version 1.0 =======================================================

WPELSE is an implementation of WPS-PLUS (TM) for LSE.  Users who know WPS+
have essentially the same keyboard interface.  Also LSE users can readily 
adapt to WPELSE since the LSE peculiar functions are virtually the same.


(5)  SHOWME ===================================================================

Everything you ever wanted to know in one easy program. SHOWME requires no
privileges, obtains it's information from the system running it (should require
no modification), and recognizes all currently-legal terminal types.  It uses
whatever "enhanced" characteristics are available on the users' terminal. 
                                                                Page 2



The following information is presented (for example).

      E8DP2  <> 11/785  <> VMS 4.6
   VAXcluster node.   User COY at VT300 Series terminal TDA6 (VTA155)
   Wednesday, November 25, 1987  4:18 PM  <>  7 users, 4 batch jobs.
   Process Name:  Dale E. Coy
   Directory  MY$DISK:[COY.DECUS.SHOWME]


(6) MCL =======================================================================

This directory contains two programs for producing multi-column listings.

MCL is a multi-column lister written by Gerson Cohen, National Institutes of
Health, transmitted via Pageswapper. MCL produces an output file using the
width of the printer in multi-column listings.  It's very useful for saving
paper, etc., if your files are very "narrow". 

Given this inspiration, 2CL was done by Dale E. Coy, Los Alamos National
Laboratory.  2CL is tailored specifically for LN03 printers, and does only
a 2-column listing.  However, it produces a side-by-side listing of two
pages 83 columns wide (each), making it useful for program listings, etc.


(7)  VAXNOTES ================================================================

This directory has a couple of useful things for systems running VAX NOTES:

An example program to update NOTES, access the unread count, and notify
the user if there are unread notes.  (will have to be modified for your
system).

A NOTES$COMMAND.TPU file which improves the WPS editing interface by defining
additional keys (similar to WPE).


(8)  MAKE_TLB =================================================================

Contains procedures for making a DXC Compressed Text Library of all of the
"text" files in a directory.  This is useful, for example, if you want to
transfer files to another system (especially via modem).  Non-text files
are excluded, but are listed.  An "extract everything" procedure is generated
and placed in the text library.

                                 -----------

FULL documentation is provided for most of the programs, in .TXT, .WPL (for
WPS+), and .LN03 (Very fancy) forms.  Memory cartridges are required to print
the .LN03 files. 


Comments, suggestions, etc. are welcome.  Bug fix requests will also be
considered. 

                                                                Page 3


Submitted by:
        Dale E. Coy
        Los Alamos National Laboratory
        E-8, MS/J957, PO Box 1663
        Los Alamos, NM 87545
        (505) 667-3270 or -7159
         FTS  843-3270 or -7159


Supplemental information for some programs:
===============================================================================

                                    DM$SD

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

                     DM (Directory Manager) Version 7.2A

This is a revision to the DM (directory management) package which has appeared
on previous VAX SIG Symposium tapes.  It provides enhancements to the older DM
packages.  DM displays the files in your current directory (or your directory
tree).  With one or two keystrokes, you can do most major DCL commands:
delete, copy, purge, print, edit, view, rename, etc.

The keystrokes are All-in-1-like.  Your favorite editor may be used from
DM.  The SMG$ interface is used for terminal independence and efficiency.

VMS Version 4.5 (or above) is required.  The FORTRAN compiler is desirable for
customization.  May be user-modified to run with VMS 4.4 or earlier, if
a FORTRAN compiler is available.

Improvements have been made since our Spring 87 submission. 

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

                        SD (Set Default) Version 4.3A

This is a major revision to the SD package which has appeared on previous
VAX SIG Symposium tapes.  It provides enhancements to the older SD packages. 
SD is a synonym for "Set Default", providing (in addition to less typing)
convenient movement between directories, a "stack" of 20 directories, etc.

SD is implemented in FORTRAN for speed, and uses the SMG$ screen interface.

Improvements have been made since our Spring 87 submission. 

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

                            WPE Editor Version 2.4

                            (WPS+ for ASCII Files)

                          Including the MORE utility

WPE is a full (well, almost) implementation of WPS-PLUS (TM) for use on
                                                                Page 4


ASCII files.  Its advantage is that the user who uses WPS+ has essentially
the same keyboard interface to WPE.

WPE is, in its own right, an extremely powerful text editor.  It is layered
on TPU and EVE, and is extendable.  It's easy to "get started", full on-line
help is provided, as well as extensive user documentation.

Features include: 
        All of WPS+ that was reasonable (full-function editing). 
        Two-window editing.
        Multiple files.
        Bookmarks.
        Insert and examine special characters.
        Print files with special characters.
        Fixup files by removing CR/LF
        Automatic tailoring for .COM, .HLP, .FOR, and .TPU files.
        Read-only interface (called MORE).

WPE works efficiently with DM (also in this submission).  Instructions are
provided on how to use WPE as your VMS Mail editor.


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

                       VT-241/VT-340 Color Management Software

                                 Version 4.1

                    PROGRAMS FOR COLOR ON REGIS TERMINALS


PURPOSE OF COLORS PROGRAMS:

Having a VT-241, VT-340, (or other color ReGIS terminal) is much more fun if
you use color combinations other than Red-Blue-Green.  These programs make it
easy for the user to control his/her terminal colors.  A side-effect is that a
user connecting a color terminal is immediately given a set of pleasant colors. 

         CO - Gets any user some set of colors.
        OCO - Used if terminal is garbaged - runs Fix_Crt & restores colors.
        NCO - Gets a new set of random, contrasting colors.
        CCO - Gets a new set of random, complementary ("artsy") colors.
        SCO - Gets a new set of random, similar (soft) colors.
        PCO - Lists 64 choices and lets the user pick.
        XCO - An interactive/visual user chooser.

The acronyms (sort of) stand for: COlors, Old COlors, NEW COlors, Complementary
COlors, Soft COlors, Pick COlors, and (X)change COlors. 

These programs are lots of fun (if you have a VT-241 or VT-340), and the PCO
and XCO programs have a nice user interface implemented in SMG$. 

Completely updated from previous submissions, because DEC introduced the
VT-340 terminal which has a somewhat-different interface from the VT-241.

                                                                Page 5


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

                              WPELSE Version 1.0

                           (WPS+ interface for LSE)

WPELSE is an implementation of WPS-PLUS (TM) for LSE.  Users who know WPS+
have essentially the same keyboard interface.  Also LSE users can readily 
adapt to WPELSE since the LSE peculiar functions are virtually the same.

Features include:
        All of WPS+ that was reasonable
        Two window editing
        multiple files
        bookmarks
        insert and examine special characters
        Print files with special characters and correct tab spacing
        Fixup files by removing CR/LF
        Extra tailoring for .COM, .HLP, .FOR, and .TPU files.


This directory contains source code (.TPU), section files (.TPU$SECTION) and
command files to build a WPS-PLUS interface for LSE.

Mike Boorman
        Los Alamos National Laboratory
        MEE-10, MS/J580
        PO Box 1663
        Los Alamos, NM 87545
        (505) 667-7011
========> [VAX87D.LEVINE]AAAREADME.TXT;1 <========


Submission to the Fall 1987 (Anaheim) VAX Sig tape

                Michael N. LeVine
                Code 3514
                Naval Weapons Center
                China Lake
                Ca 93555

                (619)939-3970
                 avn 437-3970


[.BREAKOUT]     Basic building blocks to construct your own accounting
                utilities. Included are programs to scan an accounting
                file and report on-system up time over the selected
                interval, incoming DECNET access showing local accounts
                accessed, remote node and user doing access, print queue
                utilization showing print queues, pages printed, users and
                accounts doing the printing. For more information see
                document in subdirectory.

[.HELLO]        Command file-requires VT1/2/3xxx terminal. Various
                sayings, etc.

[.INDEX]        Fortran Cross-referencer and Flow Chart generator.
                Powerful static source Fortran source code analyzer.
                See document in subdirectory for more information.

[.JUICER]       On line and Offline disk compression and file defrag
                routines. Disk and file monitoring utilities. See
                document in subdirectory for for information.

[.MUTEX]        Tool to locate the cause of the dreaded MWAIT state.
                Scans all known  mutex's and PHD's. Outputs a list
                of all process's in MWAIT, those with a non-zero
                mutex count and the state of all known mutex's.
                See document in subdirectory for more information.

[.NETLIST]      Fortran program that prints out a condensed version of
                SHOW NET on the screen of a VT1/2/3xx with paging.
                Has brief and full display, sorts output by selected
                parameters-see source. Program contains HELP.
                Install with foreign command NET :==NETLIST
                NET HELP for information.

[.QUICFONT]     Font Editor program for QUIC/QMS printers (Talaris).
                Allows the user to build his own fonts that can be down
                loaded to a Talaris printer. Data files are supplied for
                several fonts-London(old English),Cyrillic,Hebrew.
                Down line loadable font file (.QUIC) for these fonts
                is also provided.For more information see document in 
                subdirectory.

[.SNAPSHOT]     Accounting system crash recovery aid. Runs on a system, taking a
                snapshot every 15 minutes of all processes active on
                                                                Page 2


                the system and (re)writes the information in the file
                SYS$SPECIFIC:[SYSMGR]SNAPSHOT.DAT;1 in the form of
                accounting records for a process deleted-status is
                JBC$_JOBABORT. If a system crash occurs, the command
                file MERGE.COM is used to insert in the proper location
                in the accounting file, selected records  from SNAPSHOT.DAT.
                MERGE.COM contains further information to guide the user
                through the preliminary activities needed to properly
                run MERGE.COM . This allows the system manager to minimize
                the loss of accounting information for billing, utilization
                etc due to system crashes to no more than a 15 minute
                interval. Command file RUN_SNAPSHOT.COM supplied to start
                program as detached job (should not be invoked from
                SYSTARTUP.COM as it would overwrite the last snapshot
                taken before the crash-invoke manually only after
                recovery). A small window of vulnerability exists in
                that the contents of SYS$SPECIFIC:[SYSMGR]SNAPSHOT.DAT
                can be corrupted if a crash occours during the rewrite
                cycle (aprx 1-2 sec every 15 minutes).

[.TAPE]         Fortran program that can read/write blocked card image
                tapes (max card image 132 chars, max block size 10000 chars)
                in ASCII or EBCDIC. Much faster than DCL command files.

[.TQE]          Two versions of a program to print out the contents
                of the timer  queue. The version TQE2 give information
                in a more understandable manner. Resubmission with
                bug fix.

[.VAXPAINT]     Fortran program that reads a MACINTOSH MACPAINT/FULLPAINT
                document uploaded via MACSNVAX (.MAC file), and converts
                it to a bitmap in QUIC/QMS (Talaris) format that the user can 
                plot on a Talaris plotter.
========> [VAX87D.RCAF87]AAAREADME.TXT;2 <========


        RCA Fall 1987 Collection
        This directory tree contains a GREAT variety of software for your
enjoyment and use. Following is thumbnail descriptions of the collection.

[.AMIGA]
        Several editors, spelling checkers, graphics access routines, and
        Postscript access routines, generally with source. Includes
        MicroEmacs 3.9e with sources for Amiga, IBM PC, VAX, and others.
        Also includes the latest HandShake, an excellent Amiga VT100
        emulator. Also includes the Amiga version of AnalytiCalc, with
        complete src. (Note: there are two Amiga collection tapes in the DECUS
        library which have about 120,000 blocks of Amiga software between
        them. Only a VERY small portion of the collection can be included
        here.)
[.ANALYDOC]
        Documents and graphics utility sources for AnalytiCalc V22-03B
[.ANALYOBJ]
        VMS object libraries for AnalytiCalc spreadsheet.
[.ANALYPC]
        IBM PC release of AnalytiCalc, binary and doc only.
[.ANALYSRC]
        Complete sources to AnalytiCalc spreadsheet for VAX or PDP11, plus
        auxiliary keypad files and other necessary adjuncts. You can build
        the spreadsheet from the objects in [.analyobj] but need these
        files to change anything. The RIM5 DBMS is here also as DATMGR.*
        (source only). The [.SIRA] subdirectory contains some submissions
        from Chris Doran of SIRA in England. He provided some bugfixes
        for AnalytiCalc and inspired some new functions which have been
        added to the VAX and the Amiga versions.
[.ANALYTSKPDP]
        This area contains PDP11 (RSX11M) task images of AnalytiCalc for
        RSX and POS.
[.DTC0987]
        VAX Desktop Calendar update. This is a time or meeting scheduler
        and has some short fixes from Charles Garman to correct some bugs
        which crept in.
[.FINGER]
        FINGER is a sort of remote SHOW USERS, SHOW SYSTEM, and activity
        report with many options and the ability to work over a network.
        This version merges changes from Rich Garland, Dan Cottler, Glenn
        Everhart, Bruce Zielinski, Gerry VanTrieste, and Rand Hall, plus
        others.  It fixes a potential security problem with earlier
        versions, adds a short document on customization features, will
        identify LAT terminals by LAT and port, and generally does many
        operations more cleanly on current VMS versions than the older
        Finger programs. Use it on VMS V4.5 or later.
[.LZW]
        Source and completely built Lempel Ziv Welch compress and decompress
        programs. These are used in a few places to compress files on
        the SIG tapes to save room. The LZDCM program is used to 
        decompress the compressed files. Fully linked versions are
        present as well as sources in case of problems with the new
        VMS VAX11 C runtime library. These versions do not use the
        sharable image, so will run even where there may be changes to
        it which will interfere with LZCMP and LZDCM otherwise.
                                                                Page 2


[.NETNEW]
        This area contains about 10,000 blocks of utilities, advice, and
        arcane wisdom taken mostly from the Info-VAX mailing list on
        the Internet. Of special interest will be things like VI for
        TPU, two utility sets which let a single VT100 or VT200 control
        multiple processes, SWING, the BULLETIN utility from MIT (Mark
        London), LEX and YACC inputs for generating Ada parsers, and
        much more. The AAAFILES.TXT file contains further descriptions
        of most files here.
[.SSP]
        The old IBM Scientific Subroutine Package, with comments. Not the
        latest algorithms, but a generally useful package for statistical
        or other mathematical purposes. From the DECUS library, but
        with some messed-up subroutines cleaned up using code which
        was on an early RSX SIG tape. The library is now complete and
        documented by headers in front of each routine.
[.TARRDR]
        TAR format tape readers and writers for VMS. TAR format is the
        dominant tape format for file exchange with Un*x systems.
[.VMSDS]
        Executable image disassembler for VMS. Turns even the weirdest
        VMS executables into recognizable Macro-32. A new version, much
        improved over earlier ones. Complete sources are present also.
========> [VAX87D.RCAF87.ANALYSRC.SIRA]AAAREADME.TXT;1 <========


                  .,----.
                 /       `.
                '         /.-.
                |        //   \
                `       / \   /.---..-----..--------.
                 \      `. `-'/    ||      \\        \
                  `.      `.  |    ||     __\\___     \
                    `.      \ |    ||    |    ___\     \
                      \      `|    ||    |  .'          \
                       `     ||    ||    | /      ^      \
              .^.      ;     ||    ||    |'      / \      \
             /   `.__.'      ;|    ||    ||     /   \      `
            <               / |    ||    ||     \___/      |
             `.           .'  |    ||    | \         _     |
               `-._____,-'    `____'`____'  `.____,-' \____'

                        UK SIG TAPE SUBMISSIONS
                        -----------------------
Submitted by:   Chris Doran                     Date: June 1987
                Sira Ltd., South Hill, Chislehurst, Kent, BR7 5EH, England
                Tel: +44 1 467 2636     Telex: 896649   FAX: +44 1 467 6515

This kit contains assorted utilities which have been written at Sira, extracted
from SIG tapes, or obtained from the DECUS program library (in the last two
cases, with local bug-fixes and enhancements). Some of it will reach the main
DECUS library one day, when I have time (sic!).

This software is provided under the usual all-EXclusive standard terms and
conditions for free software:- If it doesn't function, crashes your system,
erases your life's work, deletes YOUR personal entry in the payroll database,
or otherwise behaves obnoxiously -- TOUGH!!!! i.e. Sira offers no guarantee
that any of it works as documented (or at all), takes no responsibility
whatever for any damage caused by its use or misuse, and does not provide a
free software maintenance service! Having said all that, I WOULD like to hear
about bugs (bug-fixes are better) and suggested or implemented enhancements.
Listings or machine-readable patches as SLP correction files (with checksums,
please) are appreciated. Media will be returned, probably with some updates.

Building Notes:
---------------
RUNOFF sources are suitable for either Digital Standard Runoff, or Bonner Labs
Runoff, but not necessarily both!

(Re-)submissions This Tape
--------------------------
I am resubmitting entire directories, even where only a few files have changed.
This makes it easier to be sure you get everything.

[.BEGIN]        Documentation for new VAX users.
[.CAI]          Menu-driven Computer Aided Instruction course package.
[.COMMAND]      What site doesn't have a set of their own command files?
[.FORMS]        Template machine-writable Readers Comments page and SIR forms.
[.HELP]         Some general HELP text.
[.PFLOAD]       Program to load the shift/Fn keys on a VT220
[.SPELL]        An English English dictionary.
                                                                Page 2


[.SYSMGR]       Startup command procedures from our SYS$MANAGER.
[.WSMITH]       Bits and pieces relating to Whitesmiths'/Real Time Systems'
                C and Pascal compilers, and some miscellaneous C utilities.

Submitted to Previous Tape
--------------------------
There have been no changes to other items which were submitted in October 1986
(I don't know when/if it was released). See AUTUMN86.TXT for details. Get them
from the previous tape, or contact me if you can't.
========> [VAX87D.RCAF87.FINGER]AAAREADME.TXT;2 <========


23-Sept-1987

VMS FINGER, for VMS 4.2 or later.

To build and install FINGER on your system, use:

BUILD_FINGER.COM        compile sources, and build object libraries
INSTALL_FINGER.COM      link and install
START_FINGER.COM        set up initial permanent database

Operation of the above procedures requires SYSPRV, CMKRNL and WORLD
privileges.

File FINGER_CUSTOM.TXT describes areas of the FINGER program that
can/should be customized on a per site basis. Most edits are to
the file FINGER.FOR.

See the file FINGER.DOC for more info on the program.

        This version of Finger has been heavily modified to include
the sort update by Art Greenberg of RCA Labs (sort on personal name
(default), login name, terminal, login time, process, or PID. It also
includes all mods known to Richard Garland plus various mods done in
different parts of RCA and GE. Also added is optional code to locate
server and port IDs of LAT terminals.
        The idea here is that this version of Finger should be the basis
for future enhancements, merging all known existing enhancements. The
current sources reflect one site's display and security needs; the file
for customizing should be examined and Finger should be edited before
installation as needed.

        Code to identify LAT ports, and code to have FINGER filter
FINGER.PLN files to eliminate control characters, is present but
commented out. The sources currently are set to require at least
3 characters for wildcard username matches also. The LAT code now
has been debugged also, and CPU identification has been improved.

========> [VAX87D.SEWELL]AAAREADME.TXT;5 <========


This package consists of programs based on Donald Knuth's WEB System of 
Structured Documentation, which is the programming methodology used to 
develop the TeX document compiler, the METAFONT typeface compiler, and 
all of the support programs for both.

The package is composed of three parts:

       1) MWEB, a variation of the WEB system which has been adapted to
               the Modula-2 language (regular WEB uses Pascal as its 
               programming language)

       2) WEBMERGE, a program to merge multiple change files together (change 
               files are used to make implementation-dependent changes to an 
               implementation-independent base WEB file---the WEB processors 
               allow only one change file per WEB file)

       3) SCANTEX/SCANWEAVE, programs to strip out the parts of a WEB 
               listing which have not been modified by a change file.

       4) the LaTex sources for the slides used in session LT005 (Literate 
               Programming: The WEB System of Structured Documentation) at the
               DECUS Fall 1987 Symposium in Anaheim, with the sample program
               used in the session.


WEB itself is not included in this submission; it is normally bundled with
TeX and can be found elsewhere in the DECUS library.  TeX is required to use 
this package anyway, and WEB will come with it.


This directory structure contains:

[.webm]

        Files pertaining to WEBMERGE.  Print the User's Guide (WEBMUSER.TEX), 
        which is in LaTeX form, for more information.

[.mweb]

        Files pertaining to MWEB, a Modula-2 version of the WEB system.  Print 
        the User's Guide (MWEBUSER.TEX), which is in LaTeX form, for more 
        information.

[.scan]

        Files pertaining to SCANTEX/SCANWEAVE, programs to scan TeX files
        output by WEAVE and remove sections which have not changed.  Print the 
        User's Guide (SCANUSER.TEX), which is in LaTeX form, for more 
        information.
     

[.lt005_87f_talk]

        LaTeX sources and sample program for session LT005 at Anaheim 1987.

                                                                Page 2




All of the documentation for these programs is in LaTeX source form.  If you
don't have a running TeX/WEB system, the programs will be useless anyway.  If
you have TeX running, but not LaTeX, the DVI files are provided and can be 
sent directly to the TeX device driver for your output device.


