Produces a summary report of the selected records.
Format
/SUMMARY[=(summary_item[,...])]
1 – Keyword
summary_item[,...]
Specifies the summary key. The following table lists keywords:
Keyword Description
ACCOUNT Account
DATE Date
DAY Day of month (1-31)
HOUR Hour of day (0-23)
IMAGE Image name (file name portion of image file
specification)
JOB Name of print or batch job
MONTH Month of year (1-12)
NODE Name of the node that issued the DECnet for OpenVMS
request
PROCESS Process type
QUEUE Print or batch job queue name
TERMINAL Terminal name
TYPE Record type
UIC User identification code
USER User name
WEEKDAY Day of week (0=Sunday, 1=Monday, and so on)
YEAR Year
If you omit these keywords, the user name is used as the summary
key.
2 – Description
The /SUMMARY qualifier produces a summary report of the selected
records. The report is directed to the current SYS$OUTPUT device,
unless you use the /OUTPUT qualifier to write it to a file.
Summary reports give statistical summaries of the resources
specified by the /REPORT qualifier for each value of the summary
key specified by the /SUMMARY qualifier. If you omit the /REPORT
qualifier, the summary report gives the total number of records
processed for each summary key value.
The first line of the summary report shows the time span of the
data processed (when the first and last records processed were
logged in the input files), with a title in the middle. You can
use the /TITLE qualifier to specify your own title.
The next few lines of the report are column headings. There
is one column for each summary_item, then one column for each
resource specified by the /REPORT qualifier. The columns are laid
out in the same left-to-right sequence as the equivalent keywords
in the /SUMMARY and /REPORT qualifiers.
The rest of the report uses one line for each summary key value.
It gives a summary of the resources associated with that summary
key value. The data is sorted in ascending order of the summary
key value.
See also the /BINARY qualifier, which copies the selected records
to a file, and the /BRIEF and /FULL qualifiers, which produce
brief and full reports of the selected records.
You cannot use the /SUMMARY qualifier with the /BINARY, /BRIEF,
or /FULL qualifiers.
3 – Examples
1.$ ACCOUNTING /TYPE=PRINT /SUMMARY=USER /REPORT=(PAGES,RECORDS)
This example processes the file SYS$MANAGER:ACCOUNTNG.DAT.
It processes all the print job records and produces a summary
report that shows, for each user, the total number of pages
printed and the number of records that were added together to
produce this total. This is an example of the report that is
produced:
From: 12-JAN-2000 15:55 VAX/VMS Accounting Report To: 15-JAN-2000 15:17
Username Pages Total
Printed Records
-------------------------------
BROWN 115 2
CROW 3 1
CUTHBERT 20 4
FOSTER 46 1
SMITH 50 3
WHITE 50 7
2.$ ACCOUNTING /SUMMARY=IMAGE /REPORT=(PROCESSOR,RECORDS)
This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It
produces a summary report that shows the total CPU time used by
each image. This is an example of the report that is produced:
From: 12-JAN-2000 15:55 VAX/VMS Accounting Report To: 15-JAN-2000 15:17
Image name Processor Total
Time Records
-------------------------------------
0 00:09:09.83 51
ACC 0 00:01:36.72 99
AUTHORIZE 0 00:00:04.17 8
CDU 0 00:00:33.25 21
COPY 0 00:00:05.97 30
DELETE 0 00:00:02.79 12
DIRECTORY 0 00:00:09.67 38
DUMP 0 00:00:04.51 3
EDT 0 00:00:05.85 7
LOGINOUT 0 00:04:03.48 75
NETSERVER 0 00:00:00.63 23
SHOW 0 00:00:04.80 22