Invoking the ADVISE CHARGE_BACK REPORT Command

Using Accounting Chargeback › Invoking the ADVISE CHARGE_BACK REPORT Command

Invoking the ADVISE CHARGE_BACK REPORT Command

To generate a resource use report, enter a command of the form:

ADVISE CHARGE_BACK REPORT /qualifier[/...] account-file-spec[,...] - 
[price-file-spec] -
[disk-usage-file-spec]

This command accepts three parameters:

Account file-spec: The name of the files containing accounting data. The account-file-spec is a required parameter that specifies the name of the file containing accounting data from the OpenVMS Accounting Utility. You can specify one or more accounting files.
Price-file-spec: The name of the chosen price file containing resource prices and report details. The price-file-spec specifies the name of the file that contains charges for each billable resource.
Disk-usage-file-spec: The name of the file containing disk use information. The disk-usage-file-spec specifies the name of a file containing disk use information from the OpenVMS Analyze/Disk_Structure Utility. Run this utility for each disk on which you want to report charges. Append the resulting output files to form one disk use file. This parameter is optional and need only be present for disk use reporting.

You can generate a report for a month, a week, or any period that you choose. Use the /ENDING and /BEGINNING qualifiers to specify the period of time for which charges are reported. See Chapter 2, “Accounting Chargeback Commands,” for a description of all the command qualifiers.

The following command generates a report, CHARGE.RPT, for the accounting data in ACCOUNT.DAT. Resource prices and report details are read from the price file ACCHARGE.TXT.

$ ADVISE CHARGE_BACK REPORT ACCOUNT.DAT ACCHARGE.TXT

The following command generates a report, ACCOUNT.CHG, from the accounting data file ACCOUNT.DAT and the price file ACCHARGE.TXT. Because /DETAILS is given without any keywords, default details of GRAND, ACCOUNTS, and USERS are reported.

$ ADVISE CHARGE_BACK REPORT/DETAILS/OUTPUT=ACCOUNT.CHG - 
_$ ACCOUNT.DAT ACCHARGE.TXT

Entering the following command assumes that resource prices are defined for the categories GREEN and YELLOW in the price file CHARGE.DAT:

$ ADVISE CHARGE_BACK REPORT ACCT1.DAT/CATEGORY=GREEN,ACCT2.DAT -
_$ /CATEGORY=YELLOW,ACCT3.DAT CHARGE.DAT DISK.DAT

The preceding command string indicates:

Resource prices associated with the category GREEN are applied to the accounting file ACCT1.DAT.
Resource prices associated with category YELLOW are applied to the accounting file ACCT2.DAT.
Resources prices specified without categories in CHARGE.DAT are applied to the accounting file ACCT3.DAT. If there are no such resource prices, a price of zero is applied to all resources in ACCT3.DAT.
The disk volume names in CHARGE.DAT have disk use information in the disk use file DISK.DAT.

Most of the error conditions that can occur when you generate a report are reported by standard error messages.