[VAXS83.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  new  Accelerator  Control  System  (called  ACNET for
     "Accelerator  Control  Network")   contains   two   VAX-11/780's   and
     (currently)  17  PDP-11/34's.   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 possibly 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 a README.1ST file  which  provides  additional
     details;  this file provides an overview of the entire submission.



     [.DOCUMENTS]


          This area contains  several  documents  of  general  interest  in
     RUNOFF  form.   Included  are  articles submitted to "The Multitasker"
     and/or "Pageswapper" on RSX-11M V4.0 SYSGEN's under VMS and  usage  of
     RSX-11M BRU on the VAX.


     [.FERMIEXE]


          This area is copied from the [FERMIEXE] directory on  our  system
     disk.   We  use the FERMI$EXE:  logical name to reference this area in
     which we store locally-written  utility  procedures  and  programs  of
     general use.  Some of these procedures were originally gotten from VAX
     SIG tapes but have been "improved" somewhat.  Similar comments can  be
     made  about  some  of  the programs.  The sources for the programs are
     found in the [.SOURCES] subdirectory (or its subdirectories).


     [.FERMILIB]

                                                                          Page 2


          This area contains command procedures for manipulating libraries.
     The  package submitted to the DECUS library as VAX-38 is also included
     (allows a symbol definition macro to be converted to a FORTRAN INCLUDE
     file  of  PARAMETER's).  The [.DTR32] subdirectory contains files used
     to add several  user-written  functions  to  VAX-11  Datatrieve.   The
     [.INCLUDES]  subdirectory contains FORTRAN, PASCAL and C INCLUDE files
     used to construct the text libraries found in the [.SYSLIB] directory.
     The  [.SOURCES]  and  [.MACROS] subdirectories contain the sources for
     utility routines created as extensions of  the  VMS  Run-Time  Library
     (see  [.FERMILIB]README.1ST  for  details).   The  [.USS] subdirectory
     contains a (currently  undebugged)  user-written  system  service  for
     declaring  AST's in a separate process (i.e., process A can declare an
     AST in process B).


     [.MISC]


          This area contains some miscellaneous  stuff  including  template
     files for modules and subprogams written in FORTRAN, MACRO or C.


     [.SYSHLP]


          These help libraries contain additional information  to  the  VMS
     help library.  We reference FERMIHELP and RSXHELP with commands of the
     same name created by the system-wide login procedure.  Help on most of
     the   utilities   and   programs   in  [.FERMIEXE]  can  be  found  in
     FERMIHELP.HLB.  These libraries are stored in SYS$HELP:  at Fermilab.


     [.SYSLIB]


          These are the text libraries for VAX-11  FORTRAN,  VAX-11  PASCAL
     (which  doesn't  use  it)  and  VAX-11  C containing locally developed
     include modules.  Many of the include modules  were  constructed  from
     VMS  symbol  definition  macros  in  STARLET.MLB  or LIB.MLB using the
     procedures in [.FERMILIB].  Also included are our  general  macro  and
     object  libraries  (FERMILIB.*) which act as extensions of STARLET.MLB
     and VMSRTL.  At Fermilab, these files are found in SYS$LIBRARY:.


     [.SYSMGR]


          This  directory  tree  contains   many   procedures   and   other
     information  useful to system managers.  Many of the procedures can be
     used as provided;  some will require some modifications and others are
     useful only as examples of a particular individual's system management
     methodology.  See the README.1ST file for the extensive details.  Note
     that at Fermilab, the [.SYSMGR] area is SYS$MANAGER:.


     [.SYSUPD]
                                                                          Page 3


          This area contains the DYVMSUPD command  procedure.   This  is  a
     modification  of  the  VMSUPDATE  procedure  and  installs VMS layered
     software from DYA1:  (RX02) rather than  the  console  floppy  and  is
     considerably  faster.   These  were  copied from SYS$UPDATE:  for this
     submission.




          Most of the command procedures and  programs  are  documented  by
     header  comments in the source.  In most cases we have (automatically)
     stripped these comments into a help file which has been included  into
     a  help  library (either in SYS$HELP if public or SYSMGRHLP.HLB if for
     system management).