4. CUSTOMIZATION › 4.3 Specifying Rates › 4.3.1 Defining the Rate Table
4.3.1 Defining the Rate Table
The rate tables establish:
o Which journal files will be used for charging
o The types of accounting procedures that will be employed
o The computation codes and rates used to calculate the
charges
o The range of input data to which a specific calculation
will apply
There is one rate table for each CA MICS unit in which
Accounting and Chargeback is installed, including external
file units, and one for complex-level external files. This
section describes how to define a rate table for standard
CA MICS products, external files in external file units, and
field-developed applications. Rate tables for external files
at the complex level are described in Section 4.4.
A set of computation codes and rates is called a charging
algorithm. Charging algorithms must be defined for each
journal file to be used. As many charging algorithms as
needed may be defined for each journal file. If only one
algorithm is defined, it will be used to compute the charges
for all records in the file. If more than one algorithm is
defined, the records to which each applies must be
established. This is called algorithm qualification, because
each algorithm is qualified by the records to which it
applies.
When you select a journal file for the first time on the Rate
Table - Component and File Selection panel, a default (or
sample) rate table for that file is copied into your rate
table with all rates set to 0, and the journal file is marked
ACTIVE. This activates the journal file for charging when
the next MAGRUN job is run. However, the charges in the
journal file observations will all be zero unless rates are
changed to a non-zero value. If one or more rates for the
journal file are changed to a non-zero value, it will be
activated for charging by the next MAGRUN job, and journal
file records containing the specified rates will be produced
for invoicing.
When you change the specifications for a journal file, code
or modify a journal file exit, or add, delete, or modify a
charging algorithm or its qualification, you must modify the
Rate Table parameter.
Each computation code used in a Rate Table must be defined in
the table of default charging elements.
Figure 4-14 depicts the process to define the rate table.
RATE TABLE PROCESS
Unit Database Selection
|
Journal File Selection
|
Journal File Specifications
|
Journal File Exit Coding
|
Algorithm Specification
|
|
+-------------------------------------------------+
| Resource Direct Assignment Algorithms |
| Accounting and/or |
| Control Variable Algorithms |
| |
| Transaction Control Variable Algorithms |
| Accounting |
+-------------------------------------------------+
|
|
Algorithm Qualification
|
External Journal File Specifications
|
External Journal File Input Routine Coding
|
External Journal File Preprocessing Exit Coding
Figure 4-14. Rate Table Process
STEPS TO DEFINE THE RATE TABLE
Follow the steps in this checklist to define the rate table:
__ 1. Identify the CA MICS database units in which
Accounting and Chargeback is (or will be) installed.
It must be installed in each unit containing a CA MICS
analyzer or field-developed application you want to
charge for. In addition, if you are charging for
external files at the unit level, you must have a unit
with only Accounting and Chargeback installed in it.
__ 2. On the Rate Table Component and File Selection
Worksheet, Figure 4-15, mark an "S" next to each
journal file that you wish to use for charging in the
unit.
__ 3. Fill out the Journal File Specifications Worksheet,
Figure 4-17, for each journal file that you selected
for charging in the unit.
Journal file specifications are made for each journal
file for which charges will be computed. These
specifications determine the types of accounting
procedures that will be employed for all charges
derived from information in a single CA MICS analyzer
file. These procedures include zone (shift)
differential accounting, priority surcharging, and
journal prorating.
__ 4. Fill out the Rate Table - Direct Assignment Algorithm
Worksheet, Figure 4-21, for each resource accounting
journal file that you have selected in the unit. This
worksheet is sufficient if your algorithm is simple,
with only one rate and one computation code for each
charging element. If you want to use different rates
and/or computation codes for one or more charging
elements, you must also use the Rate Table - Control
Variable Algorithm Worksheet, Figure 4-22.
In addition, fill out the Rate Table - Control
Variable Algorithm Worksheet for each transaction
accounting journal file you have selected in the unit.
__ 5. Fill out an Algorithm Qualification Worksheet, Figure
4-25, for each journal file for which you have
specified more than one charging algorithm.
Within the information from a given CA MICS product
file, the scope (span of application) of an algorithm
may be limited to specific mainframe processors
(SYSIDs), applications (SUBSYSIDs), types of work
(SUBTYPEs), user-defined organizational units
(COSTCTRs), and work units. Algorithm qualification
defines the portion of the file to which each
algorithm applies.
__ 6. If you want to code a SAS exit for processing
immediately prior to the output of each record, fill
out the Journal File Exit Worksheet, Figure 4-29.
******************************************************
* Complete steps 7 through 9 for each of your *
* external journal files, in an external file *
* unit. If you do not have any external journal *
* files, skip to step 10. *
******************************************************
__ 7. Fill out the External Journal File Update Job
Worksheet, Figure 4-27, for each of your external
journal files. You will specify whether to use
duplicate data checking when the external journal file
update job runs and will write the input DD statement
to input your external file.
__ 8. Fill out the input routine for each of your external
journal files on the External Journal File Input
Routine Worksheet, Figure 4-29.
__ 9. Optionally, fill out a preprocessing exit for each of
your external journal files on the External Journal
File Preprocessing Exit Worksheet, Figure 4-31. This
exit preprocesses your external file before the file
is read in.
__ 10. Select Option 6, Rate Table, on the Parameter
Specifications menu to display the Component and File
Selection panel. If Accounting and Chargeback is
installed in more than one database unit, the unit
selection panel will be displayed prior to the
Component and File Selection panel, and you must
select a unit.
Select a journal file for which you want to modify the
Rate Table on the Component and File Selection panel.
The File Options menu will be displayed for you to
select the option(s) that you need to modify. If you
select an external file unit, three additional
options, discussed in steps 7 through 9, appear on the
File Options menu.
__ 11. Submit the job Rate Table generation job, MAGRUN, in
prefix.MICS.CNTL. If you made any changes, you are
automatically asked to submit this job when you END
from the Component and File Selection panel.
You can also submit this job from TSO as follows:
SUB 'prefix.MICS.CNTL(MAGRUN)'
The MAGRUN job executes the Charging Element
generation and then generates the following items:
#ACTMSTR--in prefix.MICS.USER.SOURCE. This module
contains SAS macros to support charging for
each journal file that you have selected in
the unit.
#ACTXfff--in prefix.MICS.USER.SOURCE. One module is
generated for each journal file in the unit
(where fff is the file ID of the associated
CA MICS product file). For active journal
files, the module contains SAS code to
compute the charges for the journal file.
#LGRDSUM--in prefix.MICS.USER.SOURCE. This module
contains SAS code to summarize the Ledger
File in the DAYS timespan.
ACTAUDIT--in prefix.MICS.USER.SOURCE. This module
contains SAS code to create the Audit File
for a unit.
$ACTVaaa--in prefix.MICS.MUOLIB. One format is
generated for each control variable charging
algorithm in the unit (where aaa is the
algorithm ID). Each format relates a
control variable name and value to a
computation code, rate, and rate effective
date.
$ACTRaaa--in prefix.MICS.MUOLIB. One format is
generated for each algorithm in the unit
(where aaa is the algorithm ID). Each
format relates a computation code to a rate
and the rate effective date.
For external journal files, MAGRUN also generates:
ACTfffTB--in prefix.MICS.CNTL. One job is generated
for each external journal file in the unit
(where fff is the file identifier of the
associated file). This is the job you will
run to load data into the external journal
file.
The sections below discuss the sequence of specifications
that you must follow to define the rate table parameter in a
unit database. Sections 6 through 8 are only for external
file units.
1 - Selecting a Journal File
2 - Specifying Journal File Characteristics
3 - Defining a Journal File Exit
4 - Specifying Algorithms
5 - Qualifying Algorithms
6 - Specifying Ext. File Input Job Characteristics
7 - Specifying an Ext. Journal File Input Routine
8 - Specifying an Ext. Journal File Preprocessing Exit
9 - Input Record Selection Exit (USRACT)
10 - Actual Date Selection Exit (USRRCP)
