1 02/28/85 usage_and_revenue
 2 
 3 Syntax as a command:  usage_and_revenue control data {old_data}
 4 
 5 
 6 Function:  prints out a report of system usage and revenue broken down
 7 by groups of users.
 8 
 9 The following lines must be added to master.ec and biller.ec before
10 this command can be invoked.  To master.ec add
11 
12       file_output usage_and_revenue.report
13       usage_and_revenue usage_and_revenue.control today.use_totals
14          yesterday.use_totals
15       console_output
16 
17 
18 To biller.ec add
19 
20       file_output monthly_usage_and_revenue.report
21       usage_and_revenue usage_and_revenue.control today.use_totals
22       console_output
23 
24 
25 
26 Arguments:
27 control
28    is the pathname of an ASCII file that defines the groups of users
29    for the report.
30 data
31    is the pathname of a copy of the system use_totals month-to-date
32    statistical data base.
33 old_data
34    is the pathname of an earlier copy of the system use_totals
35    month-to-date statistical data base.
36 
37 
38 Notes:  If both the data and old_data arguments are given, a daily
39 report is produced showing the incremental system usage between the
40 time old_data was created and the time data was created.  If only the
41 data argument is given, a monthly report is produced showing the
42 month-to-date usage at the time data was created.
43 
44 The control file may specify up to nine groups of users to be shown in
45 the report.  Each line of the control file specifies one group; each
46 group consists of one or more of the usage bins from the use_totals
47 data base.  The format of a control file line is
48 
49       Group title:user1,user2,...,userN
50 
51 Lines beginning with an asterisk (*) are ignored.  The groups appear in
52 the report in the same order in which they appear in the control file.
53 
54 
55 List of arguments:
56 group title
57    is the title used to identify the group in the report.  The maximum
58    length is 24 (spaces are allowed).
59 useri
60    are the names of the usage bins in the use_totals data base that are
61    to be included in this group.  These are the names specified in the
62    control file for reset_use_totals.  If useri is enclosed in quotes,
63    it specifies a group that is already defined in the control file and
64    all the bins that go into that group also go into this group.