CICLX3 - Daily CICS Dispatch Statistics Report

The Daily CICS Dispatch Statistics Report is similar to the Dispatcher reports produced by IBM CICS utility DFHSTUP.  The report contains three sections, Dispatcher, TCB Mode, and TCB Pool statistics over the reporting interval.
micsrm140cd
The Daily CICS Dispatch Statistics Report is similar to the Dispatcher reports produced by IBM CICS utility DFHSTUP.  The report contains three sections, Dispatcher, TCB Mode, and TCB Pool statistics over the reporting interval.
The Dispatcher Statistics section contains many CICS address space global statistics of activity and status, such as address space CPU time and current number of dispatcher tasks.
The TCB Modes section contains many statistics on each of the TCB types, for example, counts of TCBs attached, TCBs in use, dispatch time, wait time, and more.  If the value of Percent TCB Utilization is more that 70 percent, per IBM documentation, the CICS region is reaching its capacity. The TCB Pools section contains statistics on each of the four TCB Pools (OPEN, XP, SSL, and THRD).
Report format:
 
This inquiry produces a tabular report which provides a detailed set of TCB-related metrics for each CICS region.
Inquiry ID:
 
CICLX3 (tabular report)
Data Source (file/timespan):
 
  • CICCSY01 in the DETAIL timespan
  • CICCSB01 in the DETAIL timespan
  • CICCSP01 in the DETAIL timespan
Data elements used:
 
Page header:
 
SYSID
- System ID
CICSID
- Subsystem
CICAPPL
- CICS Applid
CICSMVER
- CICS Version
STARTTS
- Interval Start
ENDTS
- Interval End
Dispatcher statistics report section:
 
CSYLSTRT
- Dispatcher Start Date and Time
CSYEJSTM
- Address Space CPU Time
CSYSRBTM
- Address Space SRB Time
CSYNRTSK
- Current number of dispatcher tasks
CSYMCTSK
- Peak number of dispatcher tasks
CSYTMICV
- Current ICV time (msec)
CSYTMVRT
- Current ICVR time (msec)
CSYTMTSD
- Current ICVTSD time (msec)
CSYPRIAG
- Current PRTYAGE time (msec)
CSYMBTCH
- Current MRO (QR) Batching (MROBTCH) value
CSYLXSCN
- Last Excess TCB Scan
CSYXSCNS
- Number of Excess TCB Scans
CSYLXSND
- Last Excess TCB Scan - No TCB Detached
CSYXSCNN
- Excess TCB Scans - No TCB Detached
CSYXTCBD
- Number of Excess TCBs Detached
CSYTRSTM
- Average Excess TCBs Detached per Scan
CSYTCBMD
- Number of CICS TCB MODEs
CSYTCBPL
- Number of CICS TCB POOLs
Calculations:
Average Excess TCBs Detached per Scan = CSYXTCBD / CSYXSCNS
CICS TCB Mode Statistics Report Section
 
CSBTCBNM
- TCB Mode
CSBTCBMD
- Open
CSBTCBMP
- TCB Pool
CSBTCBCA
- TCBs Attached (Current)
CSBTCBPA
- TCBs Attached (Peak)
CSBTCBCU
- TCBs In Use (Current)
CSBTCBPU
- TCBs In Use (Peak)
CSBNTCBA
- TCB Attaches
CSBTMCDQ
- Dispatchable Queue (Current) (5.2+)
CSBTMPDQ
- Dispatchable Queue (Peak) (5.2+)
CSBAVTDQ
- Dispatchable Queue (Average) (5.2+)
CSBTCBDU
- Detached Unclean
CSBTCBDS
- Detached Stolen
CSBTCBDX
- Detached Excess
CSBTCBDO
- Detached Other
CSBTCBST
- TCB Steals
CSBTCBMM
- TCB Mismatches
CSBTCBAF
- Attach Failures
CSBSYSW
- MVS Waits
CSBTWTTM
- Accumulated Time in MVS Wait
CSBTDTTM
- Accumulated Time Dispatched
CSBACTTM
- Accumulated Time / TCB
Calculations:
Percent TCB Utilization (%TCB UTIL) = (CSBACTTM / (CSBTWTTM+CSBTDTTM))
CICS TCB Pool Statistics Report section:
 
CSPTCBPN
- TCB Pool
CSPCNUAT
- Current TCBs attached in this TCB Pool
CSPPNUAT
- Peak TCBs attached in this TCB Pool
CSPMXTCB
- Max TCB Pool limit (MAXpoolTCBS)
CSPTOTNW
- Total Requests delayed by Max TCB Pool Limit
CSPTOTWL
- Total Max TCB Pool Limit delay time
CSPCURNW
- Current Requests delayed by Max TCB Pool Limit
CSPCURWT
- Current Max TCB Pool Limit delay time
CSPPEANW
- Peak Requests delayed by Max TCB Pool Limit
CSPCNUUS
- Current TCBs in use in this TCB Pool
CSPPNUUS
- Peak TCBs in use in this TCB Pool
CSPNTCBL
- Times at Max TCB Pool Limit (MAXpoolTCBS)
CSPMMWTS
- Total Number of TCB Mismatch waits
CSPMMWTM
- Total TCB Mismatch wait time
CSPMMWTS
- Current TCB Mismatch waits
CSPCMMWT
- Current TCB Mismatch wait time
CSPPMMWS
- Peak TCB Mismatch waits
CSPTOTMW
- Requests Delayed by MVS storage constraint
CSPTOTMT
- Total MVS storage constraint delay time
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 which 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 the contents of the 01 cycle.
ZONE
(Optional) Select one or more
MICS
time zones. Valid values are numbers 1 through 9.
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 about coding the exits, see CICS Changing Report Parameters.
The global exits are defined by macros in the source module CICRPTGL in sharedprefix.MICS.SOURCE. The following exits are available to this inquiry:
%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.

Daily CICS Dispatcher Statistics Report Sample Output

Part 1 of 4
 
Daily CICS Dispatcher Statistics Report FOR: January 30, 2017 INQUIRY: CICLX3 RUN DATE: ddmonyy SYSTEM ID: CAxx CICS APPLID: CICSCAAA INTERVAL START: 30JAN17:06:59:03.79 CICSID: CAAA CICS VERSION: 690 INTERVAL END : 30JAN17:07:59:12.00 Dispatcher Statistics --------------------------------------------- --------------------- Dispatcher Start Date and Time. . . . . . . : 30JAN17:06:59:03.7699 Address Space CPU Time. . . . . . . . . . . : 6.266228 Address Space SRB Time. . . . . . . . . . . : 0.304543 Current number of dispatcher tasks. . . . . : 25 Peak number of dispatcher tasks . . . . . . : 50 Current ICV time (msec) . . . . . . . . . . : 1000 Current ICVR time (msec). . . . . . . . . . : 5000 Current ICVTSD time (msec). . . . . . . . . : 0 Current PRTYAGE time (msec) . . . . . . . . : 1000 Current MRO (QR) Batching (MROBTCH) value . : 1 Last Excess TCB Scan. . . . . . . . . . . . : 30JAN17:07:59:06.4934 Number of Excess TCB Scans. . . . . . . . . : 12 Last Excess TCB Scan - No TCB Detached. . . : 30JAN17:07:59:06.4934 Excess TCB Scans - No TCB Detached. . . . . : 11 Number of Excess TCBs Detached. . . . . . . : 1 Average Excess TCBs Detached per Scan . . . : 0.08 Number of CICS TCB MODEs. . . . . . . . . . : 18 Number of CICS TCB POOLs. . . . . . . . . . : 4
Part 2 of 4
 
Daily CICS Dispatcher Statistics Report FOR: January 30, 2017 INQUIRY: CICLX3 RUN DATE: ddmonyy SYSTEM ID: CAxx CICS APPLID: CICSCAAA INTERVAL START: 30JAN17:06:59:03.79 CICSID: CAAA CICS VERSION: 690 INTERVAL END : 30JAN17:07:59:12.00 CICS TCB Mode Statistics TCB TCB < TCBs Attached > <- TCBs In Use -> TCB <- Dispatchable Queue -> Mode Open Pool Current Peak Current Peak Attaches Current Peak Average ------------------------------------------------------------------------------------------------- QR No N/A 1 1 1 1 1 1 46 1.00 RO No N/A 1 1 1 1 1 1 5 1.21 CO Unkn N/A 0 0 0 0 0 0 0 0.00 SZ Unkn N/A 0 0 0 0 0 0 0 0.00 RP Unkn N/A 0 0 0 0 0 0 0 0.00 FO No N/A 1 1 1 1 1 0 0 0.00 SL No N/A 1 1 1 1 1 0 0 0.00 SO No N/A 1 1 1 1 1 0 0 0.00 SP No N/A 1 1 1 1 1 0 0 0.00 EP No N/A 2 2 2 2 2 0 0 0.00 TP Unkn N/A 0 0 0 0 0 0 0 0.00 D2 Unkn N/A 0 0 0 0 0 0 0 0.00 S8 Yes SSL 1 1 0 1 1 0 0 0.00 L8 Yes OPEN 3 4 1 4 4 0 0 0.00 L9 Unkn N/A 0 0 0 0 0 0 0 0.00 X8 Unkn N/A 0 0 0 0 0 0 0 0.00 X9 Unkn N/A 0 0 0 0 0 0 0 0.00 T8 Unkn N/A 0 0 0 0 0 0 0 0.00 ------------------------------------------------------------------------------------------------- Totals 12 9 13 TCB TCB < TCBs Attached > <- TCBs In Use -> TCB Detached Detached Detached Detached TCB TCB Mode Open Pool Current Peak Current Peak Attaches Unclean Stolen Excess Other Steals Mismatches ---------------------------------------------------------------------------------------------------------------------------------- QR No N/A 1 1 1 1 1 0 0 0 0 0 0 RO No N/A 1 1 1 1 1 0 0 0 0 0 0 CO Unkn N/A 0 0 0 0 0 0 0 0 0 0 0 SZ Unkn N/A 0 0 0 0 0 0 0 0 0 0 0 RP Unkn N/A 0 0 0 0 0 0 0 0 0 0 0 FO No N/A 1 1 1 1 1 0 0 0 0 0 0 SL No N/A 1 1 1 1 1 0 0 0 0 0 0 SO No N/A 1 1 1 1 1 0 0 0 0 0 0 SP No N/A 1 1 1 1 1 0 0 0 0 0 0 EP No N/A 2 2 2 2 2 0 0 0 0 0 0 TP Unkn N/A 0 0 0 0 0 0 0 0 0 0 0 D2 Unkn N/A 0 0 0 0 0 0 0 0 0 0 0 S8 Yes SSL 1 1 0 1 1 0 0 0 0 0 0 L8 Yes OPEN 3 4 1 4 4 0 0 1 0 0 0 L9 Unkn N/A 0 0 0 0 0 0 0 0 0 0 0 X8 Unkn N/A 0 0 0 0 0 0 0 0 0 0 0 X9 Unkn N/A 0 0 0 0 0 0 0 0 0 0 0 T8 Unkn N/A 0 0 0 0 0 0 0 0 0 0 0 ---------------------------------------------------------------------------------------------------------------------------------- Totals 12 9 13 0 0 1 0 0 0
Part 3 of 4
 
Daily CICS Dispatcher Statistics Report FOR: January 30, 2017 INQUIRY: CICLX3 RUN DATE: ddmonyy SYSTEM ID: CAxx CICS APPLID: CICSCAAA INTERVAL START: 30JAN17:06:59:03.79 CICSID: CAAA CICS VERSION: 690 INTERVAL END : 30JAN17:07:59:12.00 CICS TCB Mode Statistics TCB < TCBs Attached > TCB Attach MVS Accumulated Accumulated Accumulated %TCB Mode Current Peak Attaches Failures Waits Time in MVS wait Time Dispatched Time / TCB Util ------------------------------------------------------------------------------------------------------------------------------- QR 1 1 1 0 5938 0:59:53.145209 0:00:15.061145 0:00:04.403157 .1220% RO 1 1 1 0 316 0:07:11.707090 0:00:07.295657 0:00:01.002615 .2284% CO 0 0 0 0 0 0:00:00.000000 0:00:00.000000 0:00:00.000000 .0000% SZ 0 0 0 0 0 0:00:00.000000 0:00:00.000000 0:00:00.000000 .0000% RP 0 0 0 0 0 0:00:00.000000 0:00:00.000000 0:00:00.000000 .0000% FO 1 1 1 0 75 0:00:17.852619 0:00:00.643127 0:00:00.154428 .8349% SL 1 1 1 0 15 0:31:28.509503 0:00:00.009159 0:00:00.005490 .0003% SO 1 1 1 0 17 0:00:17.457707 0:00:00.113210 0:00:00.036176 .2059% SP 1 1 1 0 2 0:00:00.001951 0:00:00.033960 0:00:00.000330 .9201% EP 2 2 2 0 4 0:00:00.149596 0:00:00.000084 0:00:00.000155 .1038% TP 0 0 0 0 0 0:00:00.000000 0:00:00.000000 0:00:00.000000 .0000% D2 0 0 0 0 0 0:00:00.000000 0:00:00.000000 0:00:00.000000 .0000% S8 1 1 1 0 2 0:00:00.000141 0:00:00.320922 0:00:00.000325 .1013% L8 3 4 4 0 379 2:34:54.784554 0:00:00.142754 0:00:00.114847 .0012% L9 0 0 0 0 0 0:00:00.000000 0:00:00.000000 0:00:00.000000 .0000% X8 0 0 0 0 0 0:00:00.000000 0:00:00.000000 0:00:00.000000 .0000% X9 0 0 0 0 0 0:00:00.000000 0:00:00.000000 0:00:00.000000 .0000% T8 0 0 0 0 0 0:00:00.000000 0:00:00.000000 0:00:00.000000 .0000% ------------------------------------------------------------------------------------------------------------------------------- Totals 12
Part 4 o 4
 
Daily CICS Dispatcher Statistics Report FOR: January 30, 2017 INQUIRY: CICLX3 RUN DATE: ddmonyy SYSTEM ID: CAxx CICS APPLID: CICSCAAA INTERVAL START: 30JAN17:06:59:03.79 CICSID: CAAA CICS VERSION: 690 INTERVAL END : 30JAN17:07:59:12.00 CICS TCB Pool Statistics TCB Pool. . . . . . . . . . . . . . . . . . . . : OPEN Current TCBs attached in this TCB Pool. . . . . : 3 Current TCBs in use in this TCB Pool. . . . . . : 1 Peak TCBs attached in this TCB Pool . . . . . . : 4 Peak TCBs in use in this TCB Pool . . . . . . . : 4 Max TCB Pool limit (MAXOPENTCBS). . . . . . . . : 152 Times at Max TCB Pool Limit (MAXOPENTCBS) . . . : 0 Total Requests delayed by Max TCB Pool Limit. . : 0 Total Number of TCB Mismatch waits. . . . . . . : 0 Total Max TCB Pool Limit delay time . . . . . . : 0:00:00.0000 Total TCB Mismatch wait time. . . . . . . . . . : 0:00:00.0000 Current Requests delayed by Max TCB Pool Limit. : 0 Current TCB Mismatch waits. . . . . . . . . . . : 0 Current Max TCB Pool Limit delay time . . . . . : 0:00:00.0000 Current TCB Mismatch wait time. . . . . . . . . : 0:00:00.0000 Peak Requests delayed by Max TCB Pool Limit . . : 0 Peak TCB Mismatch waits . . . . . . . . . . . . : 0 Requests Delayed by MVS storage constraint. . . : 0 Total MVS storage constraint delay time . . . . : 0:00:00.0000