Previous Topic: 3.1.1.27 CICLME: Monthly CICS Service Summary Report

Next Topic: 3.1.2 Workload Analysis Inquiries

3.1.1.28 CICLMF: Monthly CICS Service Detail Report


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