The IMS Interface › Executing the Wizard Report Writer › Control Statements › RATE Statement

RATE Statement

The RATE statement, identified by the statement type RATE, is optional. It provides a mechanism by which you may introduce an accounting algorithm to the Wizard Report Writer for computer billing or cost distribution purposes.

The RATE statement weights computer resources when calculating the dollar charges or relative utilization percentages for a given report. It may be omitted when no data elements involving charges or percentages are selected for any report.

The CPU identification code associates each RATE statement with the appropriate data. Multiple RATE statements may be required for a report so that data collected from different systems (or assigned CPU IDs by the grouping feature) may be processed simultaneously, each using a different accounting algorithm. The CPU identification on the RATE statement must match the corresponding CPU identification in the records for the algorithm to apply. If an accounting record that contains a CPU identification other than one found on any RATE statement for a report is encountered, then the accounting algorithm parameters default to the values on the first RATE statement defined for that report.

The basic processor rate field is the dollar amount per minute of processor time.

The CPU time factor field on the RATE statement enables you to weight the recorded time in calculating the processor time in minutes as follows:

Processor Time = Application CPU Time x Application CPU
                 Time Factor

The CPU time factor field is a percentage, (that is, 080 = 80%). Therefore, it is possible to calculate the processor time using the straight or unweighted CPU time by setting the CPU time factor to 100 (100%).

The processor time and processor rate as you define them are used to calculate the processor charge for each program as follows:

Processor Charge = Processor Time x Processor Rate.

The file I/O rates on the RATE statement enable you to charge for database accesses, and for message queue get and insert operations. The file I/O charge for each transaction is calculated as follows:

File I/O Charge = (Message Queue Gets x
                    Message Queue Get Rate      +
                  Message Queue Inserts x
                    Message Queue Insert Rate   +
                  Total DL/I I/O Count x
                    DL/I Rate)                  / 1000.

The processor charge for a transaction combined with the file I/O charge forms the transaction charge:

Transaction Charge = Processor Charge + File I/O Charges

The minimum transaction charge on the RATE statement is applied if it is greater than the computed transaction charge described above.