Previous Topic: 4.3.1.4 Specifying Algorithms

Next Topic: 4.3.1.4.2 Algorithm Specification Examples

4.3.1.4.1 Algorithm Specification Worksheets


DIRECT ASSIGNMENT ALGORITHM WORKSHEET

Use the Rate Table - Direct Assignment Algorithm Worksheet
shown in Figure 4-21 for resource accounting algorithms only.
If your algorithm is simple, with only one rate and one
computation code for each charging element, this worksheet is
sufficient for resource algorithms.  If you need to use
different computation codes and/or rates for one or more
charging elements, use this worksheet and the Rate Table -
Control Variable Algorithm Worksheet in Figure 4-22.


          +----------------------------------------------------------------------------------------------------------+           |                                                                                                          |           | Date: ____/____/____                        Administrator:  ____________________________________________ |           +----------------------------------------------------------------------------------------------------------+                                        RATE TABLE - DIRECT ASSIGNMENT ALGORITHM WORKSHEET              DATA BASE UNIT IDENTIFIER: ____________                 Journal     Algorithm   Description       Comp         Rate   Effective      Charging Element Description                File          ID                         Code                Date               ____________ ________ ____________________  _________ _________ ___________    ______________________________                                                           _________ _________ ___________    ______________________________                                                           _________ _________ ___________    _______________________________                                                           _________ _________ ___________    _______________________________                 _____________ ________ ___________________  ________ __________ ___________    _______________________________                                                           ________ __________ ___________    _______________________________                                                           ________ __________ ___________    _______________________________                                                           ________ __________ ___________    _______________________________                 _____________ ________ ___________________  ________ __________ ___________    _______________________________                                                           ________ __________ ___________    _______________________________                                                           ________ __________ ___________    _______________________________                                                           ________ __________ ___________    _______________________________                _____________ ________ ___________________   ________ __________ ___________    _______________________________                                                           ________ __________ ___________    _______________________________                                                           ________ __________ ___________    _______________________________                                                           ________ __________ ___________    _______________________________


 Figure 4-21.  Rate Table - Direct Assignment Algorithm Worksheet
 1.  DATABASE UNIT IDENTIFIER

     Description:  The one-character CA MICS database unit
     identifier.

     Default:  None

     Values:  Character, length 1

  2. JOURNAL FILE

     Description:  The name of the journal file to be charged
     with this algorithm.

     Default:  None

     Values:  Character, length 6. The journal file must be
     one selected for charging (see Section 4.3.1.1).

     Note:  You must code at least one algorithm for each
            file selected.  You can code more than one
            algorithm for each file if you need to use
            different computation codes and/or rates for
            different mainframe processors (SYSIDs),
            application subsystems (SUBSYSIDs), type of work
            (SUBTYPE), or cost centers.

 3.  ALGORITHM IDENTIFIER

     Description:  A user-defined unique code that refers to
     this list of computation codes and their associated
     rates.

     Default:  None

     Values:  Character, length 3

     Note:  The identifier must be unique across all journal
            files in the database unit.

 4.  DESCRIPTION

     Description:  A description of the use or application of
     this specific algorithm.

     Default:  None

     Values:  Character, length 40

     Note:  This field is for your information only.

  5. COMPUTATION CODE

     Description:  The computation code defining the charging
     element to which the rate will be applied.

     Default:  None

     Values:  Character, length 4.  Use a defined computation
     code or one of the special computation codes JMIN and
     SURC.  Use JMIN to establish a minimum charge for each
     work unit to be charged with this algorithm.  Use SURC
     to establish a work unit surcharge.  You can associate
     them with any journal file.

     Note:  Elements whose computation codes are specified
            are kept in the accounting files but not
            necessarily in the corresponding CA MICS file.
            Check the component's GENIN member in
            sharedprefix.MICS.GENLIB to see if the data
            element will be kept.

   6. RATE

      Description:  The rate at which the element identified
      by the computation code will be charged.

      Default:  None

      Values:  Character, length 8, may contain up to six
      decimal positions

   7. EFFECTIVE DATE

      Description:  The date when the rate specified for the
      computation code takes effect.  You can specify two
      effective dates for each charging element in an
      algorithm.  You can use different effective dates to
      preassign a rate change for a future date.  In
      addition, you can begin charging for a new resource by
      using a future date.

      Default:  Blank (interpreted as 01/01/60)

      Values:  Date, length 8, specified as MM/DD/YY; year
      must be 80 or greater.

      Note:  When the journal file records are created during
             the CA MICS daily job, this date is compared to
             the date in the Effective Date Timestamp
             Variable, BILLTS or ENDTS.  If no effective rate
             is found, a rate of missing is used, and the
             computation code and rate will not appear in the
             Ledger File.  If all the rates in the journal
             file record are missing, the record is not
             written to the journal file.  To cause the rate
             to be carried in the journal file, use a rate of
             zero (0) with an effective date of blank.

  8. CHARGING ELEMENT DESCRIPTION

     Description:  The description of the charging element.

     Default:  None

     Values:  Character, length 40

     Note:  This field is for your information only.


CONTROL VARIABLE ALGORITHM WORKSHEET

Use the Rate Table - Control Variable Algorithm Worksheet in
Figure 4-22 for all transaction accounting algorithms and for
resource accounting algorithms that require different
computation codes and/or rates.

  +----------------------------------------------------------------------------------------------------------+           |                                                                                                          |           | Date: ____/____/____                        Administrator:  ____________________________________________ |           +----------------------------------------------------------------------------------------------------------+                                       RATE TABLE - CONTROL VARIABLE ALGORITHM WORKSHEET              DATA BASE UNIT IDENTIFIER: __________               Journal   Algor   Effective  Control         Default   Default    Format      Control Variable             File      ID      Date       Variable        Comp Code Rate                   Value        /Comp Code   /Rate               ______ ________ ___________  _______________ _________ __________ __________  ______________________________________                                                                                             ______________________________________                                                                                             ______________________________________                                                                                             ______________________________________               ______ ________ ___________  _______________ _________ __________ __________  ______________________________________                                                                                             ______________________________________                                                                                             ______________________________________                                                                                             ______________________________________               ______ ________ ___________  _______________ _________ __________ __________  ______________________________________                                                                                             ______________________________________                                                                                             ______________________________________                                                                                             ______________________________________   ________________________________________________________________________________________________________________________________


 Figure 4-22.  Rate Table - Control Variable Algorithm Worksheet
 1.  DATABASE UNIT IDENTIFIER

     Description:  The one-character CA MICS database unit
     identifier.

     Default:  None

     Values:  Character, length 1

  2. JOURNAL FILE

     Description:  The name of the journal file to be charged
     with this algorithm.

     Default:  None

     Values:  Character, length 6. The journal file must be
     one selected for charging (see Section 4.3.1.1).

     Note:  You must code at least one algorithm for each
            file selected.  More than one algorithm can be
            coded for each file if different computation
            codes and/or rates need to be used for different
            mainframe processors (SYSIDs), application
            subsystems (SUBSYSIDs), type of work (SUBTYPE),
            or cost centers.

 3.  ALGORITHM IDENTIFIER

     Description:  A user-defined unique code that refers to
     this list of computation codes and their associated
     rates.

     Default:  None

     Values:  Character, length 3

     Note:  The identifier must be unique across all journal
            files in the database unit.

 4. EFFECTIVE DATE

    Description:  The date on which the computation codes and
    rates specified take effect.

    Default:  Blank (interpreted as 01/01/60)

    Values:  Date, length 8, specified as MM/DD/YY; year must
    be 80 or greater.

    Note:  When the journal file records are being created
           during the CA MICS daily job, this date is
           compared to the date in the Effective Date
           Timestamp Variable, BILLTS or ENDTS.  If no
           effective rate is found, a rate of missing is
           used, and the computation code and rate will not
           appear in the Ledger File.  If all the rates in
           the journal file record are missing, the record is
           not written to the journal file.  To cause the
           rate to be carried in the journal file, use a rate
           of zero (0) with an effective date of blank.

5.  CONTROL VARIABLE NAME

    Description:  The data element upon which value the
    computation code, and/or rate depends.

    Default:  CICAPU for the ACTJCA CICS Transaction Journal
    File; IMSAPU for the ACTJIA IMS Transaction Journal File;
    IDMAPU for the ACTJSA IDMS Transaction Journal File; and
    TSOAPU for the ACTJTC and ACTJTI CA TSO/MON PM
    Transaction Journal Files.  No default for resource
    journal files.

    Values:  Character, length 8

    Note:  This field is preset for transaction journal files
           and normally should not be changed.  The IMSAPU,
           CICAPU, IDMAPU, and TSOAPU values are user-defined
           using SAS coding in the cccAURT member for the
           respective product.

 6. DEFAULT COMPUTATION CODE

    Description:  The computation code that will be used for
    values of the control variable not specified in item 9
    below.

    Default:  1500 for the ACTJCA CICS Transaction Journal
    File; 1000 for the ACTJIA IMS Transaction Journal File,
    1400 for the ACTJTC CA TSO/MON PM Command Transaction
    Journal File, 1900 for the ACTJSA IDMS Transaction
    Journal File, and 1480 for the ACTJTI CA TSO/MON PM
    Interactive Transaction Journal File.  No default for
    resource journal files.

    Values:  Character, length 4. Use a computation code
    defined in the Charging Element TAble.

    Note:  This field is preset for transaction journal files
           and should not normally be changed.

7.  DEFAULT RATE

    Description:  The rate that will be used for values of
    the control variable specified in item 5.  This rate is
    used unless specific values and rates are entered in
    items 9, 10, and 11.

    Default:  None

    Values:  Character, length 8, may contain up to six
    decimal positions

    Note:  If you enter a value of zero, any control variable
           values that are NOT specified below will have a
           zero charge.

8.  VARIABLE FORMAT

    Description:  The SAS format associated with the control
    variable in the CA MICS product generation step.

    Default:  $12

    Values:  Character, length 12, any valid SAS format

    Note:  This field is used to "PUT" the control variable
           value in order to look up its computation code and
           rate at charging algorithm execution time during
           CA MICS daily processing.

9.  CONTROL VARIABLE VALUE

    Description:  A specific value of the control variable
    with which a computation code and rate, discussed below
    in items 10 and 11, will be associated.  Omit this item
    as well as items 10 and 11 for any control variable
    values that you want to charge with the default
    computation code and rate.

    Default: None


    Values:  Character, length 12, any valid value of the
    control variable (see Variable Format in item 7 above)

    Note:  The normal daily processing of the CA MICS product
           will place values into all variables kept in its
           files.  If the control variable is not kept on the
           product file from which this journal file is
           derived, and if standard CA MICS processing does
           not place values in it, you must write exit code
           to assign values to it.  This exit code should be
           placed in the USRUfff macro in
           sharedprefix.MICS.SOURCE(#cccEXIT), where fff is
           the CA MICS product file ID and ccc is the CA MICS
           product ID.  Do not use the accounting journal
           file exit for this purpose.  Each value can be
           charged with a different computation code and/or
           rate.

10. COMPUTATION CODE

    Description:  The computation code that is to be used for
    this specific value of the control variable.

    Default: None

    Values:  Character, length 4

    Note:  This must be a valid computation code in the
           Charging Element Table, and must be associated
           with the CA MICS product file from which this
           journal file is derived.  It must be associated
           with the same charging element as the default
           computation code, and it must have the same
           compute status as the default computation code.
           If it references a derived (computed) element, it
           must have the same computation routine (ACTF
           member) as the default computation code.  Only the
           computation routine for the default computation
           code will be included in the generated code.

11. RATE

    Description:  The rate that is to be used for this
    specific value of the control variable.

    Default:  None

    Values:  Character, length 8, may contain up to six
    decimal positions.