**** ACCOUNT.TXT ****

   This is a description of how to implement the Air Force Weapons Laboratory
accounting package for all VAX11/780 computers with the following restriction,
the computer MUST be using VMS V2.0 or higher and have the disk quota system
implemented. 

   It is suggested that the System Manager create a sub-directory under
[SYSMGR] called [SYSMGR.ACCOUNT].  This directory will be where all the
executables and command files should remain.  There is a symbol defined in all
the command files which is called <BASE_DIR> which should be defined as the
location of the command and executable files.  After loading all the required
files on whatever directory is required, the user may then execute a command
proceedure called COMPILE.COM.  This proceedure will compile and link all the
required Fortran and Macro programs. This procedure will also create the
required sub-directories if you wish it to. 
   
   Being a government installation, all of our accounting packages run on the
fiscal year and not the calender year.  Minor changes will be required to
ACCTFY81.COM and ACCT04APR.COM if you wish to use calendar limits.  If you wish
to stay with fiscal year bounds, then the next required step is to generate a
sub-directory of [SYSMGR.ACCOUNT] where you wish the data for the current year
to be stored in.  We create a sub-directory called [SYSMGR.ACCOUNT.FY81] as an
example. This sub-directory must be defined in all the command files as the
symbol <DATA_DIR>.  This directory will be opened automatically by COMPILE.COM
if the user answers Y to the open directory prompt. 

   The following is a list of all the required Fortran, Macro and command files
required to successfully implement and utilize this package: 

	ACCT04APR.COM	==>	Sample command file used to generate
				users charges for any one month. Also
				averages the daily disk usage files.
	ACCTFY81.COM	==>	Sample command file used to generate
				the current fiscal year totals of all
				computer resources. This file also
				averages all the monthly averaged disk
				usage files.
	ACCTINFO.FOR	==>	This file is the source to break down
				and use the VAX internal accounting
				file.
	CLOSEACT.COM	==>	Command file run daily at midnite which
				closes the existing accounting data file,
				appends it to the master file, runs the
				disk usage utility and then resubmits
				itself to run the next day at midnite.
	COMPILE.COM	==>	This file compiles, links and lists all
				the Fortran and Macro files.
	DISKSPACE.COM	==>	This file determines the amount of disk
				space presently allocated to each user.
				NOTE:  The System Manager must supply
				the proper disk id for the file being
				generated.  If a multiple disk system
				is in use, minor changes must be made
				to ensure that all the drives are 
				checked and the results totaled. The
				change would be to do multiple USE disk_id
				and SHOWs out of the DISKQUOTA utility.
	DSKAVERGE.FOR	==>	This file is used to average the disk
				usage for an approximate picture of the
				use of your system.
	QUADMATH.MAR	==>	This file is linked with ACCTINFO.FOR.
	VAXUSE.CMM	==>	Common blocks used by VAXUSE.FOR
	VAXUSE.FOR	==>	This file generates the actual user
				charges.  Charges may be balanced by
				the individuals site by adjusting the
				charging factors within the code.

   This is an updated version of the accounting packages released in the Fall,
1980 VAX DECUS tape.  The new version allows a more precise picture of computer
resource usage as it is now run daily instead of weekly.  The command files
have been cleaned up and are also much easier to use and run. To implement this
code, execute the command proceedure COMPILE.COM to generate all the
executables and the required sub-directories.  Then submit CLOSEACT.COM to your
batch queue.  Locally, we have generated a batch queue called SYSTEM that only
runs system's jobs.  Once run the first time, the command procedure will
resubmit itself to run again the next day at midnite on queue SYSTEM. 

   ACCTINFO, QUADMATH and VAXUSE were obtained originally from the Fall, 1979
DECUS VAX tape.  These programs were then modified to allow their use in an
easier method thru a command file.  Disk space accounting was then automated
thru DISKSPACE.COM.  If you have any questions or problems, please contact me
directly: 

	Richard A. Olds
	Air Force Weapons Lab
	AFWL/ARLB
	Kirtland AFB, NM 87117
	(505) 844-7497

************* end of text ******************