Previous Topic: 3.1.1.25 CICLDF: Daily CICS Service Detail Report

Next Topic: 3.1.1.27 CICLME: Monthly CICS Service Summary Report

3.1.1.26 CICLMB: Monthly CICS Service Ranking Report

The Monthly CICS Service Ranking inquiry produces tabular
reports which identifies the top 10 CICS applications with
the worst average response time in a given month.

REPORT FORMAT:

This inquiry produces a tabular report which contains a
summary section and a ranking section.  The summary section
shows the overall response distribution by transaction type,
and indicates whether or not the service level objective has
been met for the month.  The ranking section identifies the
10 applications with the worst average response time and
provides other pertinent information such as average wait
time and percentage of wait in file control, journal control,
terminal control, and temporary storage.

The service level objectives used in this report are defined
by module #CICMOBJ in prefix.MICS.SOURCE and CICRPTGL in
sharedprefix.MICS.SOURCE.  See section 3.2 of this guide if
you want to override the service level objectives.  A sample
output of this inquiry is shown in Figure 3-13.

INQUIRY ID:

     CICLMB (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.

DATA ELEMENTS USED:

     CAUABEND - Abnormal Termination Occurrences
     CAUCDSTx - Count Conv.  Responses Within Limit x
     CAUCPUTM - Task CPU Time
     CAUCRSTM - Conv. Response Time Total
     CAUCTRN  - Conv. Transactions Processed
     CAUDAMSC - Damaged Storage Chain
     CAUETRN  - Excessive Transactions Processed
     CAUFCWAT - Wait Time for CICS File Control
     CAUJCWAT - Wait Time for CICS Journal Control
     CAUMDSTx - Count Medium Responses Within Limit x
     CAUMRSTM - Medium Response Time Total
     CAUMTRN  - Medium Transactions Processed
     CAUMXTSK - Max Tasking Condition
     CAUPETTM - Task Dispatch Time
     CAURESTM - Transaction Residency Time
     CAUSDSTx - Count Short Responses Within Limit x
     CAUSOS   - Short on Storage Condition
     CAUSRSTM - Short Response Time Total
     CAUSTRN  - Short Transactions Processed
     CAUSUSTM - Time Transaction was on CICS Susp Chain
     CAUTCWAT - Wait Time for CICS Terminal Control
     CAUTDSTx - Count Responses Within Limit x
     CAUTLWAT - Wait Time for CICS (Total)
     CAUTRANS - Transactions Processed
     CAUTRSTM - Transaction Response Time Total
     CAUTSWAT - Wait Time for CICS Temp Storage
     CICAPU   - CICS Application Unit ID
     CICSID   - CICS System Identifier
     DAY      - Day of Month
     MONTH    - Month of Year
     YEAR     - Year of Century
     ZONE     - Time Zone
     SYSID    - System Identifier

   CALCULATIONS:

     Average conv. response time = CAUCRSTM/CAUCTRN
     Average dispatch = CAUPETTM/SUM(CAUTRANS,CAUETRN)
     Average long response time = CAULRSTM/CAULTRN
     Average medium response time = CAUMRSTM/CAUMTRN
     Average response time = CAUTRSTM/CAUTRANS
     Average short response time = CAUSRSTM/CAUSTRN
     Average suspend = CAUSOS/SUM(CAUTRANS,CAUETRN)
     Average wait= (CAURESTM-CAUPETTM)/SUM(CAUTRANS,CAUETRN)
     Average CPU = CAUCPUTM/CAUTRANS;
     Other wait=total wait-SUM(CAUFCWAT,CAUJCWAT,CAUTCWAT,
                CAUTSWAT)
     Percent FC wait = CAUFCWAT/total wait * 100
     Percent JC wait = CAUJCWAT/total wait * 100
     Percent OT wait = Other wait/total wait * 100
     Percent TC wait = CAUTCWAT/total wait * 100
     Percent TS wait = CAUTSWAT/total wait * 100
     Total wait= CAURESTM-CAUPETTM;

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.

     RESP   - Optionally, select the type of responses to be
              ranked.  The response types are AVG, SHORT,
              MED, LONG, or CONV.  The default value is AVG
              which produces ranking by average response
              seconds.

     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:

     %APPLOBJ- Define service level objective for individual
               applications.  By default, the same objectives
               are set for each application.  The objectives
               are defined in prefix.MICS.SOURCE(#CICMOBJ).

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

     %GCIC  -  Select CICSIDs for report.

     %GSLO  -  Determine if SLO (service level objectives)
               has been met.  No defaults.

     %GSYS  -  Select SYSIDs for report.

     In addition to the above exits, the module CICRPTGL also
     contains macro variables which set default values for
     service level objectives.  Please see Section 3.2 to
     override the default values.

MONTHLY CICS SERVICE RANKING REPORT your_company_name FOR AUGUST, 1991 INQUIRY: CICLMB RUN DATE: 06SEP91 SYSTEM SUMMARY: 7 REGIONS SLO AVG RESP %OBJ ------------ RESPONSE DISTRIBUTION ------------ MET TYPE # TRANSACTIONS % RESP OBJ MET <1 <2 <3 <4 <5 <6 <7 YES TOTAL 644,548 0.32 15.00 100.0 95.6 2.9 1.1 0.3 0.0 0.0 0.0 YES SHORT 362,767 56.3 0.13 5.00 100.0 95.8 2.8 1.0 0.3 0.0 0.0 0.0 YES LONG 232,047 36.0 0.68 15.00 100.0 94.5 3.5 1.4 0.4 0.1 0.0 0.0 YES CONV 49,734 7.7 0.03 15.00 100.0 99.8 0.1 0.0 0.0 0.0 0.0 0.0 ** TOP 10 APPLICATIONS WITH WORST AVG RESPONSE TIME AVG RESP %OBJ AVG AVG AVG AVG ----- % WAIT ------ ----- %TRANS ------ RANK APPL RESP OBJ MET # TRANS DISPCH CPU WAIT SUSP FC JC TC TS OTH SOS MXTSK VIOL ABND 1 TCSV 908.32 15.00 0.0 1 0.04 0.01 908.28 0.00 0 0 0 0 100 0 0 0 0 2 DSNC 700.14 15.00 66.7 3 1.03 0.55 699.11 1.67 0 0 0 0 100 0 0 0 0 3 OPID 691.24 15.00 83.3 6 0.05 0.00 691.19 690.88 0 0 50 0 50 0 0 0 0 4 LAON 71.69 15.00 63.6 11 0.98 0.01 70.71 2.39 0 0 0 0 100 0 0 0 0 5 GLST 42.70 15.00 89.9 247 0.05 0.03 42.65 34.15 0 0 44 0 55 0 0 0 1 6 ICST 13.80 15.00 100.0 1 0.15 0.01 13.66 12.62 0 0 0 0 100 0 0 0 0 7 RSFU 12.76 15.00 100.0 11 0.27 0.02 12.49 3.46 0 0 0 0 100 0 0 0 0 8 ISHI 12.62 15.00 100.0 1 0.15 0.02 12.47 10.00 0 0 0 0 100 0 0 0 0 9 DPRM 4.65 15.00 100.0 9 0.28 0.03 4.37 3.43 21 0 0 0 79 0 0 0 0 10 CSIR 2.56 15.00 97.3 1,479 0.00 0.00 2.55 0.04 0 1 0 0 99 0 0 0 0


 Figure 3-13. Monthly CICS Service Ranking Report Sample Output