.lm 0 .rm 60 .sp 1 .ts 5
.r;May 18, 1983
.sk 1
.i5;QUOTA is a program designed to take binary DSKCHG (disk charging)
USER accounting records and produce a listing of the disk usage.
.sk 2
^&INPUT\&
.sk 1 .i5;The accounting records are produced using the system program
ACCOUNTING.  The following command will take all the USER records
from the current accounting file (SYS$MANAGER:ACCOUNTNG.DAT)
and place them in a file called "USER.BIN".
.lm 15 .ts 15
.sk 1 .i-10;$#accounting -
.br;	/binary -
.br;	/log -
.br;	/type=(user) -
.br;	/output=user.bin
.lm 0 .ts 5 .sk 1
.i5;If it is common for USER records other then from
DSKCHG to be placed in the accounting file then additional
qualifiers may be necessary (such as "/account=").
.i5;The actual input for QUOTA is read from the logical
name QUOTA$INPUT.  If the above ACCOUNTING command had been
issued producing the file USER.BIN then the following would
make the assignment for input:
.sk 1 .i10;$#assign user.bin quota$input
.sk 2
^&OUTPUT\&
.sk 1
.i5;A listing of the disk usage is written to the logical
name QUOTA$OUTPUT:.  This will include: a line number, account,
user name, disk usage, and allocation.  This is not all 
the information that is contained in the DSKCHG accounting
record, additional information includes: time DSKCHG ran,
UIC, and device on which billing occured.  (Of course
the system attaches an ID header on all accounting entries
so that the process information can also be determined.)
The disk usage and allocation units are in disk block days.
Unfortunatly a shortfall of the program is that it does not
sum usages and allocations for records with the same account.
.i5;Error output from QUOTA is written to SYS$OUTPUT.
.sk 2
^&SITE DEPENDENT CHANGES\&
.sk 1
.i5;In the subroutine FUBUFF (FUBUFF.FOR) a parameter STFGRP is defined which
is the group number of the account from which DSKCHG is run.  If
a USER record is passed to FUBUFF which has a process group number greater
then 10(8) and not equal to STFGRP this record is considered bad.
After deciding from which account DSKCHG is going to be run,
the parameter STFGRP should be set to the group number for this
account.  (Keep in mind that everyone in this group can enter
records that look like DSKCHG records and have them accepted as
good.)
.sk 2
^&COMPILING AND LINKING\&
.sk 1
.i5;A command file QUOTABLD.COM will compile and link the 
QUOTA program.
.sk 2
^&COMMENTS\&
.sk 1
Please direct your comments or inquires to:
.sk 2 .lm 15
Thomas J. Linscomb
.br;Computation Center
.br;The University of Texas at Austin
.br;Austin, TX 78712
.sk1;PHONE:##(512) 471-3241