========> [VAX88B3.RAGOSTA]AAAREADME.TXT;5 <========


This is the Fall 88 submission to the DECUS tapecopy project of the Anaheim
Symposium for the U.S. Army Aviation Research and Technology Activity (ARTA).

Submitted by:
   Arthur E. Ragosta
      and
   Laura E. Jurgeleit
   MS 219-3
   NASA Ames Research Center
   Moffett Field, Ca.  94035

   (415) 694-5578

Feedback, suggestions, bug reports, etc. are solicited.  Full documentation
can be found in each subdirectory.

Contents:

[CALCULATOR] An improved programmers calculator with binary, octal, decimal,
        and hexidecimal modes.  Uses reverse Polish notation.  Warning!!!
        This program uses true VAX internal representation for binary numbers;
        therefore, there is a floating/integer selection switch.  A massive
        rewrite of a previous DECUS submission.

[COOKIE] A fortune cookie program and file of fortunes.

[GRAF]  An interactive program for production of engineering graphics. 
        This program requires DISSPLA (Computer Associates, Inc.) or can
        be adapted for another graphics library.

[SYSTEM] System management tools and miscellaneous commands.

[TOOLS] The ARTA tools package.  A system of programs and libraries used
        to increase programmer productivity.  Latest release of SP-129.

[TUTORIAL] A VMS help library arranged in order of topics rather than command
        names to assist beginning VMS users.

[VG]    A program for the generation of presentation graphics (viewgraphs).
        This program requires DISSPLA (Computer Associates, Inc.) or can
        be adapted for another graphics library.


Note:  The source code is provided for all of the packages in this release;
virtually all of the packages must be linked with the library MERLIB.OLB
which is included in the TOOLS subdirectory.

========> [VAX88B3.RAGOSTA.TOOLS]AAAREADME.TXT;1 <========


                     FORTRAN Programming Tools  
                     Release III.4
This package contains a set of programming tools of either general interest or
specifically aimed at FORTRAN 77 users.  Although many of the tools are
transportable, some of the programs and all of the command files are specific
to the VAX family running VMS version 4.0 or higher. 

The following tools are included :

1. MERLIB - a library of FORTRAN and MACRO routines that provide useful 
capabilities for FORTRAN programmers.  This library can also be linked to 
any language that is capable of supporting the FORTRAN interface on the VAX.

2. BUGOUT - a set of programs for the debugging and optimization of FORTRAN 
source codes.  This package is specifically for the determination of coding 
problems that could result in addressing errors (e.g., COMMON blocks of 
different lengths in different routines, CALL statements with more or fewer 
arguments than the SUBROUTINE statement).  Additional capabilities include
automatic compilation with /DEBUG=BOUNDS, continual traceback printout, proper
initialization and use of variables, and CPU time used by each subprogram.

3. CHECK72 - a program to verify that no text has been typed beyond column
72 (or 80) of a FORTRAN source deck (or other file).

4. DOUBLE - a program to list two files side-by-side on a VT100-compatible 
terminal.

5. EIGHTY - a program used to crunch a text file whose records are longer 
than 80 columns into 80 columns.  UNEIGHTY restores the records to full length.
(This program was written because our HASP communications will not transfer
files with records longer than 80 columns.)

6. FILTER - a program to replace text strings with other text strings.

7. FLS, FS - .COM files used to submit FORTRAN compiles to the batch queues.

8. FORTLIST - a useful listing program that formats a FORTRAN file, produces 
a listing with page numbers and dates, and creates a table of contents and 
index by subprogram name.

9. FORTVMS - a program for reformatting a file with FORTRAN-compatible 
carriage controls into a VMS-standard listing format.

10. NAMEIO - a program to replace NAMELIST I/O with transportable,
FORTRAN 77 code.

11. REORDER - a program to reorder the subprograms in a source file.

12. SPLIT - a program to split FORTRAN source codes into subprograms.

13. STRIP72 - a program to remove all characters beyond column 72 and remove 
trailing blanks.  STRIP removes all trailing blanks only.

14. STUB - a program to create dummy subprograms with a standard format 
prologue of comment cards.

                                                                Page 2



15. UNTAB - a program to replace tab characters with the correct number of 
blanks.

16. VMSFORT - a program for reformatting a file with VMS-standard carriage 
control to the FORTRAN-compatible control characters.

17. CLEANUP - a source-code cleanup and structuring utility for FORTRAN 77.

18. GROK - returns number of characters, words, lines, carriage control
type, length of longest line, and existence of TABs.

19. INCLUDER - replace INCLUDE statements in a source code with the file
referenced.

20. SEND - a nifty little send_message_to_username routine used by some
of the batch procedures.

21. FIFE - the Friendly, Interactive FORTRAN Environment is a general purpose
executive program for development of flexible, user-friendly systems.  The
user interface is command-oriented (maybe an optional menu-based interface
will be provided in the future) and has been found to meet with good user
appeal.  Modules and new commands can be added with great ease.  This version
is preliminary but has already been found to be quite useable.

========> [VAX88B3.RANDNOS]AAAREADME.TXT;1 <========




Uniform Random Numbers and Symbols command file


10 Files:

        ReadMe.1st (this file)

        InitU16.ftn     Unifrm16.ftn    |
        InitU32.ftn     Unifrm32.ftn    | random numbers
        Initu.for       Unifrm.for      |

        Symbols.cmd     Symbols.com     | symbols
        Symbols.txt                     |


The random number routines are FORTRAN versions of combined random number 
generators recommended by Pierre L'Ecuyer (Efficient and Portable Combined
Random Number Generators, Communications of the ACM, Vol. 31, No. 6 (June
1988), 742-749, 774).  Three implementations are given:  two for PDP-11's and 
one for VAXes.  For PDP-11's, use the two '*16.ftn' files for short (16-bit) 
integers (especially if you don't have F77), or the two '*32.ftn' files for 
long (32-bit) integers (if you have F77).  For VAXes, use the two '*.for' 
files.  Note that the only real difference between the '*32.ftn' files and the 
'*.for' files is that the latter are specifically written for VAX FORTRAN:  
there is no difference in the generation formulae.  Therefore, if you want a 
16-bit generator for your VAX, you can use the '*16.ftn' files.  

The approximate period length for each generator is noted in the 'Unifrm*.*' 
files.


The 'symbols.cmd' file is a PDP-11 command file skeleton that provides a large 
number of symbols for use by RSX Indirect (@).  For PDP-11's, you would insert 
your command file instructions between the symbol definitions section and the 
subroutines section (near the end of the file).  This grew from a VAX version
that provided row and column positioning escape sequences for VT1xx, VT2xx, 
and VT3xx terminals, plus a few other video characteristics like bold and 
reverse video.  I decided to make a small file for PDP-11's, so I could have 
some of the more common escape sequences, without using up too much symbol 
table space or taking too much time.  Well, did I get a surprise!!  It turns 
out that if you built the large (ICP) version of Indirect on RSX, you have 
gobs of symbol table space.  If you use one of the J-11 CPU's (KDJ11-xx 
series), it doesn't take much time to define all those symbols either!  So, 
this file now has symbols for 24 rows, 80 columns, plus most of the VT2xx 
escape sequences (video characteristics, selective erase, etc.).  As it is 
right now, the symbols take only about 1/3 of the RSX ICP symbol table, and it 
takes about 2-3 seconds to run through the definitions.

The 'symbols.cmd' file originated at the Wichita Farm Credit Services as 
'form_symbols.com'.  I have followed their standard (which I believe is a VERY 
GOOD one) for command files:  "Command files shall contain NO non-printable 
characters."  This is quite easy for VMS DCL, but is somewhat of a pain for 
RSX folks.  (If you complain about VMS DCL, read 'symbols.txt' and 

                                                                Page 2


'symbols.cmd' and you will probably decide that things aren't really so bad 
after all.)

For you VAX folks, there are two extra files:  'symbols.txt' explains how one
would convert 'symbols.cmd' to a VMS DCL command file.  'symbols.com' is all
of 'symbols.cmd'.  I have not had an opportunity to test this file, but if
there are any problems, they should be minor. 


James Fullerton
Institute of Logopedics
2400 Jardine Drive
Wichita, KS  67219

========> [VAX88B3.ROCKWELL]AAAREADME.TXT;2 <========


          Author:       G. Beau Williamson +
                        George Flint
                        Rockwell International
                        1200 N. Alma Rd.
                        Richardson, TX. 75081
                        (214) 996-5547

-----------------------------------------------------------------------------

1. [.IMU]

        IMU is a Rights Identifier Management utility program that permits 
        authorized, non-priviledged, users to "Grant" and "Revoke" certain 
        Rights Identifiers to/from other users via an "Authorize" like set
        of commands.

        For example:

                     IMU> GRANT/ID identifier username

        IMU therefore allows the authorized users to manage their own generic
        Rights Identifiers (such as application or project oriented identifiers)
        specifically set up for them by the System Manager without needing 
        access to the "Authorize" utility. 

        Users may optionally be granted the ability to authorize other users 
        to grant and revoke the Rights Identifiers under their control via the
        ACL editor. 

2. [.SECURITY]
        
        The Security program is an idle terminal watch program that monitors 
        the system for terminals that have been left idle and automatically 
        logs them off if it has been idle a specified period of time.  A 
        terminal (process) is considered idle by Security if it has not 
        generated a minimum amount of CPU time or a minimum number of Buffered
        IO's during a set time period.


        The following is a summary of the basic features of Security V2.0.

           1. Idle terminals are logged out when idle period is exceeded.
           2. Idle terminals may, optionally be warned of pending logout.
           3. Security Alarms are optionally sent to OPCOM.
           4. Subprocess activity is included in the idle computations.
           5. Processes running "Critical Images" are immune.
           6. The list of "Critical Images" may be modified.
           7. A Log file of all Security activity is produced.
           8. All Operational Parameters may be set via system logicals.


========> [VAX88B3.RUCKERT]AAAREADME.TXT;1 <========



                           ^     ^
                          / \   / \
                         /   \ /   \
                        /     O     \
                       /             \
                       --------------- 


This submission from Medtronic, Inc. contains 2 utilities:


 (1) VAX_MENU is similar to other proprietary menuing products.  It
     allows conditional menu options based on symbols within the program.
     It also allows for non-interactive use.  Creation of DCL command
     files defined within the menu definition product is also supported.

 (2) The WHOIS utility allows non-privileged users to display owner information
     from the SYSUAF about any user on the system.  This is especially useful
     for systems where many of the users are unfamiliar to the system manager.


              Roger G. Ruckert
              Senior Software Analyst
              Medtronic, Inc.
              Mail Stop B100
              7000 Central Ave. 
              Minneapolis, MN  55432

              (612)574-4742


========> [VAX88B3.SHOWUAF]AAAREADME.TXT;1 <========


                             ShowUAF, Version 1.0

SHOWUAF is designed to allow a VAX system manager to effectively examine 
the system User Authorization File(s) SYSUAF.DAT on one or more VAX 
systems.  The files can be accessed directly or via DECnet.

SHOWUAF will display all users that satisfy a specified set of 
parameters.  For example, to display all users that have the SYSPRV 
authorized privilege, the input command would be:

        SHOWUAF> PRIV=SYSPRV

Input commands to SHOWUAF consist of sets of parameter-value pairs. (In 
the above example, PRIV is the parameter, SYSPRV is the value). A 
parameter-value pair is connected by a comparison character of "=", "\", 
"<", or ">", which signifies that the check should be for users whose UAF 
value is equal to, not equal to, less than, or greater than, the value 
specified. When a parameter-value pair is processed, the result is either 
TRUE or FALSE. The sets of parameter-value pairs are separated by 
operators AND or OR, depending on whether the result of the processing of 
the parameter-value pair should be logically ANDed or ORed with the 
(composite) logical result of the previous pair(s).  For example, to show 
all users not in UIC group 20 that have SYSPRV authorized privilege and 
have not logged in interactively since the beginning of 1988, the input 
command would be as follows:

        SHOWUAF> GROUP\20 AND PRIV=SYSPRV AND LOGINT<01-JAN-1988

-------------------------------------------------------------------------------
Installation of ShowUAF is via VMSINSTAL as follows:

        $ @SYS$UPDATE:VMSINSTAL SHOWUAF (kit location)

The IVP furnished in the kit will create a default SHOWUAF_NODES data file
that is required by the program. This file will contain the local nodename
and access path to SYSUAF.DAT and will be put in SYS$MANAGER.

(ShowUAF will run under VMS 4.4 through VMS 5.0-1)

Happy UAFing!

Stuart Renes
OneDataPlace, Inc.
2813 Parkhaven Drive
Plano, TX  75075
(214) 867-0057


SHOWUAF is an enhanced (and bug-fixed) version of the SCANUAF program written
by J.D. Snyder at the Princeton Plasma Physics Laboratory.

========> [VAX88B3.SPCTELE]AAAREADME.TXT;1 <========


                   Space Telescope Science Institute 

   ABSTRACTS             F I L E   L I S T I N G 

--------------------------------------------------------------------------------

                       *******************
                       * C O M F I L E S *
                       *******************

AAAREADME.TXT           this file
CHECKQUE.COM            Check that certain jobs are present in certain ques
CHECK_INTRU.COM         Searches intrusion database for intrusions 
CHECK_PRIVS.COM         Checks SYSUAF for newly privileged users
DEV.COM                 Give you device information
ENVIRON.COM             Example of power of lexicals, shows user environment
HOLDEF.COM              Save place(s) to later JUMP back to
ISAM_FIX.COM            Remake ISAM files for efficiency
LOGFILE.COM             Database for logging problems
MAILSPAWN.COM           Get in and out of mail INSTANTLY
MOUNT_ANYTHING.COM      Like it says. mount anything
MOVE.COM                Move files
NET_COMMAND.ARC         Sample Decnet task to task communication
NET_MOVE.COM            Copy across Decnet
SCHED.COM               your week ahead, works off of REMINDER utility
USER.COM                Another way to show a users process
WHODEV.COM              See who allocated that tape drive you so dearly wanted


--------------------------------------------------------------------------------


                             ***************
                             * A D J U S T *
                             ***************


A mechanism for supressing compute-bound interactive jobs.

The command procedure BUILD.COM builds the package

The command procedure ADJUST.COM is invoked to start up the utility. 
We start it up at boot time from SYSTARTUP.COM.

A further description as well as the algorithm are included in ADJUST.DOC 

--------------------------------------------------------------------------------


                            *********************
                            * E V E R Y B O O T *
                            *********************


        At our site, our users have a need for various things to be done

                                                                Page 2


     on reboot (such as defining group logicals).  As we're not (yet)
     staffed 24 hours a day, if a machine crashes in the middle of the
     night and reboots, we'd have a bit of a problem.

        On the other hand, to insure system security, we don't want users
    to be able to write unrestricted to systartup.  This program then runs
    whatever file they wish run on reboot with only their privs.  In fact,
    if an error occurs in their file or their file mysteriously disappears,
    this will in no way affect the rest of the reboot.

      Futher instructions regarding installation are in the beginning of
    EVERYBOOT.FOR


--------------------------------------------------------------------------------

                               ***************
                               * L O G G E R *
                               ***************

     Logger is a program that logs shutdowns, startups, crashes and
   reasons for crashes to a file.  It is a rework of the original program
   written by someone else in the C language.  These programs produce a
   useful monthly uptime report:

                    NODE=VAXA

          UPTIME SUMMARY FOR MONTH OF SEP



 Out of an available  43200 minutes, (30 days)
 The machine was down for   1488 minutes
   (or  1 days,  0 hours, and 48 minutes)

 Business hours are from 8:00am to 6:00pm

    277 minutes were during business hours
 or  0 days,  4 hours and 37 minutes real time
 or  0 days,  4 hours and 37 business time


  2 Crashes occurred
  9 Orderly shutdowns were performed

  2 of the shutdowns were during business hours
  1 of the crashes were during business hours

 Percent uptime was 96.56%

 Average elapse time to reboot on crashes was   97 minutes

 Average elapse time to reboot on shutdown was  143 minutes

------------------------------------------------------------------------------  

                                                                Page 3



                            *******************
                            * P I C T U R E S *
                            *******************


    Straddling quite a number of large networks, we tend to come across
  a great many interesting pictures.  These files should be typed to
  your screen and are all compatible with vt220s at the very least.
  Half were created in-house. Others, well... what comes around, goes
  around.  Wherever possible, we have left the authors name attached.
  A great deal of work often goes into these.  I therefore apologize
  beforehand if it appears that we plagarized someone elses handycraft.
  That was not our intention.  

    BEER.TXT
    CHEERS.TXT
    DIGITAL.TXT
    DUCKPAINT.TXT
    FIREWORKS.TXT
    FISH.TXT                  
    FLAG.TXT                  
    GSD.TXT                   
    GUN.TXT                   
    ME.TXT                    
    MRBILL.TXT
    NASA.TXT                  
    PAINTMOON.TXT           
    PAINTSUN.TXT            
    SHUTTLE.TXT               
    TWILIGHT_ZONE.TXT
    XMAS.TXT        
--------------------------------------------------------------------------------


                             *******************
                             * U N D E L E T E *
                             *******************


      AMAZING!!!!  A way to retrieve files you "accidentally" blew away.

      This utility is not guaranteed to work in any way (but it does!)  It
   is highly dependant on the amount of IOs to the target disk.  If the disk
   happens to be quite busy eg a system disk, your file has probably already
   been allocated to someone else.  

      Essentially it recreates your file from info in the FIB.


========> [VAX88B3.SUBMIT]AAAREADME.TXT;1 <========


                *** SRBSUB DECUS Tape Library Submission ***
                        Steven R. Berman
                        Northrop, Inc.
                        2301 West 120 Street  H252 / C1
                        Hawthorne, CA 90250

                        (213) 606-6422

        This submission contains four files:

        1. READ.ME (This file)
        2. SUBMITDR.FOR (A FORTRAN Program designed to demonstrate
                        (exercise) the SUBMIT routine
        3. SUBMIT.FOR (A FORTRAN Subroutine that submits jobs to a batch queue)
        4. TEMP.COM (A sample command file that is submitted to the batch queue
                    by running SUBMITDR).

        You may compile and link these programs as follows:

        $ FORTRAN SUBMITDR
        $ FORTRAN SUBMIT
        $ LINK SUBMITDR,SUBMIT

        The two FORTRAN modules will work with the optional /CHECK qualifier
        on the FORTRAN command line.

========> [VAX88B3.TALK]AAAREADME.TXT;1 <========


 /// /// /// /// /// /// "TALK" Conferencing System \\\ \\\ \\\ \\\ \\\ \\\
/// /// /// /// /// /// /// /// /// ///  \\\ \\\ \\\ \\\ \\\ \\\ \\\ \\\ \\\

                        Bob Lafleur
                        45 Ionia Street
                        Springfield, MA 01109-2519

                        Phone:          (413) 737-8503
                        CompuServe:     75146,3122
                        GEnie:          SKID
                        Dataseek:       SKID
                        Bitnet:         Skid@UMass.Bitnet
                        Packet Radio:   NQ1C @ W1NY

        Intorduction documentation for version 1.7      13-Oct-88


/// /// /// /// /// /// /// /// /// ///  \\\ \\\ \\\ \\\ \\\ \\\ \\\ \\\ \\\


   TALK is an interactive conferencing system for VMS that allows different
users of the system to communicate with each other. TALK uses a "conference"
metaphor rather than the standard "channel" metaphor popular among chat
systems and "CB" simulators.

   TALK has an extensive command set which is described in the online help
in the TALK system. This document will not attempt to describe the commands
available within the TALK system, although a quick reference of the commands
follows to give you an idea of the commands available:

   /ACTIVITY                          Show an activity summary of TALK,
   /ALERT[,system name]               Alert when user enters TALK,
   /ALLOW,user name                   Allow a user to speak,
   /BYE[,comment]                     Exit TALK,
   /CLEAR,flag name                   Clear a flag,
   /CLS                               Clear terminal screen,
   /COMMANDS                          Lists TALK commands.,
   /CONTROL                           Take control of the conference,
   /CREATE,conf name[,password]       Create a conference,
   /DCL[,command]                     Access DCL from TALK,
   /DESCRIBE[,conf name]              Print a conference description,
   /DISABLEQ                          Disables the speaker request queue.,
   /DISALLOW,user name                Disallow a user to speak,
   /DONE[,comment]                    Exit TALK,
   /ENABLEQ                           Enables the speaker request queue.,
   /ESSAY                             Enter a multi-line message,
   /EVICT,user name                   Evict a user from a conference,
   /EXIT[,comment]                    Exit TALK,
   /FACE[,style]                      Change face style,
   /GRIPE                             Submit a gripe about TALK.,
   /HOLD                              Puts the current essay on hold.,
   /JOIN,conf name[,password]         Join a conference,
   /KILL                              Erase current essay,
   /LIMITS                            Displays Talk's current limits.,
   /LIST                              List current essay,

                                                                Page 2


   /LOCK,password                     Lock a conference,
   /LOG[,number]                      Display userlog,
   /MAIL[,vax user[,subject]]         Access the VAXmail system,
   /MAKE,conf name[,password]         Create a conference,
   /MODERATE                          Make the current conference moderated,
   /MONITOR[,conf name[,password]]    Monitor a conference,
   /NAME,new name                     Change nickname,
   /NEXT                              Let the next person in the queue speak,
   /NEWS                              Shows Talk news,
   /NODES                             Shows a list of nodes linked to Talk.,
   /NOMONITOR                         Stop users from monitoring conference.,
   /QUEUE                             Display the speaker request queue,
   /QUIT[,comment]                    Exit TALK,
   /RELINQUISH                        Relinquish control of your conference,
   /RENAME                            Give the conference a new name,
   /REPLY                             Reply to the last private message,
   /RESEND[,user name]                Resend last multi-line message,
   /SEND[,user name]                  Send a multi-line message,
   /SET,flag name                     Set a flag,
   /SHOW[,flag name]                  Show flag settings,
   /SILENCE,user name                 Disallow a user to speak,
   /SPEAK                             Enter a request into the speaker queue,
   /SQUELCH[,user name]               Squelch (ignore) a user,
   /STATUS                            Show status about yourself.,
   /SUMMARY                           Show a summary of Talk users,
   /TO[,user name]                    Direct a message to a user,
   /TRANSCRIBE[,file name]            Transcribe conference to file,
   /UNHOLD                            Take essay off hold,
   /UNLOCK                            Unlock a conference,
   /UNMODERATE                        Unmoderates the conference,
   /UNSQUELCH,user name               Unsquelch a user,
   /USERS[,conf name]                 Show users on TALK,
   /WHISPER,user name                 Send a message to a specific user,


/// /// /// /// /// /// /// /// /// ///  \\\ \\\ \\\ \\\ \\\ \\\ \\\ \\\ \\\

========> [VAX88B3.TECOMACS]AAAREADME.TXT;1 <========


                                Utilities

                                Kelvin Smith
                                Financial Computer Systems, Inc.
                                1 Strawberry Hill Ct.
                                Stamford, CT  06902
                                (203) 357-0504


This submission contains TECO source (.TES), TECO compiled (.TEC), and
documentation (.DOC) for the following:

BSLASH - Put all backslashes in a BASIC program at the beginning of a
line.  This can be useful for setting up a program to run STRIP on it.
        This macro does not have a separate documentation file.  Basic
documentation is found at the beginning of the source (.TES) version.

CASE - Convert lower case to upper case or vice versa in an entire file,
not changing letters inside quoted strings or in comments (delimited by
exclamation points).  This is primarily intended for working on programs;
thus, quoted strings must terminate on the same physical line and comments
are held to terminate at the end of a physical line if not explicitly
terminated by a second exclamation point.
        Optionally, you can also change colons to backslashes (for changing
from old versions of BASIC to current VAX BASIC/BASIC-PLUS-2 standards).
Note that you don't want to use this feature if you have statement labels.
        This macro does not have a separate documentation file.  Basic
documentation is found at the beginning of the source (.TES) version.

RENAME - Rename variables in a BASIC program (including hard-to-find
single letter variables).  RENAME works properly on extend mode BASIC-PLUS,
BASIC-PLUS-2, and VAX BASIC programs.

STRIP - Remove unnecessary backslashes and ampersands from BASIC
programs (primarily for converting from BASIC-PLUS-2 V1.6 to BP2 V2.x).
        This program was previously published in the December 1984 issue,
Volume 6, Number 6, of the VAX/RSTS Professional (now VAX Professional);
it and the documentation have been slightly updated.

TECOIN - TECO Initialization:  Documentation on how TECO on RSTS and
VMS gets started, and an example of how to customize the initialization
process.  The example includes small macros to: delete to the n-th
occurrence of a given character; backup a file being edited; exit from
TECO marking the position in the file for future return; delete a section
of text, saving the deleted text in a q-register; set flags and adjust
the file specification on entry to TECO; specify a series of commands
at DCL/CCL level to be executed within TECO.
        This program and documentation originally appeared in the
January 1988 issue of Leverage, the newsletter of the Languages &
Tools SIG.
        The compiled TECO program is called TECO.INI, rather than
TECOIN.TEC, since it would normally be used with that name (see the
documentation for details).



                                                                Page 2


This submission also contains source (.B2S) and documentation (.DOC) for
the following BASIC-PLUS-2 program:

BDUMP - A binary file dumper, with options to display ASCII values in
octal or decimal by byte or by word.  This program contains a highly
optimized octal word formatter.  The program can be easily altered
to run under VAX BASIC (V2 or higher) or RSX BASIC-PLUS-2.


All programs were originally designed and written for RSTS.  They may or
may not be as usable under other operating systems.

========> [VAX88B3.TICKLER]AAAREADME.TXT;1 <========


TICKLER

TICKLER is a utility to provide a means of sending a message to a group 
of users on a regular basis.  The user inputs the message along with the 
day of the week he wishes to the message to be sent and a MAIL distribution
list.  The TICKLER utility requires a title to be given to each message.

========> [VAX88B3.UALR]AAAREADME.TXT;1 <========


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


   Submissions by:      Dale Miller
                        University of Arkansas at Little Rock
                        Data Center
                        2801 S. University
                        Little Rock, AR  72204-1099
                        DOMILLER@UALR.BITNET


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


[.BBS]       -  A full-function bulletin board system for the VAX.  It has
                messaging, conferencing, uploads, downloads, etc.
                Rev. 7.1.  This version provides user definable text, naming,
                etc. so that it may be installed and used by most sites as is.

[.CB]        -  A CB simulator for the VAX.  So good you'll think it's the
                real thing!  Identical to previous submission, but included for
                completeness of UBBS.

[.READBACK]  -  A BACKUP save-set extraction utility.  Allows you to extract
                a list of files from a backup save set.  Not particularly
                general purpose, but useful.


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


These four commands are provided by the

Academic Computing Center
University of Kansas
Lawrence, KS 66045
(913)864-0100
BITNET: ukanvm, ukanvax
INTERNET: ukanvm.cc.ukans.edu, ukanvax.cc.ukans.edu

cli_set : Command Line Interpreter for Program Development in C
prt :     Page Format and PRinT Facility. 
ldir:     List Directories, separating files from subdirectories
symon:    Screen Oriented System Monitor.


========> [VAX88B3.USCG]AAAREADME.TXT;1 <========



        After years and years of using software off the VAX SIG tapes, I
        thought I could at least try to give something back.  Items from
        the VAX SIG tape play such an important part of our computer sys-
        tems, that most users think VAXNET, WPE, SPELL, and WHAT are DEC
        supplied utilities and other users have tried to "buy" these
        utilities from DEC salespeople for their VAX systems.

        So what do I (and the U.S. Coast Guard) have to give back ?  Well
        the answer is Datatrieve functions.  We do a lot with Datatrieve
        and add functions in to do what Datatrieve can't [yet] do.  Here
        is what we have:

        [USCG.BABY_ED]
        This is a function that creates an EDT-style editor to enter or edit
        long strings.  Very useful in many cases.

        [USCG.CONVERT_STR]
        This is a function for examining variable length records - one of
        the type - length of field, field.  Interesting technique.

        [USCG.DOC_TRACK]
        This is a complete document tracking system using FMS and Datatrieve.
        It will probably need to modified unless your branch is also called:
        "Office of Acquistion".

        [USCG.LOV]
        This is a function that implements a List of Values - just like 
        Rally has - for Datatrieve.  Presented at Fall 88 Wombat Magic.

        [USCG.SWAP_FMS]
        This is a function that allows the user to switch the TAB and the
        RETURN keys.  Make applications easier to use since everyone hits
        RETURN all the time when they should have hit TAB.

        If you have any comments or suggestions or questions you can give
        me a call at (202)267-2627 or FTS 267-2627.  If these functions 
        help you just pay us back by only saying good things about the
        "Coast Guard" -- we need all the *good* publicity we can get.

        Bert Roseberry
        U.S. Coast Guard
        G-APS-3
        2100 Second Street, SW
        Washington, DC  20593

========> [VAX88B3.VAXFONT]AAAREADME.TXT;3 <========


Hello,

This program has been destined for a DECUS tape since May of 1986, and is just 
now making it.  I must confess, there are sections of the code that are not
as nice as I would like them to be, so I'm not including the source.  (Trust me,
some of it's pretty scary.)  Speaking of scary, I understand, being a systems
programmer myself, that people can be scared by executables.  So, I am including
the OBJECT file as well.  If you LINK/MAP/CROSS you will see all the system
services and run time library calls in this.  And the program does not need
to be installed or need privileges to use.  It also restricts file access to 
files in the SYS$LOGIN directory tree that have the extension .FNT.

The code has been unchanged since December of 1986, and has successfully 
survived several updates of VMS.

There is no help beyond this file outside of the on-line help.  This is brought 
up by pressing the help key when the program starts up or at the main screen.

This version fully supports VT200 series terminals and supports VT300 series 
terminals in VT200 mode as described in the VT330/VT340 Programming Reference 
Manual.

Please send comments, bugs, and suggestions for the new version (which will 
support vt3xx terminals better) to me either electronically or US postal.


Richard DeJordy
Systems Programmer
American Mathematical Society
P.O. BOX 6248
Providence, RI 02940

RAD@MATH.AMS.COM on the Internet.

or

Mike Johnson
Consultant
Welty-Leger
939 Boylston St
Boston, MA 02115


(I'm in the process of converting the program itself to Macro or Fortran or 
both [I have some of the code already translated into both], so the next version
won't be in VAXBASIC, be that good or bad, I no longer have a BASIC compiler, 
so I have little choice.)


========> [VAX88B3.VMSNET]AAAREADME.TXT;1 <========


     !!![VAXYYY.SUB]AAAREADME.TXT!     BUILDREAD.COM    NOW    DOES    THIS
     AUTOMATICALLY.


             The VMSnet Working Group (VAX Systems SIG) Submissions


                                coordinated by:


                                 Jamie Hanrahan
                               Simpact Associates
                    9210 Sky Park Court, San Diego, CA 92123
                               619-565-1865 X116
                               jeh@crash.cts.com


     This directory tree contains Version 0.2 of VMSnet,  a  package  which
     allows VMS systems to exchange mail with other systems (including Unix
     systems, and VMS systems running this software)  using  the  uucp  "g"
     protocol.

          Documentation is in the [.DOC] directory.

          Most directories  here  have  a  file  called  _FILES.TXT,  which
     describes   the   files   in   that  directory  (and,  sometimes,  the
     subdirectories thereunder).

          The total space required for these files is about 36,000  blocks,
     or  about  23,000  if  you  are  receiving this on the Fall 88 VAX SIG
     Symposium tape (in which case News 5.4 isn't  included,  because  News
     5.6  is  elsewhere on the tape).  If you have no plans to work on this
     software,  you  can  save  about  9,000  blocks   by   not   restoring
     [.DEVEL...], [.ORIG_CODE], and [.TOOLS].

          Other contact, in case Jamie can't be reached:


     Tom Allebrandi II
     ACCI
     206-F West Market Street
     Charlottesville, VA 22901
     804-977-4272

========> [VAX88B3.WOLFE]AAAREADME.TXT;1 <========


                                 submitted by:

                                   Tom Wolfe
                           Jet Propulsion Laboratory
                               Mail Stop 510/200
                              4800 Oak Grove Drive
                              Pasadena, CA  91109
                                 (818) 397-9280


     The following items are submitted:

     1.  [.CALC]  My  CALCulator  provides  the  capability  of  evaluating
         algebraic  expression.   The  results  may  be  displayed  on  the
         terminal or stored as a symbol and used in further calculations.

         100 symbols may be  defined  with  each  symbol  being  up  to  31
         characters long.  Symbols may be used in calculations, modified or
         there value displayed on the terminal.

         Over twenty math functions are available including  pseudo  random
         number generation.

         Calculator commands can be stored in files and executed.   Command
         files  allow  the  user  to  develop  there  own unique functions.
         Command files can also prompt  the  user  for  input  as  well  as
         execute other command files.

         Integer data may be entered in  octal,  decimal  and  hexadecimal;
         floating-point data may be entered in decimal only.

         See CALC.MEM for more information.


========> [VAX88B3.WUEST]AAAREADME.TXT;2 <========


     VAX-DIGLIB (VAX Device Independent Graphics LIBrary) is a collection
of FORTRAN callable subroutines designed with the following goals:

       1.  Easily usable by the casual graphics programmer for 2D
           and limited 3D plotting.

       2.  Device independent (as much as possible).

       3.  Small and reasonably fast.

       4.  Device drivers are as simple as possible, and therefore
           easy to write, and device drivers may be written in FOR-
           TRAN when desired.

       5.  Compatible (as much as possible) with PLTLIB. This is a
           historical artifact that no one now needs be concerned
           with except former PLTLIB users.

       6.  Maintainable.


The file diglib.olb is the vax library file containing the object code for
DIGLIB.  The file diglib_sources.txt is the complete set of sources concat-
enated together.  Digplot.txt is the printer drivers separated from the rest
of the source code.


========> [VAX88B3.XCC_EVE]AAAREADME.TXT;1 <========



These are files containing EVE procedures that started as personal hacks
and as creative laziness on the part of the author.  In general, they
are dependent upon various EVE procedures; they also borrow from ideas
found in other DECUS TPU submissions.  The author's own source file is
in MAIN.TPU; a number of associated files have either individual TPU
procedures, or groups of related TPU procedures in them.

Generally, to use one of these procedures, EDIT/TPU the associated
source file, DO TPU COMPILE ( CURRENT_BUFFER ) , bind the command to a
key (see KEYDEFS.TPU for examples of that) , and DO SAVE EXTENDED TPU.
Then EDIT/TPU/SECTION=[the section file created by the SAVE] will
be the extended EVE editor you just created.  To get the author's
current EVE interface, start with ROMTPU.SEC, compile MAIN.TPU, and
save the result (which will be the same as TPU.SEC).

ASCII.TPU has a procedure for inserting ASCII characters into text

BUFMANAGER.TPU:  A windowing buffer-manager that allows you to see a
        summary of the information about the current buffers, return to
        the buffer from which BUFMANAGER was called, go to buffers,
        delete buffers, write buffers out to disk, read in files from
        disk, FORTRAN-compile the currently-highlighted buffer (using
        the TPU procedure in F_COMPILE.TPU), and exit from EVE.

CHANGECASE.TPU  has procedures for upcasing, downcasing, capitalizing
        either single words, or the entire select_range, if any.

COUNT.TPU:  Count the characters, words (defined to be any contiguous
        sequence of non-whitespace characters), and lines in the current
        buffer, or in the current select-range, if there is one.
        NOTE:  this procedure is NOT blindingly fast.

DATE.TPU:  Insert the current system date in a reasonable format at the
        current editing position.

DECIMAL.TPU:  Prompt for a number in decimal, and display the
        corresponding hexadecimal in the message-window.

DEL_PAT_LINES.TPU:  Prompt for a text string to be searched for and
        deleted, then repeatedly prompt for file-names.  For each
        file read in, search through it for the search-string, and
        delete all lines in which the string appears.

DETAB.TPU replaces tabs by spaces, assuming tab spacing of 8 starting
        at column 1.

DISPLAY_CHAR.TPU displays ASCII number(in both decimal and hex), name,
        control-sequence, and printing character(if any) associated
        with the character under the cursor.

ERASURES.TPU does variations on "erase rest of word" , "erase rest-of-
        line"

FILELIST.TPU:  Prompt for a file-spec, and display a listing of the

                                                                Page 2


        corresponding files in the DCL-buffer.  Useful for creating
        command procedures via cut-and-paste.  (In that context, see
        also FILLS.TPU)

FILLS.TPU:  Contains procedures to pre-pend or post-pend a source
        string to all the rest of the lines in the current buffer, or
        in the current select-range, if there is one. Useful (with
        FILELIST) for creating command-procedures via cut-and-paste.

FINDLABELS.TPU:  Find the next FORTRAN label (line-begin, followed by
        0  to  4  blanks, followed by a digit) in the current direction.

FIXLABELS.TPU takes FORTRAN labels and left-justifies them to column 1
        (as opposed to the practice of right-justifying them to column
        5 , as done by some misguided individuals at the author's
        location).

FIX_CRLFS.TPU replaces <CR><LF> , <CR> , and <LF> characters by TPU
        LINE_BEGINs and LINE_ENDs.

FIX_LIS.TPU:  generates headerless, page-break-free FORTRAN listing files
        by doing global search for formfeed character, then deleting
        four lines starting at that position (thereby deleting the page
        break and the header inserted by the compiler.  Makes it much
        easier to compare machine-code listings.  For safety's sake,
        this does check that it is working on a listing-file.

F_COMPILE.TPU:  FORTRAN-compile (with /LIST/EXTEND_SOURCE options) the
        file in the current buffer; if there are compilation errors,
        split the screen (if necessary) and display the listing file
        centered on the first error-message.  Set the EVE search-target
        to "FORT-" to find any additional errors.

F_PRETTY.TPU:  Does global search-and-replace with the intent of
        generating a reasonable amount of whitespace from "dense"
        FORTRAN code -- replacing "(" by " ( ", etc., and then fixing
        extra sets of blanks introduced.  Because of fix-ups, does not
        affect reasonably-styled FORTRAN much.  MANUAL CORRECTION of
        line-lengths REQUIRED afterward.
        Also contains CJC_INDENT_BLOCK which indents the current
        select-range by 3 spaces (not indenting FORTRAN comments;
        handles FORTRAN labels correctly.
        ASSUMES ANSI-style FORTRAN with no tabs.

F_IBM.TPU:  Does part of conversion from VAX FORTRAN to IBM FORTRAN--
        converts *-comments, !-comments, D-lines to C-comments, fixes
        up empty lines, replaces '_' by '$'.

F_STRUC.TPU:  Contains procedures to build FORTRAN DO-loops and IF-THEN-
        ELSEIF-THEN-ELSE blocks and maintain structured indenting.
        Requires INDENT.TPU; works using the indentation structure
        defined there.

GLOBAL_S_R.TPU:  Contains procedures to do global search-and-replace
        on:  the current buffer; a sequence of files entered from the

                                                                Page 3


        keyboard.

HEX.TPU:  Prompt for a number in hexadecimal, and display the
        equivalent decimal in the message-window.

INDENT.TPU:  Procedures for automatic indenting/outdenting; for setting
        the left margin at the current cursor-position.

KEYDEFS.TPU:  Some keydefs for things you may or may not have thought of.

MATCHPAREN.TPU:  Find the first paren, brace, or bracket in the current
        direction.  Move in the appropriate direction until the matching
        symbol (compensating for nesting) is found.  If there is none,
        display an appropriate error-message.

MOVES.TPU:  Procedures for moving cursor to top, middle, bottom of
        screen; for prompting for a displacement and jumping the
        requested number of lines forward or back (use negative
        displacement for that) from the current position; for generating
        FORTRAN line-continuations and comments.

NEWKEYS.TPU:  Defines CTRL4, CTRL5, CTRL6, CTRL7 keys, so that definitions
        may be bound to them. (Other EVE-not-defined control-keys interfere
        with "normal" keys:  CTRL3 is ESC, for example).

POSITION.TPU:  Procedure to report the line and column-numbers for the
        current position.

SETWINDOWS.TPU:  Procedure to set up variable-height windows for EVE, using
        the current cursor position to determine placement of window margins.

TOGWINDOW.TPU:  Cycles back and forth between ONE WINDOW / TWO WINDOWS.

WIDTHTOGGLE.TPU:  Procedure to toggle the width and margin back and forth
        among  7--72 , 1--80 , 1--132.

WRITES.TPU: Procedure to write either the current select-range or
        the current buffer to a file.

Carlie J.  Coats, Jr.
Computer Sciences Corporation
P. O. Box  12767
Research Triangle Park, N. C.   27709

(919)541-2563


========> [VAX88B3.YODER]AAAREADME.TXT;1 <========


                      Submissions from Harvey Mudd College


                    coordinated by:  Chris Yoder (HMC Math)


                                  Chris Yoder
                              Harvey Mudd College
                              Claremont, CA 91711
                              (714) 621-8000 x3619
                          email to: CHRIS@YMIR.BITNET


     The following submissions were either written  or  modified  by  Chris
     Yoder.

     1.  EveEDT -- An EDT keypad on top of  EVE.   Also  includes  thing  n
         window capability (where n is equal to (the number of lines on the
         screen - 2) / 2), rectangular  cut  and  paste,  and  more.   This
         submission  replaces  EVEEDT  that  was submitted on the Spring 87
         tape under Hughes  Aircraft  (or  perhaps  under  Kevin  Carosso).
         Updated for VMS 5.0 and the EVE Build procedure.

     2.  Calendar -- A utility program to help remind  people  when  to  do
         things.   Updated  by  Gerard Pence of Locke Computer Center.  The
         following changes were made:

          o  If years < 100 are entered, add 1900 to them.  and change  the
             help messages accordingly.

          o  Simplify the main menu by  adding  letter  commands( 's  still
             work)

          o  Increase from 5 to 10 the number of messages listed at a time.

          o  Remove the "erase screen" from the "exit" routine.

          o  Add a second calendar  (next  month)  and  keep  this  month's
             calendar on the screen just to the left of it.

          o  Cause the reminders to be displayed  in  BOLD  on  each  month
             calendar

          o  Add the [Y]ear display

          o  Add the repeat-type-code of each message to the [S]how display




     The following submissions have proven to  be  very  useful  pieces  of
     software.   The  authors  have  granted  me permission to submit these

                                                                          Page 2


     utilities.

     1.  PS -- PS converts normal ascii text files to postscript (PS) files
         that  may  be  printed  on  the  Apple  LaserWriter.  This new and
         improved translator has many features including allowing the  user
         to  choose  any of the built-in LaserWriter fonts.  Users may also
         adjust margins, and set the size of the chosen font.

              PS also can translate RUNOFF  .mem  files.   And  yes!   That
         means   you   can   have   underlining   and   boldfacing  on  the
         LaserWriter!!!!  Please look at the the additional information  on
         RUNOFF to find the RUNOFF specific commands.

              This is an update.  Bug reports to DOUG@YMIR.BITNET.


========> [VAX88B3.ZIRIN]AAAREADME.TXT;1 <========


See BUILD.COM, NANNY.TEX, and NMAIN.FOR for help. Use @BUILD to compile/link.

========> [VAX88B3.ZOOSRC]AAAREADME.TXT;1 <========

This is the source code for ZOO, a file archiving utility that
compresses data in the archives as it enters it and decompresses
data on the way back out. It appeared on an Amiga BBS but will apparently
compile OK for VMS also.
	- your editor.
(last minute addition!)
