1 Charges
	The current interactive session charges can be displayed
	with the command

		$ CHARGES

	The qualifier /RATES appends the current rate table.
	/NOSESSION suppresses the session listing.

	A description of how the charge back system operates can
	be viewed via $ HELP CHARGES DOCUMENTATION_SUMMARY.

2 ReportDisk
	Your current disk usage data can be updated in the system
	accounting data base by the command

		$ ReportDisk [/DISK=dduu:] [/[NO]LOG] [/USER=username]

	The qualifier /NOLOG will turn off the statistics display.

	/DISK=dduu: reports your use on disk dduu:.  dduu can be
	a logical name pointing to a root directory on the device.
	Dduu: defaults to SYS$LOGIN:

	Priveleged users can generate disk reports for other users
	via /USER=username.

2 Rates_Processing
	The routine Rates processes a suitably sorted binary accounting
	file dump.  For the appropriate accounting utility command to
	generate this file see the help item below.  The command line
	for rates is

		$ RATES sortedbinaryaccountingdump [/qualifiers....]

3 /OUTPUT
	/OUTPUT=outputfilespec

	Outputfilespec defaults to sys$output.

3 /TITLE
	/TITLE="title text"

	Title text is a quoted string to be output at the top of
	each summary (user/account/grandtotal).

3 /RATETABLES
	/[NO]RATETABLES

	Causes a rate table to be appended at the bottom of each
	user and/or account summary.  The rate table always appears
	at the bottom of the grandtotal summary.

3 /PAGENATE
	/[NO]PAGENATE

	The default action outputs a formfeed before each user and
	account summary and before the grandtotal.

3 /USER_TOTALS
	/NOUSER_TOTALS

	The default action outputs a summary for each user.
	
3 /ACCOUNT_TOTALS
	/NOACCOUNT_TOTALS

	The default action outputs a summary for each account.
	
3 /GRANDTOTAL
	/NOGRANDTOTAL

	The default action outputs a final page with a grandtotal
	of resource usage and charges.

3 /DISKS
	/NODISKS

	The default action includes disk accounting statistics in
	the tallies of charges and displays disk statistics as part
	of the output.

3 Generating_A_Sorted_Binary_Accounting_Dump
	The input file for the Rates routine can be generated with the
	following command line plus other qualifiers as appropriate.

		$ ACCOUNTING accountngfile /BINARY -
			/OUTPUT=binarydumpfile -
			/BEFORE=dd-mmm-yyyy [hh:mm:ss] -
			/SINCE=dd-mmm-yyyy  [hh:mm:ss] -
			/SORT=(ACCOUNT,USER,FINISH) -
			/TYPE=-LOGFAIL

2 Documentation_Summary
	The system accounting manager has facilities for keeping
	track of such items as cputime, elapsed time, page faults
	and a variety of other resources excluding disk usage. It
	provides a number of options for dumping its data but does
	not support charge back facilities.

	Our charge back system consists of a set of routines
	written by Mitch Nelson at SBCH1.  A few of the subroutines
	were obtained from previous Decus tapes.  The routines act
	in cooperation with the system accounting manager and job
	controller to provide disk accounting, a billing routine
	and a user facility for viewing the current session charges
	and rate table.  All of the routines and associated command
	procedures are located in a directory referenced by the
	logical name mcn$accounting.

	The billing routine interprets a sorted binary dump of the
	system accounting file, accumulates the relevant statistics
	and applies the rate table, as of the last compilation and
	link, to calculate charges. Output can include any or all
	of user, account, and system wide totals of the accumulated
	statistics and charges.  The command file run_rates.com
	generates a full pagenated listing with subtotals by user
	and account group.

	Disk accounting is accomplished by a routine which obtains
	disk usage information from the diskquota data base and then
	sends a message containing the disk quota information to the
	system job controller for forwarding to the system accounting
	manager. It is entered as a user message in the system accounting
	data base and automatically stamped with the user's name, account,
	uic and time.  Currently this routine is run each time a user 
	logs in and on the behalf of all users at the end of each billing
	period.  The command file assay_disk.com, when executed by a
	priveleged user, generates disk accounting records for all users
	having directories on sys$user. It was run once at the outset
	to establish initial values for each user.

	The command procedure yearly.com submits itself for execution at
	the end of the current calendar year (i.e. 1-JAN-nnnn+1 00:00).
	It then runs assay_disk.com, starts a new system accounting file,
	runs another disk assay, renames the old system accounting file
	to accountng.nnnn, where nnnn is the year just ended, and resubmits
	itself, again for execution after the end of the current year.

	The command $ CHARGES, is established in the system login file
	to run a routine which displays current cpu time, elapsed time
	and charges for the current interactive process. The qualifier
	/RATES outputs the complete interactive, batch, print and disk
	rate schedule.  The qualifier /nosession turns off the session
	statistics portion of the output.  At the moment it does not
	properly support the session facility from batch mode.

	The complete rate schedule can be viewed by the command

		$ charges/rates/nosession

	The rates in total are calculated to just cover our operating
	expenses (excluding salaries and system upgrades such as
	networking, language processors, word processing).

