The Monthly CICS Service Detail Report shows the CICS service
provided to individual applications on a given day. It
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 may 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.
A sample output of this inquiry is shown by Figure 3-15.
Each field in this report is described below:
SYSTEM SUMMARY:
SLO MET: A flag indicating whether or not the service
level objective has been 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
meets 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 transactions processed,
excluding those 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 The response distributions for the 7 response
DISTRIBU- thresholds which you have specified in
TION 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
CA 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
processed for this application.
MAX RESP: The maximum response time 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 The average dispatch time for the application.
DISPATCH:
AVG CPU: The average TCB 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 suspend time for the application.
%WAIT The percentage of time the application spent
FC: waiting for file control.
%WAIT The percentage of time the application spent
JC: waiting for journal control.
%WAIT The percentage of time the application spent
TC: waiting for terminal control.
%WAIT The percentage of time the application spent
TS: waiting for temporary storage.
%WAIT The percentage of time the application spent
OTH: waiting for other reasons, such as waiting for
data base management systems (DB2, IMS) or buffer
and strings.
%TRANS The percentage of transactions processed for this
SOS: application during short-on-storage condition.
%TRANS The percentage of transactions processed for this
MXTSK: application when CICS was at maximum task.
%TRANS The percentage of transactions processed for this
VIOL application that had a storage violation.
%TRANS The percentage of transactions abend for this
ABND: 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 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.
%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 DETAIL REPORT your_company_name FOR AUGUST, 1991 INQUIRY: CICLMF RUN DATE: 06SEP91 ----------------------------------------------------- SYSID=PRD2 CICSID=LCP1 ----------------------------------------------------- AVG MAX RESP %OBJ AVG AVG AVG AVG ----- % WAIT ------ ----- %TRANS ------ APPL RESP RESP OBJ MET TRANS DISPCH CPU WAIT SUSP FC JC TC TS OTH SOS MXTSK VIOL ABND AAON 34.10 34.10 15.00 100.0 1 0.36 0.08 33.74 0.00 0 0 0 0 100 0 0 0 0 ACFM 0.02 0.13 15.00 100.0 163 0.02 0.01 53.56 53.55 0 0 100 0 0 0 0 0 0 CATD 0.07 3.80 15.00 100.0 15,759 0.02 0.01 0.06 0.00 0 0 0 0 100 0 0 0 0 CCMF 0.00 0.04 15.00 100.0 233 0.00 0.00 0.00 0.00 0 0 0 0 100 0 0 0 0 CEDA 0.20 2.55 15.00 100.0 21 0.05 0.01 5.14 4.99 3 0 97 0 0 0 0 0 0 CEMT 0.07 0.57 15.00 100.0 10 0.05 0.01 6.56 6.54 0 0 100 0 0 0 0 0 0 CRSQ 0.27 0.80 15.00 100.0 3 0.00 0.00 0.27 0.00 0 0 0 0 100 0 0 0 0 CRSR 0.02 2.91 15.00 100.0 29,214 0.00 0.00 0.02 0.00 0 0 0 0 100 0 0 0 0 CRTE 0.02 1.80 15.00 100.0 691 0.00 0.00 33.38 33.36 0 0 100 0 0 0 0 0 0 CSAC 0.00 0.06 15.00 100.0 350 0.00 0.00 0.00 0.00 0 0 71 0 29 0 0 0 0 CSFU 0.83 0.83 15.00 100.0 1 0.01 0.01 0.81 0.00 0 0 0 0 100 0 0 0 0 CSGM 0.03 3.93 15.00 100.0 16,516 0.01 0.00 0.03 0.01 0 0 26 0 74 0 0 0 0 CSIR 47.96 64.34 15.00 42.6 61 0.00 0.00 47.95 0.00 0 0 0 0 100 0 0 0 0 CSMI 0.01 0.11 15.00 100.0 11 0.01 0.00 0.01 0.00 0 0 0 0 100 0 0 0 0 CSNE 0.00 0.16 15.00 100.0 23,797 0.00 0.00 0.00 0.00 0 0 0 0 100 0 0 0 0 CSSF 0.01 0.18 15.00 100.0 38 0.01 0.00 0.34 0.33 0 0 98 0 2 0 0 0 0 CSSN 0.03 0.07 15.00 100.0 6 0.01 0.00 0.02 0.01 0 0 26 0 74 0 0 0 0 DATA 0.14 20.19 15.00 100.0 14,588 0.01 0.00 0.15 0.01 0 0 10 0 90 0 0 0 0 DISP 0.03 0.03 15.00 100.0 1 0.03 0.02 0.00 0.00 0 0 83 0 17 0 0 0 100 D2DA 1.42 7.37 15.00 100.0 15 0.01 0.00 1.70 0.30 0 0 18 0 82 0 0 0 0 ELON 0.24 1.01 15.00 100.0 10 0.04 0.01 0.44 0.23 0 0 53 0 47 0 0 0 10 EL00 0.06 0.31 15.00 100.0 40 0.00 0.00 0.06 0.00 0 0 0 0 100 0 0 0 0 EL10 0.04 0.12 15.00 100.0 9 0.00 0.00 0.03 0.00 0 0 0 0 100 0 0 0 0 EL20 0.15 1.07 15.00 100.0 41 0.00 0.00 0.15 0.00 0 0 0 0 100 0 0 0 0 EL22 0.14 0.80 15.00 100.0 50 0.00 0.00 0.13 0.00 0 0 0 0 100 0 0 0 0 EL29 0.11 0.44 15.00 100.0 21 0.00 0.00 0.30 0.19 0 0 64 0 36 0 0 0 0 EL30 0.07 0.38 15.00 100.0 14 0.00 0.00 0.07 0.00 0 0 0 0 100 0 0 0 0 EZ 0.46 3.99 15.00 100.0 324 0.00 0.00 0.46 0.00 0 0 0 0 100 0 0 0 0 IEOL 0.25 88.32 15.00 99.9 1,346 0.01 0.00 0.25 0.00 0 0 1 0 99 0 0 0 0 LLTP 0.01 0.01 15.00 100.0 1 0.00 0.00 0.01 0.00 0 0 25 0 75 0 0 0 100 LLXW 0.04 0.11 15.00 100.0 4 0.02 0.01 0.02 0.00 0 0 15 0 85 0 0 0 100 LPKD 0.00 0.01 15.00 100.0 3 0.00 0.00 0.00 0.00 0 0 0 0 100 0 0 0 0 LPKE 0.00 0.00 15.00 100.0 12 0.00 0.00 0.00 0.00 0 0 0 0 100 0 0 0 0 MSAS 0.17 1.19 15.00 100.0 69 0.00 0.00 0.17 0.00 0 0 0 0 100 0 0 0 0 MSA2 0.13 5.68 15.00 100.0 3,240 0.00 0.00 0.18 0.06 0 0 32 0 68 0 0 0 0 SA 0.48 8.66 15.00 100.0 39 0.04 0.00 388.03 387.59 1 0 99 0 0 0 0 0 3 STAR 0.00 0.01 15.00 100.0 21 0.00 0.00 0.00 0.00 0 0 32 0 68 0 0 0 5 TOSC 0.13 41.33 15.00 100.0 344,062 0.00 0.00 0.24 0.12 0 0 49 0 51 0 0 0 0 TOSS 0.40 32.06 15.00 100.0 2,558 0.04 0.01 0.40 0.04 0 0 8 0 92 0 0 0 0 TOS1 0.38 30.17 15.00 100.0 8,580 0.04 0.01 0.39 0.05 0 0 12 0 88 0 0 0 0 TOTAL: 0.12 3.72 15.00 100.0 469,835 0.00 0.00 0.03 0.22 0 0 65 0 35 0 0 0 0
Figure 3-15. Monthly CICS Service Detail Report Sample Output
| Copyright © 2012 CA. All rights reserved. | Tell Technical Publications how we can improve this information |