1 02/27/85 reset_use_totals
 2 
 3 Syntax as a command:  reset_use_totals use_totals control
 4 
 5 
 6 Function:  clears all totals in a month-to-date statistics data base at
 7 the end of a billing period and reloads the list of reporting
 8 categories.
 9 
10 
11 Arguments:
12 use_totals
13    is the pathname of the statistical data base.
14 control
15    is an ASCII file that classifies projects into reporting categories.
16 
17 
18 Notes:  Each line in the control file is of the form shown below.
19 
20       Project_id, reporting category
21 
22 All projects in the same reporting category are classified together in
23 the data base by the usage_total program.  Lines beginning with "*" are
24 ignored.
25 
26 The last control line in the file must be of the form as shown below.
27 
28       other, category title
29 
30 to provide for the classification of all other projects.  Up to 3258
31 individual projects (in addition to the "other" control line) and 300
32 category titles may be specified.
33 
34 
35 This command is executed by biller.ec with the arguments as shown
36 below.
37 
38       today.use_totals daily_report.control
39 
40 after a copy of the use_totals segment (containing statistics for the
41 month just ending) has been saved for historical purposes.  This
42 command initializes the today.use_totals segment to begin collecting
43 statistics for the next month.  This is the only time during the month
44 when the classification of projects into reporting categories may be
45 changed.  The pathname of the control segment, describing the
46 classification, must be given, even if the classification is not
47 changing.
48 
49 
50 If multiple rate structures are defined at the site, it is recommended
51 that a separate category (or group of categories) be used for the
52 projects in each rate structure (i.e., that projects of different rate
53 structures not be placed in the same category).  The rate structure of
54 the first project in each category (in the control file) is used for
55 computing usage statistics for all projects in that category.
56 
57 If the use_totals segment does not exist, it is created.  This segment
58 is updated by the system_total and usage_total commands and is input to
59 the system_daily_report and system_monthly_report commands.