CICLMB Monthly CICS Service Ranking Report

The Monthly CICS Service Ranking inquiry produces tabular reports that identify the top 10 CICS applications with the worst average response time in a given month.
micsrm140
The Monthly CICS Service Ranking inquiry produces tabular reports that identify 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 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 that are used in this report are defined by module #CICMOBJ in prefix.MICS.SOURCE and CICRPTGL in sharedprefix.MICS.SOURCE. If you want to override the service level objectives, see Changing Report Parameters.
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 is used for reporting. The variable CICACT2 is 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
CAUETRN
- Excessive Transactions Processed
CAUFCWAT
- Wait Time for CICS File Control
CAUJCWAT
- Wait Time for CICS Journal Control
CAULDSTx
- Count Long Responses Within Limit
CAULRSTM
- Long Transaction Response Time
CAULTRN
- Long Transaction Count
CAUMDSTx
- Count Medium Responses Within Limit x
CAUMRSTM
- Medium Response Time Total
CAUMTRN
- Medium Transactions Processed
CAUNZZTM
- Normalized zIIP CPU Time
CAUPETTM
- Task Dispatch Time
CAURESTM
- Transaction Residency Time
CAUSDSTx
- Count Short Responses Within Limit x
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
CAUZPTRN
- zIIP CPU Transactions Processed
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 time = CAUSUSTM/SUM(CAUTRANS,CAUETRN) Average wait = (CAUTRSTM-CAUPETTM)/SUM(CAUTRANS,CAUETRN) Average CP time = CAUCPUTM/SUM(CAUTRANS,CAUETRN) Average SPEC time (zIIP time) = CAUNZZTM/CAUZPTRN Other wait = total wait-SUM(CAUFCWAT,CAUJCWAT,CAUTSWAT) Percent transactions ABEND = CAUABEND/SUM(CAUTRANS,CAUETRN) * 100 Percent FC wait = CAUFCWAT/total wait * 100 Percent JC wait = CAUJCWAT/total wait * 100 Percent OT wait = 100 - SUM(percent FC wait, percent JC wait, percent TC wait, percent TS wait) Percent TC wait = CAUTCWAT/SUM(CAUTCWAT,total wait) * 100 Percent TS wait = CAUTSWAT/total wait * 100 Total wait = CAUTRSTM-CAUPETTM
Execution-time parameters
 
UNIT
Select one or more
MICS database
units by entering the data base IDs. Enter multiple IDs with a blank following each ID value.
CYCLE
(Optional) Define
MICS
input file cycle range.
For this inquiry, the default is the 01 cycle.
SYSID
(Optional) 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
(Optional) Specify the CICSID to be reported. If no value is specified, the value *ALL is used. It causes all CICSIDs found in input to be summarized together.
DATE
(Optional) enter the date to be reported in ddmmmyy format.
For this inquiry, the default is yesterday.
ZONE
(Optional) select one or more
MICS
time zones. Valid values are numbers 1 through 9.
RESP
(Optional) 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
(Optional) select the CICCSU file as input when the CICCAU file is active. If you specify this parameter, also specify the next parameter to indicate which account code (CICACT1-CICACT9) identifies your CICS application.
CICAPU
(Optional) replace CICAPU with any of the CICACTx data elements, where x is 1 through 9. This parameter must be specified along 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 details about coding the exits, see theChanging the Report Parameters section.
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 listed exits, the module CICRPTGL also contains macro variables that set default values for service level objectives. See the Changing the Report Parameters section to override the default values.

Monthly CICS Service Ranking Report Sample Output Report

MONTHLY CICS SERVICE RANKING REPORT your_company_name FOR AUGUST, yyyy INQUIRY: CICLMB RUN DATE: 06SEPyy 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 CPU --- AVG AVG ----- % WAIT ------ %TRANS RANK APPL RESP OBJ MET # TRANS DISPCH CP SPEC WAIT SUSP FC JC TC TS OTH ABND 1 TCSV 908.32 15.00 0.0 1 0.04 0.01 0.00 908.28 0.00 0 0 0 0 100 0 2 DSNC 700.14 15.00 66.7 3 1.03 0.55 0.01 699.11 1.67 0 0 0 0 100 0 3 OPID 691.24 15.00 83.3 6 0.05 0.00 0.00 691.19 690.88 0 0 50 0 50 0 4 LAON 71.69 15.00 63.6 11 0.98 0.01 0.00 70.71 2.39 0 0 0 0 100 0 5 GLST 42.70 15.00 89.9 247 0.05 0.03 0.00 42.65 34.15 0 0 44 0 55 1 6 ICST 13.80 15.00 100.0 1 0.15 0.01 0.00 13.66 12.62 0 0 0 0 100 0 7 RSFU 12.76 15.00 100.0 11 0.27 0.02 0.00 12.49 3.46 0 0 0 0 100 0 8 ISHI 12.62 15.00 100.0 1 0.15 0.02 0.00 12.47 10.00 0 0 0 0 100 0 9 DPRM 4.65 15.00 100.0 9 0.28 0.03 0.00 4.37 3.43 21 0 0 0 79 0 10 CSIR 2.56 15.00 97.3 1,479 0.00 0.00 0.00 2.55 0.04 0 1 0 0 99 0