Spring 1988 VAX SIG Tapes AAAREADME files, part 1


** NOTICE ** NOTICE ** NOTICE ** NOTICE ** NOTICE ** NOTICE ** NOTICE **

	Due to publicity about Trojan horse programs, computer viruses,
	and similar hazards, there may be increased risk that such code
	may have been submitted for the symposium tapes.
	   Neither your librarian, DECUS, nor DEC has detailed knowledge
	of the programs herein. The risk of using code here is YOURS and
	you should consider yourself WARNED that you should test programs
	yourself to determine what risks they may pose. The cataloging
	process consists of assembling documentation and files into usable
	formats, but does NOT involve testing the programs. 

	   Your librarian makes use of many programs from symposium tapes,
	however, and none of this code contains any known problems. We
	ask that if you notice something suspicious about any DECUS program
	you attempt to help by reporting the problem to the DECUS office
	immediately and by diagnosing it as well as you can. 
	   In using this code, please be aware that privileged code may
	contain operating system version dependencies whose effects should
	be assessed before running it. The system crashes you avoid may be
	your own.
	   The DECUS library may be contacted at 617-480-3418. Please
	ask that Marilyn Rosenberg, Betty Cadieux, and Glenn Everhart
	(your librarian) be informed of the problems. (If possible, leave
	a phone number.)
	   You can reach your librarian (Glenn Everhart) on ARPAnet at
	the network address
		Everhart%Arisia.decnet@GE-CRD.arpa
	if you wish faster contact or have questions.
	   Thank you. Our greatest security against this kind of nonsense
	is watching out for each other.

** NOTICE ** NOTICE ** NOTICE ** NOTICE ** NOTICE ** NOTICE ** NOTICE **

========> [VAX88A1.ABEL]AAAREADME.TXT;1 <========


Abel...

    Abel is an editing interface built on top of Digital's Eve.

    To build Abel, copy the distribution files into a directory, set default to
    that directory, and type :

        $ @BUILD

    Abel will build itself and give you further installation information when
    it's through.

    If you have any tough problems installing or using Abel please contact me.

                                 Jef Kennedy
                              PBR & Associates
                       8500 Station Street, Suite 210
                                Mentor, Ohio

                                216/946-6833

========> [VAX88A1.ANUNEWS]AAAREADME.TXT;1 <========


VMSNEWS      Release 5.2                26-Apr-1988

Author  : Geoff Huston
Address : Computer Services Centre
          Australian National University
          G.P.O. Box 4, Canberra City, A.C.T.  2601
          AUSTRALIA

          (062)492763

    ACSnet,CSNET:       gih900@fac.anu.oz
    INTERNET: gih900%fac.anu.oz@uunet.uu.net
    UUCP: {uunet,ubc-cs,nttlab,mcvax,ukc}!munnari!fac.anu.oz!gih900
    VAX_PSI: PSI%505262440032::gih900

|  NEWS, Copyright (c) Geoff Huston, Australian National University, 1987,1988|

The files in this save set build the complete news system on VMS. This is NOT
set up as a VMS INSTALLable product.

The software is distributed in the source, object and executable formats.
It will require the installation of a number of logical names and site
specific configuration files, and a number of DCL procedures to be defined
at each site.

For a list of files in the distribution, and the installation procedure
please read the installation instructions contained in the file NEWS.DOC.

SECURITY ISSUES

It is intended that NEWS be run as an INSTALLed image with SYSPRV enabled, so
as to control write access to the NEWS database files. (all news text files are
readable without privs). All care has been taken to prevent users being able to
get to DCL level with SYSPRV, or to read or write arbitrary files using SYSPRV.
The way in which this is achieved is that NEWS executes with SYSPRV not enabled
- you will see in the code calls to nosysprv() and sysprv() around code areas
which require SYSPRV to access files. 

If you do not wish all users on your system to read all items in the NEWS
database, then the directories of the relevant newsgroups can be protected via
ACLs (As SYSPRV is NOT used to read text files within NEWS, the ACLS will be
effective in barring read accedd to the item text). 

Control message - the following control messages are implemented:

    cancel
    Is executed automatically.

    newgroup
    Is implemented by mailing DCL COM file to address USENET.
    The news manager is expected to check this operation then execute it to
    bring the local database into line with the wider net.

    rmgroup
    Implemented by posting a "cleanup" command procedure to the USENET account.

                                                                Page 2


    The news manager is expected to edit this procedure then execute it to
    bring the local database into line with the wider net.

    sendsys
    Automatic reply generation implemented.

    senduuname
    Not that relevant - is implemented as a generated negative reply

    version
    Automatic reply generation implemented

    checkgroups
    Implemented by posting a "cleanup" command procedure to the USENET account.
    The news manager is expected to edit this procedure then execute it to
    bring the local database into line with the wider net.

    ihave/sendme
    Automatic sendme reply generated in response to received ihave message.
    ihave control messages may be generated to feed sites.

========> [VAX88A1.ATTC]AAAREADME.TXT;1 <========


AAAREADME.1ST   -  Auto-trol Technology Corporation, DENVER, Colorado

This DECUS Spring 1988 Symposia TAPE submission contains the whole set
of management procedures used in managing an Ethernet VAX Cluster of
25 nodes in software development environment. 

The entire management philosophy may be briefly defined by:

 o CLUSTER must survive failure of several (BOOT) nodes
 o Node STARTUP must be the same regardless of BOOT node in use
 o STANDALONE Node boot must be similar (or same) as into CLUSTER 
 o Products should be separated form VMS, each in it's own directory
   tree, system startup only calls PRODUCT startup procedures

A document describing non-standard (sometimes unsupported) techniques
and CLUSTER management approaches used is enclosed in this top level 
directory.

Subdirectories contents:

 lavc$data:[LAVCCOM] - Procedures used in node startup/shutdown, user
                       login. Copy of systartup.com, syshutdown.com.
                       Cluster common files, such as SYSUAF.DAT have been
                       deleted for DECUS tape.

 lavc$data:[LAVCMGM] - Procedures used in cluster day-to-day management

 lavc$data:[CHICO]   - Database for the cluster "master" node CHICO

 lavc$data:[LISZT]   - Database for the workstation LISZT

 lavc$data:[GRP300]  - Databse for the user group 300


                    D I S C L A I M E R

Author of this contribution does not claim any responsibility for
correctness and/or functionality of enclosed software, which is
provided primarily for reference purpose.  Procedures contained 
in this submissin have NOT been cleaned, they may contain significant 
ammount of installation specifc data.


                        Martin Brunecky
                        Advisory Engineer
                        Auto-trol Technology Corporation
                        12500 N. Washington St.
                        DENVER, Colorado 80233
                        (303) 252 - 2499


========> [VAX88A1.BRYANT]AAAREADME.TXT;1 <========



                            Geoff Bryant
                            Schlumberger CAD/CAM
                            829 Middlesex Turnpike
                            Billerica, MA 01821

        This submission includes three TPU based utilities.   The first, 
        APLTPU, was first submitted on the Dallas VAX SIG tape,  and has
        been enhanced to support VMS version 4.4 and to include many new
        keys.   If you are running VMS version 4.2/4.3, you must use the
        BUILD.COM procedure to generate a VMS version 4.2/4.3 compatable
        version of APLTPU.

        The second utility, GBLSUBS, allows text substitution in multiple
        files with full support for wildcards in file names, and file and
        substitute confirmation.

        The third utility, GBLSEARCH, is used to search files for a given
        text string and to edit any files in which the string is found.

*******************************************************************************

                    APLTPU - Enhanced EDT Emulator for TPU

        This is an updated version of APLTPU for VMS version 4.4/4.7 and 
        has many new keys defined.  APLTPU is an enhanced version of the
        EDT Emulator for TPU which is distributed with VMS.    There are
        many features borrowed from EVE and EVEplus, along with some new
        enhancements.

        To use APLTPU you should define the following symbols:

                $ TPU :== @SYS$LIBRARY:APLTPU
                $ TPUR :== @SYS$LIBRARY:APLTPUR

        and then type

                $ TPU filename

                     or

                $ TPU

        to edit a file.    If you don't specify a filename, the last
        file that you edited will be used.  TPUR will edit a file in
        read only mode.  TPU will also allow wildcards in filenames.

        The source file for APLTPU is APLTPU.TPU and the help files
        are APLTPU.TXT and APLTPU.HLP.    APLTPU can be built using
        BUILD.COM.

        In addition to the keys defined by the EDT Emulator from DEC,
        the following keys are defined by APLTPU:

                   HELP        - Give help on APLTPU keys

                                                                Page 2


                                 and EDT emulator keys

                   CTRL/B      - Toggle one/two windows
                   GOLD CTRL/B - Open a reference file
                   GOLD UP     - Move to top window
                   GOLD DOWN   - Move to bottom window
                   GOLD W      - Adjust window sizes

                   GOLD C      - Center a line of text
                   GOLD U      - Set case upper/lower
                   GOLD J      - Selected substitution
                   GOLD S      - Convert tabs/spaces
                   GOLD E      - Trim spaces/tabs at line end
                   GOLD T      - Convert non-printable chars
                   GOLD O      - Toggle overstrike/insert mode
                   GOLD B      - Toggle box SELECT/CUT/PASTE
                   GOLD X      - Toggle word definition
                   GOLD Y      - Toggle graphics display

                   CTRL/K      - Start learn sequence
                   CTRL/R      - End learn sequence

                   GOLD M      - Save current position
                   GOLD G      - Go to saved position
                   GOLD L      - Go to specified line
                   GOLD Q      - Display current line/column
                   GOLD R      - Display a "ruler"

                   GOLD V      - Display TPU version number
                   GOLD Z      - Display the message buffer

*******************************************************************************

            GBLSUBS - Utility to substitute text in multiple files

        This utility allows you to replace all occurances of a string
        with another string in a list of files.    GBLSUBS is invoked
        as follows:

                $ @TOOLS:GBLSUBS file(s) search_string replace_string

        You will be prompted for any unspecified parameters.  Options
        are specified as switches for a file:

                /Confirm - will ask you to confirm each file
                /Exact   - will do a case sensitive search
                /Query   - will ask you to confirm each substitution

*******************************************************************************

                GBLSEARCH - Utility search and edit/read files

        This utility allows you to SEARCH files for a string and to edit
        files containing the string.    GBLSEARCH is invoked as follows:


                                                                Page 3


                $ @TOOLS:GBLSEARCH file(s) search_string edit/read


        You will be prompted for any unspecified parameters.    Options
        are specified as switches for a file:

                /Confirm - will ask you to confirm each file
                /Exact   - will do a case sensitive search
                /Names   - will display the names of all files searched

        The default is to edit files read only.


========> [VAX88A1.BZL]AAAREADME.TXT;1 <========


     This submission contains various items (other than those
related to Datatrieve, which will be found in the DTR/4GL SIG
Library collection elsewhere on this tape).

[.LSE]          Language Sensitive Editor templates for RUNOFF
                (some improvements over the Fall 1987 version)
                and a PRELIMINARY template for VAX MACRO-32.

[.SPELL]        A personal dictionarie which has most of the
                VAX Macro-32 instructions defined in it so you
                can spell check Macro-32 source code comments
                (or the LSE template).

B. Z. Lederman
WU World Communications
67 Broad St. 28th Floor
New York, NY 10004-2464

========> [VAX88A1.COY]AAAREADME.TXT;16 <========


===============================================================================
                 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 six sub-directories:

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

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

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

These are both updates of our Fall 87 submission.  Function additions include
improved handling of broadcast messages(DM), 20-line command recall (DM),
capability to move to a user's sylogin directory, capability to easily save
default parameters(DM), and improved Tree functions.  Bug fixes, of course.
We consider these to be production programs.


(2)  WPE Version 2.5 =========================================================

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.  Version 2.5 adds a NOTABS
capability. 

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


(3)  COLORS Version 5.1 ======================================================

A package for managing and setting "default" colors for VT-241 and VT-340
terminals.  Revision to our Fall 87 submission:  Version 5.1 adds capability 
to save/restore up to 9 favorite color maps. 

(4)  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. 

The following information is presented (for example).

      E8DP2  <> 11/785  <> VMS 4.6
   VAXcluster node.   User COY at VT300 Series terminal TDA6 (VTA155)

                                                                Page 2


   Wednesday, November 25, 1987  4:18 PM  <>  7 users, 4 batch jobs.
   Process Name:  Dale E. Coy
   Directory  MY$DISK:[COY.DECUS.SHOWME]


(5)  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).


(6)  TOPC  ===================================================================

A display which enhances the information presented by MON PROC/TOPCPU. 
Adjustable thresholds for highlighting, bar-graph display, broadcast message
trapping, spawn capability, etc.

                                 -----------

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.  With this submission, the .LN03 documentation has been
provided in the popular 7 x 9 format.


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

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.3A

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

                                                                Page 3


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.

Significant Improvements have been made since our Fall 87 submission. 

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

                        SD (Set Default) Version 4.4A

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.

Significant Improvements have been made since our Fall 87 submission. 

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

                            WPE Editor Version 2.5

                            (WPS+ for ASCII Files)

                          Including the MORE utility

WPE is a full (well, almost) implementation of WPS-PLUS (TM) for use on
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.


                                                                Page 4



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

                       VT-241/VT-340 Color Management Software

                                 Version 5.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.
                OCO n (where n=1-9) restores a saved color map.
        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.
        ZCO - Saves the current color map (ZCO n saves to map n).

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.

The capability to save up to 9 color maps is new in version 5.1

========> [VAX88A1.CSDHBO]AAAREADME.TXT;2 <========


This submission contains XSHOW, an eXtended SHOW utility for VAXCluster
systems.

XSHOW DEVICE/FILES "device" will list all open files on the specified
device for every selected node in the cluster.

XSHOW HOLDERS "identifier" will list out the holders of the specified
identifier.

XSHOW IDENTIFIERS "identifier" will list out the identifiers held by
the specified user.

XSHOW TERMINAL "lat-terminal" will give the server name, server port,
and session number for the specified lat terminal device.

XSHOW USERS is a combination of SHOW USERS and SHOW SYSTEM; it is very
useful to have when you are trying to find out what node (or nodes) someone
is signed on to.

The package consists of two parts; a scanner which must be run on each
VAXCluster node which acquires revelant data and the display program
which scans through the collected sets of data displaying selected
items.

More detailed instructions can be found at the end of the installation
command file XSHOW_INSTALL.com.

If you have any question I can be reached at:

Jonathan Welch
VAX Systems Programmer
210 Old Farm Rd.
Amherst, MA. 01002
(413) 549-7100

Bitnet: JHWELCH@amherst.

========> [VAX88A1.DINKIN]AAAREADME.TXT;1 <========


NAME.COM - a command procedure to determine what terminal server
and port a particular terminal is connected to.

Version: 2.1
Date   : April 19, 1988
Programmers: 
        Daniel A. Dinkin (Dan)          P. Joseph Callahan (Joe)
        Network Services Manager        Operations Manager
        (301)321-3320                   (301)321-4085
        E7OPDAN@TOWSONVX.BITNET         E7OPJOE@TOWSONVX.BITNET

                        Academic Computing Service
                        Towson State University
                        Towson, Maryland 21204

THIS COMMAND PROCEDURE IS *NOT* COPYRIGHTED AND MAY BE USED AND/OR MODIFIED
BY ANYONE AT ANYTIME.

INPUT: P1 = Terminal name (i.e. - LTA123)

OUTPUT: Terminal name
        Ethernet address
        DECnet address
        Port name

REVISION HISTORY:

        1.0 - Written to determine server and port using hard-coded
April 7, 1988  information.  Rejected non-terminal server devices,
               incorrectly supplied device names (i.e. - LTALTA123).
               and terminal server devices which were connected to
               printers.

        2.0 - Took out hard-coding of server names.  Now accesses
April 7, 1988  DSVCONFIG.DAT for the information.  This saves headaches
               when broken servers are swapped out for new ones.

        2.1 - It seems that LTA#'s above 1000 need to be handled
April 19, 1988 differently than LTA#'s below 1000.  A couple of 
               lines of code needed to be added to check for this
               condition and deal with it.

The output of the procedure is mentioned above.  Please note, however,
that the output is very modifiable based upon your need for the procedure.
In fact, I expect that for each different need, you will have to 
redesign the output.  This can be done in two ways.  Either determine
a parameter which will refer to the proper output or make a new
copy of the procedure for every different need.  The choice is up to
you.

There are dozens of possible uses for the command procedure NAME.COM.
The ones that we have come up with so far are:

1) Several terminals in our lab are designated as faculty only.  The
command procedure is executed at login and if the account is not a 

                                                                Page 2


faculty account and the terminal is determined to be a faculty only
terminal, the user is logged out.

2) Our student monitors use a special menu driven account from which they
can log users out, monitor and manipulate batch and print queues, etc.
This account is setup so that it can only login at one terminal which is
directly connected to one node of our cluster and the terminal is setup
so that only operators can login to it.  If we put the terminal onto a
server instead of a DZ-11, the terminal name would change everytime the
student monitor logged in.  With NAME.COM, we don't have to worry about
that since the server and port number don't change.

3) Sometime in the future, we will be setting up a word processing lab
in which there will be several terminals connected to servers where
faculty and students will be able to login and use word processing
on the cluster.  To avoid an overload, we want to limit the word
processing to this set of terminals and no others.  Therefore, when a
user types in the command to start the word processing package, a check
will be made, and the user will be granted access only if they connected
to one of these special servers.

========> [VAX88A1.DMILLER.APCE]AAAREADME.TXT;1 <========


TPU-Plus - TPU enhancements from the Arkansas Department of Pollution
Control and Ecology.  Full documentation is in TPUPLUS.RNO and may be
generated with TPUPLUS_RNO.COM.

Rick Stacks
Arkansas Department of Pollution Control and Ecology
8001 National Drive
Little Rock, AR
(501) 562-7444

========> [VAX88A1.DMILLER.UALR]AAAREADME.TXT;1 <========


********     ********         *****          ******            ***********
 *    *       *    *         *     *          *  *              *         *
  *  *         *  *          *  *  *          *  *              *  ****    *
  *  *         *  *         *  * *  *         *  *              *  *   *   *
  *  *         *  *         *  * *  *         *  *              *  ****    *
  *  *         *  *        *  *   *  *        *  *              *         *
  *  *         *  *        *  *   *  *        *  *              *  *    **
  *  *         *  *       *   *****   *       *  *              *  * *  *
  *  *         *  *       *           *       *  *              *  *  *  *
  *   *       *   *      *   *******   *      *  *          *   *  *   *  *
  *    *******    *      *  *       *  *      *  ************   *  *    *  *
   *             *      *  *         *  *     *             *   *  *     *  *
    ************       ******       ******   ****************  ******     ****


   Submissions by:      University of Arkansas at Little Rock
                        Data Center
                        2801 S. University
                        Little Rock, AR  72204-1099



To further your computing experiences, the following directories are
enclosed for your inspection and use:


[.ALOCWAIT]  -  ALLOCATE/WAIT - The qualifier that VMS left out!  Useful
                for anyone who has to wait on a peripheral to become
                free (particularly in a batch job).

[.BBS]       -  A full-function bulletin board system for the VAX.  It has
                messaging, conferencing, uploads, downloads, etc.
                This is a complete re-release of the version submitted on the
                earlier DECUS tapes.

[.CB]        -  A CB simulator for the VAX.  So good you'll think it's the
                real thing! (No change form the previous submission, provided
                to complement the BBS)

[.ETAPE]     -  The latest version of an old favorite.  This ETAPE has a few
                fixes in since the last one on DECUS.  Converts to/from
                EBCDIC, non-standard ASCII and Honeywell GCOS BCD tapes.
                This submission is a major revision of ETAPE and now is
                screen-oriented with several new features.

[.MISC]      -  Useful miscellaneous programs which may be used as is, or
                as a basis for utilities of your own.

Permission is given to all DECUS members to copy, distribute, and use all files
contained in this submission.  Not to be sold!

========> [VAX88A1.DOLGEN]AAAREADME.TXT;3 <========


Submissions by: William L. Baker

                Dollar General Corp.
                427 Beech St.
                Scottsville, Ky. 42164
                (502) 237-5444 x 214

Directory [*.DOLGEN.DISKREO] contains a command procedure to reorganize a disk
and maintain master indexed files that are created with exact positioning. This
is a replacement to the '87 Fall tape with some modifications and new 
procedures.

        CONVERT*.COM    This procedure is used to do converts on exact placed 
                        master files during normal production. The file is 
                        copied to another disk, deleted and recreated with a 
                        CONVERT/FDL in its orginal position.

                        This is a new procedure.

        DISK_REO.COM    This procedure will create a copy of the input disk. The
                        copy will be divided into three zones to minimize head
                        contention:

                        Zone 1: Places INDEXF.SYS, all directories, [SYSTEM], 
                                and user files in the middle logical blocks. The
                                user files are selected and ordered according to
                                a parameter file. Places one half of the free
                                space on each side of zone 1.

                        Zone 2: Places short life files around the zone 1.
                                Program ZONE.BAS determines which files are 
                                included in zone 2 and zone 3. Zone 2 will have
                                .LIS files for example. The files are copied in 
                                sorted order by file extension and size.

                        Zone 3: Places long life, low access files around the 
                                zone 2.

                        Update to this procedure is:

                                - The output disk is checked for write protect
                                  before mounting.

                                - SET NOON/ON was added in a couple of places
                                  to insure that the abort routine will work
                                  correctly.

                                - Account [SYSTEM] will receive a start and end
                                  message when DISK_REO.COM is run.

        DISK_REO_DATA_CHECK.COM A procedure to assist with the maintenance of 
                                the zone 1 user file placement parameter files.

        FILES_RP.COM            Creates a brief DUMP/HEADER like map of file
                                retrieval pointers. This is a modification of 

                                                                Page 2


                                Michael N. LeVine's FILE.MAR JUICER program. 

                                This is a new set of files and performs the
                                same function as HEAD_ANAL2.COM except faster. 
                                Since Michael's program does not read the dir-
                                rectory structure, it may process a header
                                that is not valid. However, it is accurate
                                enough to get a picture of where files are 
                                relocated after a DISK_REO.

        HEAD_ANAL2.COM          A procedure to list a file(s) retrieval pointer
                                logical block numbers and allocated size. 

                                Update to this procedure was to:

                                - SET NOON/ON during the DUMP/HEADER.

                                - HEAD_ANAL.BAS was modified to open the dump
                                  header log file without the requirement for
                                  the CONVERT.

        LOGIN.COM               A captive command file to run the disk 
                                reorganization.

                                The update to this file includes functions
                                to stop and restart the que manager. See 
                                DISK_REO_OPER.DOC.

        MASTER_DISK_REO.COM     This is an example of how to reorganize a pure 
                                master file disk. It includes placement of the 
                                swap and page files around the index and copies
                                the master files with CONVERT/FDL.

========> [VAX88A1.DUMPER]AAAREADME.TXT;7 <========



This directory contains the sources and EXE for DUMPER-32.   DUMPER-32 is
a utility written by Robert McQueen and Nick Bush at Stevens Institute of
Technology, for reading TOPS-10 BACKUP and TOPS-20 DUMPER tapes under VMS.
BACKUP and DUMPER "interchange" mode tapes are also can be read.  Note that
DUMPER-32 only reads tapes, it cannot be used to write tapes.

This is a version derived from version 1.0-003 on the Integration Tools
tape (from the directory [TOOLS.DUMPER013]).  This version contains 29
edits added by James Harvey at Indiana University - Purdue University at
Indianapolis, mostly to make DUMPER-32 read labeled version 5 and 6 TOPS-20
DUMPER tapes.  This version has been tested using DUMPER format version 6
tapes written by DUMPER version 6(542) under TOPS-20 version 6.1 at
IUPUI.  The program was also tested with an unlabeled BACKUP format tape
written under TOPS-10 version 6.03.  All tests were run on a VAX 8800 system
under VMS version 4.6.


Problems fixed:

o       Version 5 and 6 TOPS-20 DUMPER tapes are now supported.  What
        this means is that DUMPER-32 can now handle: (1) unlabeled TOPS-20
        DUMPER tapes with  (version 4-5) or without (version 3-) file marks
        between the savesets, (2) labeled TOPS-20 DUMPER tapes with file
        labels around each saveset (version 4-5-6), (3) TOPS-20 DUMPER
        tape volume switches at logical EOT (version 4-5) or when a TONEXT
        record is seen (version 6).

o       DUMPER-32 now allows reading to begin on a TOPS-20 DUMPER tape at
        a continued-saveset record.  This means you no longer have to
        read through all the reels of a four-volume set, for example, if
        you know the file you want is on the last volume.

o       Files split across tape volumes are now properly restored.

o       Many fixes to cure DUMPER-32's habit of blowing off with a status
        of FALSE ("message number 000000") and no other message.

o       Trying to restore binary files (e.g., .EXEs) no longer causes
        DUMPER-32 to die with an RMS record length error.  A warning
        message is issued and the restore continues.

o       The /SSNAME and /SKIP qualifiers now work.  Skipping backwards
        on labeled TOPS-20 DUMPER tapes is still not supported however.

o       The /LOG=DIRECTORIES qualifier now works.


New enhancements:

o       Digital had Stevens modify the program in version 1.0-003 to always
        restore 36-bit files as text files.  This is usually the desired
        action, but the modification left no way to restore 36-bit files
        as binary files.  A /BINARY qualifier has been added to allow you
        to force the restoration of 36-bit files as binary files rather

                                                                Page 2


        than text files.  /NOBINARY is the default, which causes 36-bit
        files to be restored as text files.

o       A /REMOVE_LSNS qualifier causes EDIT/SOS-style line numbers
        to be removed when restoring text files.  /REMOVE_LSNS is the
        default.  The previous behaviour, which caused the line number
        to show up in the file as plain text, may be preserved by using
        /NOREMOVE_LSNS.

o       An on-line HELP file has been written for the BAKDMP command
        (command that runs DUMPER-32).


The COM files included are:

BUILD.COM
        Builds production (DUMPER.EXE) and debugging (DUMPER_DEBUG.EXE)
        EXE files.  You will have to edit this to use at your site; I
        was using it under batch and it has a SET DEFAULT command in it.
        Also *WARNING* it deletes all the EXE, OBJ, and MAP files
        before rebuilding DUMPER.

DLINK.COM
        Links DUMPER with /DEBUG/TRACE.

DMOUNT.COM
        Canned procedure to mount a TOPS-20 labeled tape for use with
        DUMPER-32.  Mounts the tape with /OVERRIDE=(ACC,OWN) on an
        MU device (you might have to change this) and gives it the
        logical name DUMPER.

DRESTORE.COM
        Canned procedure to restore a single DUMPER saveset to the current
        default directory.

DUMPER.COM
        Compiles and links DUMPER.EXE.  Used by BUILD.COM.

DUMPER_DEBUG.COM
        Compiles and links DUMPER_DEBUG.EXE.  Used by BUILD.COM.

INSTALL.COM
        Used to re-install DUMPER.EXE after a fix.

KITINSTAL.COM
        Original installation COM file from Stevens Institute.


The DUMPER-32 source files are described quite well in the program logic
manual written at Stevens, DUMPER_FUNC_SPEC.MEM.  The source files are:

DUMPER.BLI
        Main routine.  Contains the calls to the command processing, and
        some general subroutines.


                                                                Page 3


DUMPER.CLD
        Command line definition file.  This is the file that is used with
        the DCL command SET COMMAND to define the command to invoke the
        utility (note: this one has the definitions for the /BINARY and
        /REMOVE_LSNS qualifiers added).

DUMPER_DRIVER.BLI
        Main restore and list driver routines.

DUMPER_CVT.BLI
        Main data type conversion routines.  Converts 36 bit text, numbers,
        bytes, etc into text descriptors, characters and valid 32 bit data.

DUMPER_LIST.BLI
        Main listing routines.

DUMPER_TAPE_IO.BLI
        Tape I/O processing routines.  These are the routines that will
        read the data from the tape.

DUMPER_FILE.BLI
        File output routines.  These routines provide for setting of the
        various file attributes, creating the file and writing the data
        into the file.

DUMPER_BACKUP_TAPE.BLI
        This module provides the basic support for reading a BACKUP-10
        written tape.

DUMPER_DUMPER_TAPE.BLI
        This module provides the basic support for reading a DUMPER-20
        written tape.

CHARACTER_DEFINITIONS.REQ
        Symbol definitions for control characters.

DUMPER_SYMBOLS.REQ
        Macro and symbol definitions used in all of the various modules
        found in the utility.

TAPE_FORMAT.REQ
        Macros and symbols that define the format of a tape.

DUMPER_ERROR.MSG
        Message file that contains all of the DUMPER specific messages
        that are signalled.


Other miscellaneous files include:

DUMPER.RNH
        RUNOFF source for DUMPER help topic.  Note command documented
        is DUMPER32, you might want to change that to BAKDMP (here we
        defined a symbol DUMPE*R32 :== BAKDMP/FORMAT=DUMPER, sort of a
        cheap way of changing the default, an giving it a name that

                                                                Page 4


        would otherwise conflict with the DUMP command).

DUMPER.RNO
        RUNOFF source for document describing uses of DUMPER-32.

IUPUI_REVISION_HISTORY.TXT
        Descriptions of IUPUI revisions (there are also module-specific
        descriptions in the revision histories of each module).

NEWSLETTER.RNO
        RUNOFF source for a newsletter article we did on DUMPER-32.

THINGS_TO_DO.MEM
        Description of remaining known bugs/restrictions and a DUMPER-32
        wish list.

========> [VAX88A1.FINGER]AAAREADME.TXT;3 <========


Finger V47_1_01

Major changes:

o Finger 'someone' is completely rewritten. Someone had previously chosen
  to ignore everyone unless they were registered in the Finger Common Block.
  Not anymore! Finger now recognizes complete usernames (via getuai)
  of people not in the FCB.
o Finger 'someone' now fully interogates a user's mail file and
  displays number of new messages, and date AND SUBJECT of new messages
  sent by the Fingerer.

Minor changes:

o The SORT routine has a much improved algorithm for preloading indices.
o The CPU identification has be reworked to use the 'new' NODE_HWTYPE
  getsyi item. Finger should now be able to identify all present and
  future cpus.

Rand P. Hall                         rand@merrimack.edu (csnet)
Director, Academic Computing         617.683.7111
Merrimack College
315 Turnpike Rd.                     "There is elegance in simplicity."
North Andover, Mass. 01845                      - Kimball S. Maddocks

========> [VAX88A1.FLOWERS]AAAREADME.TXT;1 <========


CUSTOM COMPUTER APPLICATIONS - A subsidiary of Travelers Express
Spring 1988 DECUS Submissions

Some of the procedures require VMS V4.4 or later (GOSUBs).  At any rate,
I suggest reading the command procedures before using them.  As always,
neither myself nor Custom Computer Applications accepts any responsibility
for the use or reliability of these submissions.  They may not be sold for
profit, but may be distributed freely otherwise.  Enjoy!

                                              Harry Flowers
                                              Custom Computer Applications
                                              1780 Moriah Woods Blvd. #6
                                              Memphis, TN  38117

(See [VAX87C.FLOWERS] for other command procedures submitted last fall.
These command procedures are not as "generalized" as those, i.e., some
contain specific logical or directory paths which you may need to change.
We are currently running on VMS 4.7.)

Contents:
AAAREADME.TXT   This submission documentation file

        System Security
SECAUDITWILD.COM - Uses SYS$MANAGER:SECAUDIT.COM to get security alarm
                information, but allows wildcard file specs.
                For example, this will get the last weeks alarms, even
                if you have re-booted several times:
                $ @SECAUDITWILD SYS$MANAGER:OPERATOR.LOG;* "" -
                "''F$CVTIME("-7-","ABSOLUTE")'" "''F$CVTIME("","ABSOLUTE")'"
                (If you don't purge old OPERATOR.LOG files after a while,
                this might take a while to run.)
SYSCHECKSUMS.COM - Check checksums for all files in SYS$SYSTEM.  It produces
                a differences list with all of the changes.  You will normally
                see SYSUAF.DAT, VMSMAIL.DAT, and SYS.EXE (if you SET TIME)
                listed as changed files.  It excludes *.SYS (page and swap
                files), *.DMP (dump files), and JBCSYSQUE.DAT (the queue data
                file, which causes the CHECKSUM program some trouble).
ACCSUM.COM -    Accounting summary of current accounting file.  We set a new
                accounting file each week, and keep the old ones for a year.
CHKLOGTIM.COM - Show processes logged in over a certain time.  Helpful for
                spotting people logged in over night, etc.  Even though we
                run Watchdog, there are easy ways to circumvent being logged
                off.  This might even be modified to stop processes over a
                day old.

        Shared Image Utilities
FINDIMAGES.COM - Give it image names, and it finds all shared images they
                are linked against.
FINDIMAGEVER.COM - Same as FINDIMAGES.COM but also includes image versions.
FINDSHAREVER.COM - Give it shared images, and it finds the image versions.
SAVECURVER.COM - Save current VMS version shared images and linker.
USEPREVIOUS.COM - Use a previously saved version of the shared images and
                linker.  Note that some of the images must be INSTALLed
                afterward in order to work.  Also, the logicals are defined
                in the job table.  You may need to increase JTquota or change

                                                                Page 2


                them to process table logicals to work correctly.
NOUSEPREVIOUS.COM - Un-does the work done by the last command procedure so
                you don't have to log out or deassign all logicals.
<If you distribute software to customers who may not keep current with VMS>
<versions, it may not run.  These command procedures aid in being able to >
<send them a set of software which will run.  May be especially useful for>
<V5 to V4 shipping (if you use SAVECURVER on V4.7 before you upgrade).    >
<It's also interesting to see what images VMS utilities are linked against.>

        Miscellaneous
DISK.COM -      Show disk space - previous DECUS submission patched
                for longer disk names under VAXclusters (Fall87), and
                disks in shadow sets (Spring88).
VT2XXDEF.COM -  Download key defs to a VT200 series terminal - really nice
                for setting up terminal servers and for use within programs
                where there is no access to DCL DEFINE/KEY definitions.
                A bug which caused it not to work with VT320s has been
                fixed (Spring88).
SYSFILES.COM -  Looks at your page and swap file utilization, and makes a
                recommendation for a new size if the files are too small.
DCLTALK.LN3 -   A LN03-printable (with a RAM cartridge) copy of the first
                half of a session I had hoped to give this symposia, but was
                cancelled.  I am not including the source SliTeX files, as
                I hope to be able to give this talk later.  The second half
                (not included) are mainly example slides with the above
                command procedures and those submitted last fall in Anaheim,
                with comments about different interesting features.

========> [VAX88A1.GAMES]AAAREADME.TXT;1 <========


GAMES -
 The games directory contains some cribbage and poker games this time.
These have been isolated here to help out the system manager who
perfers to control access to games.
  - your librarian


========> [VAX88A1.GHC]AAAREADME.TXT;1 <========


In the beginning, there was RSX on a PDP 11/70 (at least for us).  Back
then we came across a nice utility on an RSX symposioum tape called FLY
(File Listing YOU-tility) which enabled us to produce multicolumn
hard-copy output and save much paper.  Even with our 780 (of blessed
memory) we continued to invoke FLY on a regular basis.  With our
advanced technology 8530, absent a trace of compatability mode hardware,
FLY is no more.  I have, therefor, written MCL (Multi Column Lister) in
VAX Fortran.  I hope you will find it useful.  A preliminary version of
the program appeared in the Fall 1987 tapes, courtesy of the PAGESWAPPER
and Dale Coy, who carried it to Anaheim for me.  I also thank Dale for
"goading" me into finishing the whole job!  We use it all of the time on
our 8530 and it have saved us tons of trees.

[Editor's note: FLY was a renamed version of LISTRSX, which was my
port to RSX-11 and extension of LIST, a DOS-11 program originally
written about 1974 by C. Lynn and others of the MIT CIPG group. It had
been renamed mainly to use a command other than LST to run it.]

Details of the program's capabilities can be found in the file MCL.DOC.
Briefly, however, the program will read a given file and reformat the
output to either as many columns as fit on a page (of width that the
user may specify) or the number of columns that the users specifies.
The output is directed to a file specified by the user;  a suitable
default is provided.

This is a corrected and enhanced version and incorporates almost all
that I could think of putting into the program, with one exception: I
have not taught MCL how to read LOG files correctly (so that carriage
control would be preserved).  This last item is waiting for version 5.0
of VMS, in case the specifications change on us.  In the interrum, I
recommend my program CVTLOG, which was submitted to the Fall 1983 tape
and I am including here.

Gerson H Cohen
National Institutes of Health
Bldg 2, Room 312
9000 Wisconsin Ave
Bethesda, MD  20892
(301)-496-4295

========> [VAX88A1.GNUSOFTWARE]AAAREADME.TXT;1 <========


GNU Software

This area contains several programs from the Free Software Foundation,
a group working on a complete replacement for Un*x which will solve
performance and reliability problems with the Un*x OS and add new
functionality.
        Included are BISON (a YACC superset), an AWK, Gnu Emacs,
Gnu C, Gnu C++, and several more. The VMS binaries for a bootstrap
Gnu C for VMS are included also.
        Please note that these utilities are primarily for GNU with
VMS variants in some cases. Also, Gnu C is a BETA version. It is fairly
usable nonetheless, and version 1.22 here is quite recent.
        When Gnu C finishes compiling all of Berkeley Un*x, it will
be called a "real" C. (This effort is reportedly going very well.)
        Gnu C has been reported to generate much better code than
VAX11 C and to emulate Un*x C better also.
        Complete sources to all files are present, but are presented
in compressed TAR saveset form. Tools able to pull these distributions
apart under VMS are furnished in the [vax000.tools] directory on these
tapes.

        Thanks to Richard Stallman et. al. for this software.

