Previous Topic: 3.1.5.10 CICLDX: Daily CICS Cost Detail Report

Next Topic: 3.1.5.12 CICLMW: Monthly CICS Cost Summary Report

3.1.5.11 CICLMR: Monthly CICS Cost Ranking Report


The Monthly CICS Cost Ranking Report identifies the top 10
consumers in CICS chargeable resource.

REPORT FORMAT:

This inquiry produces a tabular report which contains a
summary section and a ranking section.  The summary section
shows the total cost for the enterprise and for each system.
The ranking section identifies the 10 applications with the
highest processing cost and provides total consumption of
resources that are most often used for charging.

A sample output of this inquiry is shown in Figure 3-49.
Each field in this report is described below:

SYSTEM SUMMARY:

# REGIONS:  Total number of SYSID/CICSID combinations found
            in input.

SYSID:      System identification. This field is set to ALL
            for data that is summarized for all systems.

TRANS:      The total number of transactions processed. For
            TYPE=ALL, this number excludes transaction type X
            (TRANTYPE=X as assigned by the CICRLRT exit).

COST (000): The total processing charges in thousands of
            dollars.

COST/       The average cost per transaction.
TRAN:

AVG RESP:   The average response time for the transactions
            processed.  For TYPE=ALL, this number excludes
            transaction type X (TRANTYPE=X as assigned by the
            CICRLRT exit).

TOTAL CPU:  The total TCB CPU time consumed by all
            transactions, excluding transaction type X.

RANKING SECTION:

RANK:       The ranking, number 1 to 10, in processing
            cost.

APPL:       Application identification.

COST:       The total processing charges for the application.

TRANS:      The total number of transactions processed for
            the application.

COST/	     Average cost per transaction for the application.
TRAN:       

AVG RESP:   The average response time for all transactions
            processed for this application.

TOT CPU:    The total TCB CPU time consumed by this
            application.

FC CALLS:   The total number of file control calls issued by
            this application.

DBMS CALLS: The total number of data base calls (DB2 and IMS)
            issued by this application.

MSGS        The total number of input and output messages
            generated by this application (in thousands).

CHAR (000): The total number of input and output characters
            generated by this application (in thousands).

AVG         The average amount (in 1024 bytes) of terminal
STORAGE:    and user storage used by this application.

INQUIRY ID:

     CICLMR (tabular report)

DATA SOURCE (file/timespan):

     CICCAU01 in the MONTHS timespan.

     If the CICCAU (CICS Application Unit Activity) file is
     not active, the CICCSU (CICS User Activity) file will be
     used for reporting.  The variable CICACT2 will be used
     in place of the variable CICAPU.

     One graph produced for each combination of SYSID/CICSID.

DATA ELEMENTS USED:

     CICAPU   - CICS Application Unit ID
     CICSID   - CICS System Identifier
     CAUCOST  - Processing Charges
     CAUDLICC - Number of CICS DL/I Calls
     CAUFCOPS - Number of CICS File Control Calls
     CAUINCH  - Input Message Character Traffic
     CAUMEMRC - Memory Usage Running Count
     CAUOUTCH - Output Message Character Traffic
     CAUCPUTM - Task CPU Time
     CAUSQLTO - Total number of SQL Calls
     CAUTRANS - Transactions Processed
     CAUTRSTM - Transaction Response Time Total
     MONTH    - Month of Year
     YEAR     - Year of Century
     ZONE     - Time Zone
     SYSID    - System Identifier

   CALCULATIONS:

     Average response time = CAUTRSTM/CAUTRANS
     Average cost = CAUCOST/CAUTRANS
     Average storage = CAUMEMRC/SUM(CAUTRANS,CAUETRN)

EXECUTION-TIME PARAMETERS:

     UNIT   - Select one or more CA MICS data base units by
              entering the data base IDs.  Enter multiple IDs
              with a blank following each ID value.

     CYCLE  - Optionally, define CA MICS input file cycle
              range.

              For this inquiry, the default is the 01 cycle.


     SYSID  - Optionally, specify the SYSID to be reported.
              If no value is specified, the value *ALL is
              used. It causes all SYSIDs found in input to
              be summarized together.


     CICSID - Optionally, specify the CICSID to be reported.
              If no value is specified, the value *ALL is
              used which causes all CICSIDs found in input to
              be summarized together.

     DATE   - Optionally, enter the date to be reported in
              ddmmmyy format.

              For this inquiry, the default is yesterday.

     ZONE   - Optionally, select one or more CA MICS time
              zones.  Valid values are numbers 1 through 9.

     FILE ID- Optionally, select the CICCSU file as input
              when the CICCAU file is active.  If you specify
              this parameter, then you must also specify the
              next parameter to indicate which account code
              (CICACT1-CICACT9) identifies your CICS
              application.

     CICAPU - Optionally, replace CICAPU with any of the
              CICACTx data elements, where x is 1 to 9.  This
              parameter must be specified in conjunction with
              FILE ID.

USER EXITS:

     If the MICF execution-time parameters are insufficient
     to select the data you need, you can invoke one of the
     following global exits to further manipulate the input
     file.  Additionally, you can override the global exit
     definitions in MICF using independent source statements.
     For detailed information on coding the exits, refer to
     Section 3.2 of this guide.

     The global exits are defined by macros in the source
     module CICRPTGL in sharedprefix.MICS.SOURCE.  The
     following exits are available to this inquiry:

     %GAPPL  - Define your CICS application based on any
               variable in the input file.  The default is
               CICAPU.

     %GCIC  -  Select CICSIDs for report.

     %GCNTR -  Assign value to the variable CENTER which
               defines the logical grouping of SYSIDs.
               CENTER is set to SYSID by default.

     %GSYS  -  Select SYSIDs for report.

MONTHLY CICS COST RANKING REPORT your_company_name FOR FEBRUARY, 2007 INQUIRY: CICLMR RUN DATE: 02MAR07 SYSTEM SUMMARY: 7 REGIONS COST/ AVG TOTAL SYSID # TRANSACTIONS COST TRANS RESP CPU *ALL 644,548 $435 $0.00 0.32 0:49 ** TOP 10 CONSUMERS IN TOTAL COST COST/ AVG FILE CNTL DBMS MSGS CHAR AVG RANK CONSUMER COST TRANS TRAN RESP CPU CALLS CALLS (000) (000) STORAGE 1 GADF $45,400 454 $100.00 0.42 0:00 15 0 0 5 91K 2 GAD2 $42,200 715 $13.33 0.16 0:00 69 0 0 12 124K 3 AAON $9,600 471 $200.00 71.69 0:00 19 0 0 0 216K 4 ACFM $8,780 863 $14.72 0.02 0:00 0 0 0 162 70K 5 TCRI $8,600 2,102 $2.66 0.07 0:00 5814 0 3 1682 20K 6 MSR1 $5,600 2,359 $2.37 0.04 0:00 3991 0 4 2345 22K 7 MTR2 $4,800 424 $116.67 0.04 0:00 12 0 0 14 21K 8 ACTT3 $3,600 780 $4.62 0.04 0:00 2829 0 1 1680 25K 9 PRT4 $3,100 31 $100.00 0.02 0:00 17 0 0 5 19K 10 AISI $4,400 952 $4.62 0.16 0:00 641 0 1 830 140K

 Figure 3-49. Monthly CICS Cost Ranking Report Sample Output