Previous Topic: 3.5 Avoiding CICS Duplicate ChargingNext Topic: 3.7 Avoiding SNT Duplicate Charging


3.6 Avoiding IMS Duplicate Charging

 
 Duplicate charging for the IMS regions can occur because
 their resource utilizations are reported in both IMS and SMF.
 In addition, duplicate charging for the IMS DBCTL regions can
 occur between IMS and CICS.
 
 If you charge for IMS resource utilization from the ACTJIS
 IMS Resource Journal File and charge for batch processing
 from the ACTJBJ Batch Job, or ACTJBP Batch Program Journal
 File, or if you charge DBCTL from CICS, then you must take
 care to avoid duplicate charging for the IMS control region
 and for IMS dependent regions.
 
 If you charge IMS control regions from IMS, you can exclude
 them from charging in SMF.
 
 For IMS dependent regions, the type of program that generated
 the IMS transaction determines where it can be charged.
 The types of programs are:
 
 o BMP
 o APPC
 o MPP
 o DBCTL
 
 BMP programs can be charged from SMF because it contains the
 total resource utilization for the program, not only the IMS
 part.
 
 APPC programs are not charged in SMF, so charge these progams
 in IMS.
 
 Charge MPP programs from IMS.
 
 Charge DBCTL programs from CICS because the user who issued
 the transaction cannot be determined from IMS.
 
 Note: DBCTL resources are not automatically charged from
 CICS.  Activate the appropriate data elements and create
 computation codes for them and then use the computation codes
 in your charging algorithms.  For more information, see
 Section 3.5, Avoiding CICS Duplicate Charging.
 
 
 HOW TO AVOID DUPLICATE CHARGING
 
 - Use the Rate Table Algorithm Qualification to exclude the
   IMS control region and the MPP and DBCTL programs from SMF
   charging.  For more information see, Section 3.4, Avoiding
   SMF Duplicate Charging.
 
  Use Journal File Eligibility and Rate Table Algorithm
  Qualification to cause BMP and DBCTL transactions to be
  charged with 0 rates in IMS as follows:
 
  1) Assign ISUITYPE (initial transaction type) to an IMSACTn
     variable in sharedprefix.MICS.SOURCE(IMSACRT).
 
     ISUITYPE is a work variable that indicates the type of
     program that generated the transaction.  Assigning it to
     an IMSACTn variable causes it to be available in the
     DAYS timespan, where charging occurs.
 
     Transactions generated by BMP and DBCTL programs will
     have ISUITYPE values of B and D respectively.
 
  2) Select Journal File Eligibility (Option S;2 on the
     Installation Accounting Primary Options Menu) and select
     the ACTJIS IMS Resource Journal File.
 
     Enter IMSACTn (where n is the number of the account code
     that contains ISUITYPE) in the "Subtype variable" and
     "Workarea variable 1" fields.
 
     END from Journal File Eligibility.
 
  3) Select Rate Table (Option 3;6 on the Installation
     Accounting Primary Options Menu), select the IMS unit if
     necessary, and select the ACTJIS IMS Resource Journal
     File.
 
  4) If you have not previously done so, select Option 1 and
     enter the file specifications.
 
  5) Select Algorithm Specification, Option 3, from the File
     Options menu.
 
     If you have not previously done so, insert your charging
     algorithms.
 
     Insert a new "dummy" charging algorithm for BMP and DBCTL
     regions and select it.  Enter any IMS computation code
     and a rate of 0.
 
     END back to the File Options menu.
 
  6) Select Algorithm Qualification, Option 4, from the File
     Options menu.
 
     Enter a Subtype value of B for the "dummy" BMP/DBCTL
     algorithm.
 
     Use the I line command to create another row for the
     "dummy" algorithm with a Subtype value of D.
 
     Enter a Subtype value of *DEF for all other algorithms.
 
     This causes the "dummy" algorithm to be used for BMP
     /DBCTL transactions, and the normal algorithms to be used
     for all other IMS work.
 
  7) END from Rate Table and submit MAGRUN when requested.
 
  8) Repeat steps 3 through 7 for each IMS unit.
 
 A sample qualification panel follows with a standard IMS
 algorithm called JIS and the dummy algorithm called DUM:
 

-------------------------- Algorithm Qualification ---------- ROW 3 FROM 22 Command ===> Scroll ===> CSR Unit: I - COST MANAGEMENT IMS UNIT Journal file: IMS Resource Journal File Line Commands: I Insert D Delete SCROLL RIGHT TO VIEW COMPLETE WORKUNIT COLUMN Use groups for SYSID ===> NO Subsysid ===> NO Subtype ===> NO COSTCTR1 ===> NO Workunit ===> NO Alg SYS- S Partial Cmd ID ID Subsysid Subtype COSTCTR1 E Workunit - --- ---- -------- -------- ------------------------------- -------------- _ JIS *ALL *ALL *DEF *ALL _ _____ _ DUM *ALL *ALL B *ALL _ _____ _ DUM *ALL *ALL D *ALL _ _____ ___________________________________________________________________________

 
Figure 3-3.  Sample Algorithm Qualification Panel

 - If you charge CPU time for the IMS resource utilization,
   you must take care to avoid duplicate charging.  With IMS
   version 12.0 and Mainview for IMS Version 4.6, more
   charging elements were added to the IMSISU file.  These
   data elements contain the amount of CPU time that is
   consumed on CP, zIIP, and zAAP engines for dependent
   regions, respectively.
 
  The standard computation codes whose associated data
  elements contain or are related to IMS CPU time follow.
 
   Comp   Data
   Code   Element    Description
   ----   -------    -----------------------------------
   1001   ISUCPUNI   IMS Instructions Executed
   1002   ISUKSRU    IMS System Resource Units
   1003   ISUPETTM   IMS Pseudo Elapsed Time
   1004   ISUCPUTM   IMS Total CPU Time
   1005   ISUTMDCP   IMS Dependent Region Processing Time
   1006   ISUTMCDL   IMS DL/I CPU Time
   1007   ISUTMDDL   IMS Dependent Region DL/I Time
   1008   ISURESTM   IMS Fast Path Application Time
   1009   ISUDB2TM   IMS DB2 CPU Time
   1010   ISUDBOTM   IMS DL/I, Buffer, Open/Close CPU Time
   1020   ISUTMCP    IMS Dependent Region CP time
   1021   ISUTMZAP   IMS Dependent Region zIIP/zAAP Time
   1025   ISUSUCTM   IMS Dep Reg zIIP Eligible CPU on a CP
   1026   ISUZACTM   IMS Dep Reg zAAP Eligible CPU on a CP
   1027   ISUXCSTM   IMS CP Time Minus zIIP/zAAP Eligible
 
 
   The total CPU time on a general processor (CP) is contained
   in data element ISUCPUTM (1004).
 
   This IMS Resource CPU time on CP processors is a composite
   of several different metrics:
 
     ISUCPUTM (1004) = ISUTMDCP (1005) + ISUDBOTM (1010)
 
     ISUDBOTM (1010) = ISUTMCBF + ISUTMCDL (1006) +
                       ISUTMDBF + ISUTMDDL (1007) +
                       ISUTMDOC
 
     ISUTMDCP (1005) = ISUTMCP  (1020) + ISUZACTM (1025) +
                       ISUSUCTM (1026) + ISUXCSTM (1027)
 
     ISUTMCP  (1020) = ISUZACTM (1025) + ISUSUCTM (1026) +
                       ISUXCSTM (1027)
 

+------------------+ +----------+ | ISUCPUTM | | ISUTMZAP | | | | | | (1004) | | (1021) | +------------------+ +----------+ | | +-----------------------------------------------------------------------+ | | | | +---------+ +----------+ |ISUTMDCP | | ISUTMDOC | | | | | | (1005) | | | +---------+ +--------- + | | | | | | | | | +---------------------------------------------------------------------+ | | | | | | +----------+ +----------+ +----------+ +----------+ +-----------+ +----------+ | ISUTMCP | | ISUTMCDL | | ISUTMCBF | |ISUTMDBF | | ISUTMDDL | | ISUTMDOC | | | | | + | | + | | + | | + | | | (1020) | | (1006) | | | | | | (1007) | | | +----------+ +----------+ +----------+ +----------+ +-----------+ +--------- + | | +-----------------------------------+ | | | | +----------+ +-----------+ +----------+ | ISUSUCTM | | ISUZACTM | | ISUXSCTM | | | + | | + | | | (1025) | | (1026) | | (1027) | +----------+ +-----------+ +----------+

 
Figure 3-4.  IMS CPU time on CP processor

  The following table shows you how to avoid duplicate charging
  for CP processor CPU time based on the computation codes you
  select to use:
 
  AVOIDING DUPLICATE CHARGES:
  +---------------------------------------------------------------+
  | If you charge for            |   You should not               |
  |    COMP CODE:                |   charge for:                  |
  |----------+-------------------+ ---------+---------------------|
  |  COMP    | Associated        | COMP     | Associated          |
  |  CODE    | Data element      | CODE     | Data element        |
  |===============================================================|
  |  1004    | ISUCPUTM          |  1005    |  ISUTMDCP           |
  |          |                   |  1006    |  ISUTMCDL           |
  |          |                   |  1007    |  ISUTMDDL           |
  |          |                   |  1010    |  ISUDBOTM           |
  |          |                   |  1020    |  ISUTMCP            |
  |          |                   |  1025    |  ISUSUCTM           |
  |          |                   |  1026    |  ISUZACTM           |
  |          |                   |  1027    |  ISUXCSTM           |
  |----------|-------------------|----------|---------------------|
  |  1005    | ISUTMDCP          |  1004    |  ISUCPUTM           |
  |          |                   |  1020    |  ISUTMCP            |
  |          |                   |  1025    |  ISUSUCTM           |
  |          |                   |  1026    |  ISUZACTM           |
  |          |                   |  1027    |  ISUXCSTM           |
  |----------|-------------------|----------|---------------------|
  |  1006    | ISUTMCDL          |  1004    |  ISUCPUTM           |
  |----------|-------------------|----------|---------------------|
  |  1007    | ISUTMDDL          |  1004    |  ISUCPUTM           |
  |----------|-------------------|----------|---------------------|
  |  1010    | ISUDBOTM          |  1004    |  ISUCPUTM           |
  |          |                   |  1006    |  ISUTMCDL           |
  |          |                   |  1007    |  ISUTMDDL           |
  |----------|-------------------|----------|---------------------|
  |  1020    | ISUTMCP           |  1004    |  ISUCPUTM           |
  |          |                   |  1005    |  ISUTMDCP           |
  |          |                   |  1025    |  ISUSUCTM           |
  |          |                   |  1026    |  ISUZACTM           |
  |          |                   |  1027    |  ISUXCSTM           |
  |----------|-------------------|----------|---------------------|
  |  1025    | ISUSUCTM          |  1004    |  ISUCPUTM           |
  |          |                   |  1005    |  ISUTMDCP           |
  |          |                   |  1020    |  ISUTMCP            |
  |----------|-------------------|----------|---------------------|
  |  1026    | ISUZACTM          |  1004    |  ISUCPUTM           |
  |          |                   |  1005    |  ISUTMDCP           |
  |          |                   |  1020    |  ISUTMCP            |
  |----------|-------------------|----------|---------------------|
  |  1027    | ISUXCSTM          |  1004    |  ISUCPUTM           |
  |          |                   |  1005    |  ISUTMDCP           |
  |          |                   |  1020    |  ISUTMCP            |
  +----------+-------------------+----------+---------------------+