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
     a README.1ST  file  which  provides  additional  details;   this  file
     provides an overview of the entire submission.




     [.ARGUS]


          This area contains the Argus program executed as a subprocess  to
     watch  for  and  delete idle processes.  This is a major rewrite of an
     earlier version submitted on the Spring 1983 tape.   The  program  has
     been  made  considerably  easier  to customize for a site's particular
     needs.


     [.ENDTAPE]


          The  ENDTAPE  program  will  fix  the  file   structure   on   an
     ANSI-|standard tape.  The program was written to repair tapes in which
     the last file on the tape is incomplete (no end labels) because  of  a
     failure  of  the program writing the tape.  The user tells the program
     the name of the last good file on the tape.  The program searches down
     the   tape   for  this  file  and  places  the  end-|of-|volume  label
     immediately after the end of file label for this last good file  (thus
     eliminating the bad partial file).


     [.GETQUOTA]


          The  GETQUOTA  program  is  DCL  command  to  return  disk  quota
     information  in  DCL  symbols.   It can return permanent and overdraft
     quota and current disk usage for the current user or for  a  specified
     UIC.  It replaces long command procedures which run DISKQUOTA and then
                                                                          Page 2


     extract the information from the DISKQUOTA printout.


     [.GETUAF]


          This  program  extracts  information   from   the   system   User
     Authorization File (UAF) and returns the information in DCL symbols.


     [.HELP]


          This area contains several files  suitable  for  creation  of  or
     inclusion  in  help  libraries.   These  include  notes useful for the
     system manager and help on the usage  of  the  command  procedures  in
     SYS$UPDATE:.


     [.LIBRARY]


          This area contains object, macro and text libraries which provide
     extensions  to  the  system  libraries  in  SYS$LIBRARY:.  Most of the
     programs in the remainder of the submission make use of one or more of
     these  libraries.   The  sources for the macros and object modules are
     included in subdirectories.


     [.MAKEINCS]


          The command procedures  in  this  area  are  useful  in  creating
     include  files  for  FORTRAN,  C  and PASCAL from macro definitions or
     FORTRAN include files.  These procedures were used to prepare many  of
     the modules in the text libraries in the [.LIBRARY] area.


     [.OPERATOR]


          The command procedures in this area illustrate the implementation
     of  a  turnkey  OPERATOR account at Fermilab.  This account is used to
     provide  open  shop  access  to  privileged   system   functions   for
     non-|privileged  users  and  to  provide support for utility functions
     such as the normal disk  backups  by  the  technicians  without  their
     having to type in long and elaborate commands.


     [.PROCCNTRL]


          These programs provide for additional process  control  commands.
     The RESUME and SUSPEND programs have been (somewhat) superceded by the
     /RESUME and /SUSPEND qualifiers of the  SET  PROCESS  command.   Other
     commands  provide  a  means  to  force  a process to exit (via $FORCEX
     rather than directly deleting it with STOP) or to wake  a  hibernating
                                                                          Page 3


     process.


     [.SETUSER]


          The SETUSER program is a foreign DCL command which permits a user
     with  CMKRNL  privilege  to change his UIC, username and account name.
     This is very useful in submitting batch jobs to  be  run  under  other
     user's accounts.


     [.SYSMGR]


          This area contains several command procedures  useful  to  system
     managers.


     [.TIME]


          The TIME program is a foreign DCL command  used  to  manipulation
     time  and  date  information  and  return  the results in DCL symbols.
     Amoung its capabilities are the calculation of an absolute  time  from
     an  absolute  time  and  a  delta time, the comparison of two absolute
     times and several other useful time operations.


     [.UAC]


          The User Access Checker program is a combination of LOGINOUT  and
     AUTHORIZE  to  permit  a  turnkey account to include a second level of
     security or to establish a set of "subaccounts" under a single turnkey
     account.


     [.USS]


          The  FERMIUSS  protected   shareable   image   contains   several
     general-|purpose user-|written system services in use at Fermilab.


     [.UTILPROCS]


          This area contains several command procedures of general use.