[VAXF84.FERMILAB]AAAREADME.TXT


                Fermilab Accelerator Control System Submissions


                                 submitted by:


                               Dr. Frank J. Nagy
                     Fermi National Accelerator Laboratory
                P. O. Box 500 Mail Stop 306, Batavia, IL. 60510
                                 (312)-840-4935



          This directory tree is a submission from the Fermilab Accelerator
     Division.   The programs and command procedures in this directory tree
     are general utilities and system management utilities  either  written
     at  Fermilab  or  acquired  from  DECUS  (via  a  SIG tape or from the
     library) and modified.  In many cases the  software  can  be  used  at
     other  sites  without  modification;   some  of  the system management
     utilities are included as starting points from which sites can produce
     their custom versions.  Each of the next-level subdirectories includes
     an AAAREADME.TXT file which provides additional  details;   this  file
     provides an overview of the entire submission.


          This submission represents  files  added  or  changed  since  the
     Spring  1984 submission.  A complete resubmission has not been made of
     many of the files to help reduce the size of the SIG  tape.   To  make
     full  use  of  much  of the material in this submission, you must have
     access to the Spring 1984 SIG tape Fermilab  submissions.   Access  to
     the  Fermilab  Accelerator  Division  submissions on earlier tapes may
     also be helpful.


          Questions and comments on these submissions may  be  directed  to
     the  submitter  listed  above.   Fermilab will not provide support for
     this software on anything other than an informal basis as time allows.



     [.LIBRARY]


          This area contains object, macro and text libraries which provide
     extensions  to  the  system libraries in SYS$LIBRARY:.  The sources of
     new and changed routines are included (see Spring 1984  SIG  tape  for
     the  remaining  sources).   A  complete  copy  of  the FERMILIB object
     library and its Help file are included.


                                                                          Page 2


     [.PMU]


          This area includes a set of routines to  implement  post  mortems
     for  detached processes.  This is done via condition handlers to catch
     a severe (fatal) signal  and  produce  the  appropriate  dumps.   Post
     mortems  are meant to provide a means to locate infrequently occurring
     bugs in otherwise operational software.


     [.STARTUP]


          The command procedures in this area illustrate the management  of
     logically  disjoint disk sets from a pool of disk drives shared by two
     or more processors.


     [.SYSMGR]


          The command procedures in this area illustrate the implementation
     of  a  set  of  cyclic  batch  jobs  which  repeat nightly, weekly and
     monthly.


     [.UTILITIES]


          This area contains two small utility programs.  The  source  (VAX
     C),  build  and executable image files are included.  Documentation is
     included as comments in the source files.


          The GETREMUSR program is used to limit DECnet access  to  turnkey
     accounts  which  have  no  password  and are controlled by their login
     procedures to limit the  actions  a  user  may  take.   The  GETREMUSR
     program  returns  the  remote  user  name and DECnet node name when an
     account is being accessed via a network command terminal (SET HOST  at
     the  remote  end).  The values are returned in local DCL symbols.  The
     login procedure may then test these values  to  limit  access  to  the
     account.


          The TSTUSRPAR  program  allows  the  value  of  the  one  of  the
     site-specific SYSGEN parameters (USERD1, USERD2, USER3 or USER4) to be
     returned in local DCL symbols.  On  the  Fermilab  Accelerator  VAXen,
     USER4 is used to disable normal timesharing during a startup.  Many of
     the site-specific actions and defintions done by  the  normal  startup
     are  skipped  and  the  interactive  login  count is set to 0 by using
     TSTUSRPAR to test the  USER4  parameter  near  the  beginning  of  the
     SYSTARTUP.COM file.  This permits the system to be booted for software
     upgrades or other standalone  work  without  modifying  the  extensive
     startup  procedures  each  time.   In  addition,  by  using  a  SYSGEN
     parameter, a standalone startup can be made even after the system  has
     been  shutdown by using a conversational boot and setting USER4 (to 1)
     in SYSBOOT.