 
 
 
%      [VAXF84.FERMILAB]AAAREADME.TXT
  
 
A                 Fermilab Accelerator Control System Submissions
  
 
0                                  submitted by:
 
 
2                                Dr. Frank J. Nagy
<                      Fermi National Accelerator Laboratory
A                 P. O. Box 500 Mail Stop 306, Batavia, IL. 60510
 1                                  (312)-840-4935
  
 
 
M           This directory tree is a submission from the Fermilab Accelerator
 M      Division.   The programs and command procedures in this directory tree
 M      are general utilities and system management utilities  either  written
 M      at  Fermilab  or  acquired  from  DECUS  (via  a  SIG tape or from the
 M      library) and modified.  In many cases the  software  can  be  used  at
 M      other  sites  without  modification;   some  of  the system management
 M      utilities are included as starting points from which sites can produce
 M      their custom versions.  Each of the next-level subdirectories includes
 M      an AAAREADME.TXT file which provides additional  details;   this  file
 5      provides an overview of the entire submission.
  
 
M           This submission represents  files  added  or  changed  since  the
 M      Spring  1984 submission.  A complete resubmission has not been made of
 M      many of the files to help reduce the size of the SIG  tape.   To  make
 M      full  use  of  much  of the material in this submission, you must have
 M      access to the Spring 1984 SIG tape Fermilab  submissions.   Access  to
 M      the  Fermilab  Accelerator  Division  submissions on earlier tapes may
       also be helpful.
  
 
M           Questions and comments on these submissions may  be  directed  to
 M      the  submitter  listed  above.   Fermilab will not provide support for
 M      this software on anything other than an informal basis as time allows.
  
 
 
      [.LIBRARY]
  
 
M           This area contains object, macro and text libraries which provide
 M      extensions  to  the  system libraries in SYS$LIBRARY:.  The sources of
 M      new and changed routines are included (see Spring 1984  SIG  tape  for
 M      the  remaining  sources).   A  complete  copy  of  the FERMILIB object
 .      library and its Help file are included.
 
 
S                                                                           Page 2
  
 

      [.PMU]
  
 
M           This area includes a set of routines to  implement  post  mortems
 M      for  detached processes.  This is done via condition handlers to catch
 M      a severe (fatal) signal  and  produce  the  appropriate  dumps.   Post
 M      mortems  are meant to provide a means to locate infrequently occurring
 .      bugs in otherwise operational software.
 
 
      [.STARTUP]
  
 
M           The command procedures in this area illustrate the management  of
 M      logically  disjoint disk sets from a pool of disk drives shared by two
       or more processors.
 
 
      [.SYSMGR]
 
 
M           The command procedures in this area illustrate the implementation
 M      of  a  set  of  cyclic  batch  jobs  which  repeat nightly, weekly and
       monthly.
  
 
      [.UTILITIES]
  
 
M           This area contains two small utility programs.  The  source  (VAX
 M      C),  build  and executable image files are included.  Documentation is
 0      included as comments in the source files.
 
 
M           The GETREMUSR program is used to limit DECnet access  to  turnkey
 M      accounts  which  have  no  password  and are controlled by their login
 M      procedures to limit the  actions  a  user  may  take.   The  GETREMUSR
 M      program  returns  the  remote  user  name and DECnet node name when an
 M      account is being accessed via a network command terminal (SET HOST  at
 M      the  remote  end).  The values are returned in local DCL symbols.  The
 M      login procedure may then test these values  to  limit  access  to  the
       account.
  
 
M           The TSTUSRPAR  program  allows  the  value  of  the  one  of  the
 M      site-specific SYSGEN parameters (USERD1, USERD2, USER3 or USER4) to be
 M      returned in local DCL symbols.  On  the  Fermilab  Accelerator  VAXen,
 M      USER4 is used to disable normal timesharing during a startup.  Many of
 M      the site-specific actions and defintions done by  the  normal  startup
 M      are  skipped  and  the  interactive  login  count is set to 0 by using
 M      TSTUSRPAR to test the  USER4  parameter  near  the  beginning  of  the
 M      SYSTARTUP.COM file.  This permits the system to be booted for software
 M      upgrades or other standalone  work  without  modifying  the  extensive
 M      startup  procedures  each  time.   In  addition,  by  using  a  SYSGEN
 M      parameter, a standalone startup can be made even after the system  has
 M      been  shutdown by using a conversational boot and setting USER4 (to 1)
       in SYSBOOT.
