Spring 1986 DECUS Distribution
			Software Tools

This Software Tools distribution off the Spring 1996 L&T SIG tape
got very limited distribution. It is presented here to make it
more widely available. This is a pretty complete unix like shell
for VMS and utility set that goes with it, mostly written in
portable RATFOR (a Fortran preprocessor dialect that somewhat
resembles C).


The  following  steps  must  be  performed  to  build  the Spring 1986
release of the Software Tools package for VMS. 

 1. Edit the file  stlognam.com  in  this  distribution  directory  to
    reflect  the  disk  and directories used by the tools.  All of the
    tools logical names start with the string "st_", in an attempt  to
    avoid  conflicts  with  all  other  software.   The definition for
    st_node should be replaced with your node  name,  and  st_timezone
    should   be   replaced   with   the  appropriate  three  character
    mnemonic.  Do not worry, the software which uses the logical  name
    worries  about  whether it is daylight-savings time or not, so you
    won't have to worry about changing the  logical  name  each  April
    and October. 
    
 2. Invoke the modified stlognam.com to set up the environment
    
 3. Create  the  six  known  directories (~bin, ~usr, ~tmp, ~lpr, ~msg
    and ~man) with the appropriate  protection,  and  set  default  to
    st_bin.   Consult  release.doc  for  information  on  the required
    protection modes for the directories. 
    
 4. Copy the Distn directory files into the current  directory,  after
    deleting  all  files  currently  in the directory.  Make sure that
    the account under which you are running has the following quotas:

         PRCLM          10
         BYTLM       30000
         FILLM          75
         TQELM          40
         PGFLQUOTA   16384

    
 5. @toolgen
    This command file assembles all  macro  primitives,  compiles  all
    fortran  primitives,  builds two tools to bootstrap ourselves, and
    then proceeds to build the 115 utilities  in  the  package.   This
    takes  a  few hours, so take a break.  If you answer yes to any of
    the  questions  concerning  file  deletion,  toolgen  will  delete
    unneeded  files  as  the processing progresses.  If you delete the
    object files, a savings of  ~2000  disk  blocks  ensues.   If  you
    delete  the  source  files  as  you  progress,  a savings of ~3700
    blocks accrues.  If a shared global image  is  NOT  selected,  the
    entire  system  occupies ~22000 blocks if no files are deleted, or
    ~16000 blocks if both sources and objects are deleted  during  the
    build.   On  the  other  hand,  by building with the shared global
    image,  the  corresponding   numbers   are   ~12000   and   ~6000,
    respectively. 
    
 6. Now  modify  the  system  startup  files  to setup the new logical
    names and installed images for the next boot. 


                                 -1-



                    Spring 1986 DECUS Distribution


    
 7. Install the known images using st_bin:tools.ins
    
 8. The required quotas have not changed  with  this  release,  so  no
    mucking  with  the  authorization  file  will be necessary, unless
    this is your first tools release.  If this is  the  case,  consult
    the file release.doc in the distn directory. 
    
 9. To  build  the  appropriate  mail  system  utilities,  you need to
    consult the file msgreadme.1st in  the  msgsys  directory;  follow
    the directions there. 
    
10. You should now be operational. 




                                                  Software       Tools
Users Group 140 Center Street El Segundo, CA   90245

(213) 322-2574































                                 -2-