Previous Topic: 4.2.1 Defining Charging Elements

Next Topic: 4.2.1.2 Charging Element Example

4.2.1.1 Charging Element Worksheet


Figure 4-5 is the Charging Element Worksheet.

 +----------------------------------------------------------------------------------------------------------+      |                                                                                                          |      | Date: ____/____/____                        Administrator:  ____________________________________________ |      +----------------------------------------------------------------------------------------------------------+                                              CHARGING ELEMENT WORKSHEET                   Complex-                   Level                   External                   File      Comp  Inv.   Element File   Element        Units                   Description           Computation Routine      Code  Catgy  (Y/N)          Name        ____  ____   ____    ____   ________   ______________________  ______________________ ______________________        ____  ____   ____    ____   ________   ______________________  ______________________ ______________________        ____  ____   ____    ____   ________   ______________________  ______________________ ______________________        ____  ____   ____    ____   ________   ______________________  ______________________ ______________________        ____  ____   ____    ____   ________   ______________________  ______________________ ______________________        ____  ____   ____    ____   ________   ______________________  ______________________ ______________________        ____  ____   ____    ____   ________   ______________________  ______________________ ______________________        ____  ____   ____    ____   ________   ______________________  ______________________ ______________________        ____  ____   ____    ____   ________   ______________________  ______________________ ______________________        ____  ____   ____    ____   ________   ______________________  ______________________ ______________________        ____  ____   ____    ____   ________   ______________________  ______________________ ______________________        ____  ____   ____    ____   ________   ______________________  ______________________ ______________________        ____  ____   ____    ____   ________   ______________________  ______________________ ______________________        ____  ____   ____    ____   ________   ______________________  ______________________ ______________________     _______________________________________________________________________________________________________________________________


 Figure 4-5.  Charging Element Worksheet
Use the worksheet to define the following parameters:

 1.  COMPUTATION CODE

     Description:  Uniquely identifies this charging element
     to CA MICS Accounting and Chargeback Option.

     Default:  None

     Values:  Character, length 4, 0 - 9, A - F

     NOTE:  User-defined computation codes should be in the
            range of 8000 and above.

 2.  INVOICE CATEGORY

     Description:  The Invoice Category provides a way to map
     the detailed charging elements referenced by the
     computation code into categories more easily understood
     by the user.  In some cases, there may be one-to-one
     correspondence between the computation code and the
     invoice category; in others, many computation codes may
     be reported in one invoice category.

     Default:  None

     Values:  Alphanumeric, length 4

     NOTE:  This must be a valid entry in the Invoice
            Category Table.

 3.  COMPLEX-LEVEL EXTERNAL FILE ELEMENT

     Description:  This field indicates whether the charging
     element belongs to a complex-level external file.

     Default:  NO

     Values:  Character, length 3

     NOTE:  For the standard and recurring debit and credit
            files, specify YES and refer to the directions
            for FILE and ELEMENT NAME.

 4.  FILE

     Description:  The CA MICS Analyzer file in which the
     charging element resides.

     Default:  None

     Values:  Character, length 3

     NOTE:  If the source of the data element is a
            non-CA MICS (external) file, code the external
            file identifier (the last three characters of the
            external file name).  For debit and credit files,
            specify SDT or SCT, as appropriate.

 5.  ELEMENT NAME

     Description:  The value of this data element will be
     multiplied by the rate to calculate the charge.  If the
     database discretely retains the charging element, you
     must specify the element name that is listed in the
     CA MICS Data Dictionary.  If you want to calculate the
     element, specify an unused element name.

     Default:  None

     Values:  Character, length 8

     NOTES: This name must follow CA MICS naming conventions
            (the first three characters must be the same as
            the file name).  For example, if the source of
            the data is the BATJOB file, code JOB as the
            first three characters of the element name.

            For the Debit and Credit Files, specify SDTQNT or
            SCTQNT, as appropriate.

 6.  MEASURED UNITS

     Description:  A description (up to 16 characters) of the
     units (for example, seconds) in which the charging
     element was measured.

     Default:  None

     Values:  Character, length 16. You cannot use the
     single quote character in this field.

     NOTE:  This text will appear on the invoice.

 7.  CHARGING ELEMENT DESCRIPTION

     Description:  A label that describes the charging
     element.

     Default:  None

     Values:  Character, length 40. You cannot use the
     single quote character in this field.

 8.  COMPUTATION ROUTINE

     Description:  The appropriate CA MICS program uses the
     computation routine to calculate the value of the
     charging element.  Testing the routine is your
     responsibility.  If the element is already computed,
     leave this field blank.

     Default:  None

     Values:  See NOTE

     NOTE:  Your computation routine can use any of the data
            elements that the CA MICS database files
            contain.  The CA MICS Data Dictionary documents
            these elements.  In addition, the exit can make
            use of some data elements (such as ACTFLD1-5 in
            the CA MICS Batch and Operations Analyzer (SMF)
            files) that are not written to the database.

     COMPUTATION ROUTINE CODING CONSIDERATIONS

     In coding the computation routine, observe the following
     conventions:

     o  The routine must be a valid SAS routine with no
        embedded DATA or PROC statements.

     o  Do not use SAS labels because you may include the
        routine in the CA MICS code multiple times and any
        label could cause a "duplicate SAS label" error.

     o  Do not use a RETURN or DELETE command.  The invoking
        routine may not make a single pass through the DATA
        step for each observation.