CICLMH Monthly CICS Workload Ranking Report

The Monthly CICS Workload Ranking inquiry produces tabular reports that identify the top 10 CICS applications in transaction volume.
micsrm140
Report format
 
This inquiry produces a tabular report which contains a summary section and a ranking section. The summary section shows the total workload and the peak hour workload. The ranking section identifies the 10 applications with the highest transaction volume and provides other pertinent information such as response time, CPU time, data base calls, character traffic, and storage usage.
A sample output of this inquiry is shown in the following section Monthly CICS Workload Ranking Report Sample Output. Each field in this report is described below:
System summary
 
# REGIONS
Total number of SYSID/CICSID combinations found in input.
TRANS
The total number of transactions processed. For TYPE=ALL, this number excludes transaction type X (TRANTYPE=X as assigned by the CICRLRT exit).
%SHORT
The percentage of short transactions processed.
%MED
The percentage of medium transactions processed.
%LONG
The percentage of long transactions processed.
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.
PEAK HOUR
The hour during which CICS processed the highest number of transactions.
PEAK TRAN
The total number of transactions processed during peak hour, excluding transaction type X.
PEAK CPU
The total TCB CPU time consumed during peak hour.
PEAK RESP
The peak average hourly response time provided by CICS.
Ranking section
 
RANK
The ranking, number 1 through 10, in transaction volume.
APPL
Application identification.
TRANS
The total number of transactions processed for the application.
AVG RESP
The average response time for all transactions processed for this application.
TOTAL CP CPU
The total CP CPU time consumed by this application.
TOTAL SPEC CPU
The total zIIP 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.
TOT CHARS
The total number of input and output characters generated by this application.
MAX STORAGE
The maximum amount (in 1024 bytes) of terminal and user storage used by this application.
AVERAGE CP CPU
The average CP CPU per transaction consumed by this application.
AVERAGE SPEC CPU
The average zIIP CPU per transaction consumed by this application.
AVERAGE FC CALLS
The average number of file control calls per transaction issued by this application.
AVERAGE DBMS CALLS
The average number of data base (DB2 and IMS) calls per transaction issued by this application.
AVERAGE CHAR
The average number of input and out characters per transaction generated by this application.
AVERAGE STORAGE
The average amount of dynamic storage (terminal and user) per transaction consumed by this application.
% ABND
The percentage of transactions that abended for this application.
Inquiry ID
 
CICLMH (tabular report)
Data source (file/timespan)
 
CICCAU01 in the DAYS 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.
One graph is produced for each date and each combination of SYSID/CICSID.
Data elements used
 
CAUABEND
- Abnormal Termination Occurrences
CAUCPUTM
- Task CPU Time
CAUCRSTM
- Conv. Transaction Response Time
CAUCTRN
- Conv. Transactions Processed
CAUDLICC
- Number of CICS DL/I Calls
CAUETRN
- Excluded Transactions
CAUFCOPS
- Number of CICS File Control Calls
CAUINCH
- Input Message Character Traffic
CAULRSTM
- Long Transaction Response Time
CAULTRN
- Long Transactions Processed
CAUMEMRC
- Memory Usage Running Count
CAUMRSTM
- Medium Transaction Response Time
CAUMTRN
- Medium Transactions Processed
CAUMXMEM
- Maximum Transaction Storage Used
CAUNZZTM
- Normalized zIIP CPU Time
CAUOUTCH
- Output Message Character Traffic
CAUSQLTO
- Total number of SQL Calls
CAUSRSTM
- Short Transaction Response Time
CAUSTRN
- Short Transactions Processed
CAUTRANS
- Transactions Processed
CAUTRSTM
- Transaction Response Time Total
CAUZPTRN
- zIIP CPU Transactions Processed
CICAPU
- CICS Application Unit ID
CICPCT01
- Accumulated User Counter
CICSID
- CICS System Identifier
DAY
- Day of Month
DURATION
- Recording Interval Time
MONTH
- Month of Year
YEAR
- Year of Century
ZONE
- Time Zone
SYSID
- System Identifier
Calculations
 
Average character = SUM(CAUINCH,CAUOUTCH)/SUM(CAUTRANS,CAUETRN) Average file control calls = CAUFCOPS/SUM(CAUTRANS,CAUETRN) Average response time = CAUTRSTM/CAUTRANS Average storage = (CAUMEMRC/SUM(CAUTRANS,CAUETRN))/1024 Average CP time = CAUCPUTM/SUM(CAUTRANS,CAUETRN) Average SPEC time (zIIP time) = CAUNZZTM/CAUZPTRN Average DBMS calls = SUM(CAUDLICC,CAUSQLTO,CICPCT01)/SUM(CAUTRANS,CAUETRN) DBMS calls = SUM(CAUDLICC,CAUSQLTO,CICPCT01) Maximum storage = CAUMXMEM/1024 Peak transaction rate = CSYTRANS/DURATION Peak response time = CSYTRSTM/CSYTRANS Percent abend = CAUABEND/SUM(CAUTRANS,CAUETRN) Percent conv. = CSYCTRN/CSYTRANS * 100 Percent long = CSYLTRN/CSYTRANS * 100 Percent medium = CSYMTRN/CSYTRANS * 100 Percent short = CSYSTRN/CSYTRANS * 100 Total characters (in thousands) = SUM(CAUINCH,CAUOUTCH)/1000
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.
MONTH
(Optional) Enter the month (mm) and year (yy) to be reported.
For this inquiry, the default is previous month.
ZONE
(Optional) Select one or more
MICS
time zones. Valid values are numbers 1 through 9.
TRAN
(Optional) Select the type of transaction to be ranked. The response types are TOTAL, SHORT, MED, LONG, or CONV. The default is TOTAL.
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:
%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.
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 Workload Ranking Report Sample Output

MONTHLY CICS WORKLOAD RANKING REPORT your_company_name FOR AUGUST, yyyy INQUIRY: CICLMH RUN DATE: 06SEPyy SYSTEM SUMMARY: 7 REGIONS # TRANSACTIONS % % % % AVG TRANS/ (000) SHORT MED LONG CONV RESP SEC 644,528 56.3 0.0 36.0 7.7 0.32 1.6 ** TOP 10 APPLICATIONS IN TOTAL TRANSACTION VOLUME TOTAL AVG -- TOTAL CPU -- FL CNTL DBMS TOT CHARS MAX ------------------ AVERAGES ----------------- % RNK APPL TRANS RESP CP SPEC CALLS CALLS (000) STOR CPU -CP -SPEC FC CL DBMS CL CHAR STORAGE ABND 1 TOSC 344,062 0.13 0:11 0:01 42 0 416132 8K 0.00 0.00 0 0 1209 8K 0 2 CRSR 29,214 0.02 0:01 0:00 0 0 0 11K 0.00 0.00 0 0 0 11K 0 3 CSNE 26,610 0.02 0:01 0:00 0 0 45 33K 0.00 0.00 0 0 2 30K 0 4 PUBC 24,221 0.15 0:04 0:00 48134 0 26592 23K 0.01 0.00 2 0 1098 28K 0 5 ISHD 23,006 0.62 0:12 0:01 29458 0 29997 184K 0.03 0.00 1 0 1304 279K 0 6 CSGM 17,561 0.03 0:01 0:00 84 0 16785 8K 0.00 0.00 0 0 956 9K 0 7 CATD 17,344 0.09 0:02 0:00 0 0 0 23K 0.01 0.00 0 0 0 300K 0 8 DATA 16,126 0.15 0:01 0:00 6900 0 10762 1448K 0.00 0.00 0 0 667 20K 0 9 PUSC 15,199 0.04 0:02 0:00 14299 0 15168 92K 0.01 0.00 1 0 998 36K 0 10 PIBC 10,675 0.13 0:02 0:00 17170 0 11801 13K 0.01 0.00 2 0 1105 25K 0