CICLMF Monthly CICS Service Detail Report
The Monthly CICS Service Detail Report shows the CICS service that is provided to individual applications on a given day.
micsrm140
The Monthly CICS Service Detail Report identifies those applications for which CICS delivered unsatisfactory service. The report provides information that is pertinent to response analysis and can help you identify the areas in which the response delay might have occurred.
Report format
This inquiry produces a tabular report which contains a summary section and a detail section. The summary section shows the response distribution by transaction type for all CICS regions found in the input. The detail section shows the response time and other pertinent information for individual applications. A detail section is generated for each combination of SYSID and CICSID. Each field in this report is described in the following definitions:
System summary
SLO MET
A flag indicating whether the service level objective is met by CICS. For the overall summary line (SYSID=ALL CICSID=ALL), the flag is set to NO if any of the regions failed to meet its service level objectives. By default, this flag is set to YES if 95% of the transactions met the response objective. Otherwise, it is set to NO. You can override the default percentage or set the flag using actual value vs. objective in the %LDESLO user exit.
TYPE
Transaction type: all, short, medium, long, or conversational. Transaction type (TRANTYPE) is assigned by the CICRLRT exit in prefix.MICS.PARMS.
TRANS
The total number of processed transactions, excluding the transactions that are assigned as TRANTYPE X in your CICRLRT exit in prefix.MICS.PARMS.
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).
RESP OBJ
The average response time objective for your installation. This number defaults to 2 seconds for all transactions; 1 for short transactions, 3 for medium transactions, and 5 for long transactions. You can override these values using either MICF execution-time parameters or report user exits.
%OBJ MET
The percentage of transactions that met the response objective.
RESPONSE DISTRIBUTION
The response distributions for the 7 response thresholds which you have specified in prefix.MICS.PARMS(CICOPS).
Detail section
SYSID
System identification. This field is set to ALL for data that is summarized for all systems.
CICSID
CICS system identification as assigned by
MICS
. This field is set to ALL if the data is summarized for all CICS regions.APPL
Application identification.
AVG RESP
The average response time for all transactions that are processed for this application.
MAX RESP
The maximum response time that is received by the application.
RESP OBJ
The average response time objective for your installation. This number defaults to 2 seconds for all transactions; 1 for short transactions, 3 for medium transactions, and 5 for long transactions. You can override these values using either MICF execution-time parameters or report user exits.
%OBJ MET
The percentage of transactions that met the response objective.
TRANS
The total number of transactions processed. For TYPE=ALL, this number excludes transaction type X (TRANTYPE=X as assigned by the CICRLRT exit).
AVG DISPATCH
The average dispatch time for the application.
AVG CP CPU
The average CP CPU time consumed by the application.
AVG zIIP CPU
The average zIIP CPU time consumed by the application.
AVG WAIT
The average wait time for the application. It is calculated as the difference between total response time and total dispatch time divided by total transactions.
AVG SUSP
The average suspends time for the application.
%WAIT FC
The percentage of time the application spent waiting for file control.
%WAIT JC
The percentage of time the application spent waiting for journal control.
%WAIT TC
The percentage of time the application spent waiting for terminal control.
%WAIT TS
The percentage of time the application spent waiting for temporary storage.
%WAIT OTH
The percentage of time the application spent waiting for other reasons, such as waiting for data base management systems (DB2, IMS) or buffer and strings.
%TRANS ABND
The percentage of transactions abend for this application.
Inquiry ID
CICLMF (tabular report)
Data source (file/time-span)
CICCAU01 in the MONTHS time-span.
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
- 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,CAUTCWAT,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 the Changing 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.
- %GSYS
- Select SYSIDs for report.
In addition to the listed exits, the module CICRPTGL also contains macro variables which set default values for service level objectives. See the Changing the Report Parameters section to override the default values.
Monthly CICS Service Detail Report Sample Output Report
MONTHLY CICS SERVICE DETAIL REPORT your_company_name FOR AUGUST, yyyy INQUIRY: CICLMF RUN DATE: 06SEPyy ----------------------------------------------------- SYSID=PRD2 CICSID=LCP1 --------------------------------------------- AVG MAX RESP %OBJ TRANS AVG --- AVG CPU --- AVG AVG ----- % WAIT ------ %TRANS APPL RESP RESP OBJ MET (000) DISPCH CP SPEC WAIT SUSP FC JC TC TS OTH ABND AAON 34.10 34.10 15.00 100.0 1 0.36 0.08 0.00 33.74 0.00 0 0 0 0 100 0 ACFM 0.02 0.13 15.00 100.0 163 0.02 0.01 0.00 53.56 53.55 0 0 100 0 0 0 CATD 0.07 3.80 15.00 100.0 15,759 0.02 0.01 0.00 0.06 0.00 0 0 0 0 100 0 CCMF 0.00 0.04 15.00 100.0 233 0.00 0.00 0.00 0.00 0.00 0 0 0 0 100 0 CEDA 0.20 2.55 15.00 100.0 21 0.05 0.01 0.00 5.14 4.99 3 0 97 0 0 0 CEMT 0.07 0.57 15.00 100.0 10 0.05 0.01 0.00 6.56 6.54 0 0 100 0 0 0 CRSQ 0.27 0.80 15.00 100.0 3 0.00 0.00 0.00 0.27 0.00 0 0 0 0 100 0 CRSR 0.02 2.91 15.00 100.0 29,214 0.00 0.00 0.00 0.02 0.00 0 0 0 0 100 0 CRTE 0.02 1.80 15.00 100.0 691 0.00 0.00 0.00 33.38 33.36 0 0 100 0 0 0 CSAC 0.00 0.06 15.00 100.0 350 0.00 0.00 0.00 0.00 0.00 0 0 71 0 29 0 CSFU 0.83 0.83 15.00 100.0 1 0.01 0.01 0.00 0.81 0.00 0 0 0 0 100 0 CSGM 0.03 3.93 15.00 100.0 16,516 0.01 0.00 0.00 0.03 0.01 0 0 26 0 74 0 CSIR 47.96 64.34 15.00 42.6 61 0.00 0.00 0.00 47.95 0.00 0 0 0 0 100 0 CSMI 0.01 0.11 15.00 100.0 11 0.01 0.00 0.00 0.01 0.00 0 0 0 0 100 0 CSNE 0.00 0.16 15.00 100.0 23,797 0.00 0.00 0.00 0.00 0.00 0 0 0 0 100 0 CSSF 0.01 0.18 15.00 100.0 38 0.01 0.00 0.00 0.34 0.33 0 0 98 0 2 0 CSSN 0.03 0.07 15.00 100.0 6 0.01 0.00 0.00 0.02 0.01 0 0 26 0 74 0 DATA 0.14 20.19 15.00 100.0 14,588 0.01 0.00 0.00 0.15 0.01 0 0 10 0 90 0 DISP 0.03 0.03 15.00 100.0 1 0.03 0.02 0.00 0.00 0.00 0 0 83 0 17 0 D2DA 1.42 7.37 15.00 100.0 15 0.01 0.00 0.00 1.70 0.30 0 0 18 0 82 0 ELON 0.24 1.01 15.00 100.0 10 0.04 0.01 0.00 0.44 0.23 0 0 53 0 47 0 EL00 0.06 0.31 15.00 100.0 40 0.00 0.00 0.00 0.06 0.00 0 0 0 0 100 0 EL10 0.04 0.12 15.00 100.0 9 0.00 0.00 0.00 0.03 0.00 0 0 0 0 100 0 EL20 0.15 1.07 15.00 100.0 41 0.00 0.00 0.00 0.15 0.00 0 0 0 0 100 0 EL22 0.14 0.80 15.00 100.0 50 0.00 0.00 0.00 0.13 0.00 0 0 0 0 100 0 EL29 0.11 0.44 15.00 100.0 21 0.00 0.00 0.00 0.30 0.19 0 0 64 0 36 0 EL30 0.07 0.38 15.00 100.0 14 0.00 0.00 0.00 0.07 0.00 0 0 0 0 100 0 EZ 0.46 3.99 15.00 100.0 324 0.00 0.00 0.00 0.46 0.00 0 0 0 0 100 0 IEOL 0.25 88.32 15.00 99.9 1,346 0.01 0.00 0.00 0.25 0.00 0 0 1 0 99 0 LLTP 0.01 0.01 15.00 100.0 1 0.00 0.00 0.00 0.01 0.00 0 0 25 0 75 0 LLXW 0.04 0.11 15.00 100.0 4 0.02 0.01 0.00 0.02 0.00 0 0 15 0 85 0 LPKD 0.00 0.01 15.00 100.0 3 0.00 0.00 0.00 0.00 0.00 0 0 0 0 100 0 LPKE 0.00 0.00 15.00 100.0 12 0.00 0.00 0.00 0.00 0.00 0 0 0 0 100 0 MSAS 0.17 1.19 15.00 100.0 69 0.00 0.00 0.00 0.17 0.00 0 0 0 0 100 0 MSA2 0.13 5.68 15.00 100.0 3,240 0.00 0.00 0.00 0.18 0.06 0 0 32 0 68 0 SA 0.48 8.66 15.00 100.0 39 0.04 0.00 0.00 388.03 387.59 1 0 99 0 0 0 STAR 0.00 0.01 15.00 100.0 21 0.00 0.00 0.00 0.00 0.00 0 0 32 0 68 0 TOSC 0.13 41.33 15.00 100.0 344,062 0.00 0.00 0.00 0.24 0.12 0 0 49 0 51 0 TOSS 0.40 32.06 15.00 100.0 2,558 0.04 0.01 0.00 0.40 0.04 0 0 8 0 92 0 TOS1 0.38 30.17 15.00 100.0 8,580 0.04 0.01 0.00 0.39 0.05 0 0 12 0 88 0 TOTAL: 0.12 3.72 15.00 100.0 469,835 0.00 0.00 0.00 0.03 0.22 0 0 65 0 35 0