Previous Topic: 3.1.3.2 CICLMP: Monthly CICS Performance Summary Report

Next Topic: 3.1.4 Availability Analysis Inquiries

3.1.3.3 CICLWP: Weekly CICS Performance Summary Report


The Weekly CICS Performance Summary Report shows the
workload, service, and percent availability of each CICS
region in a given week.  The report also shows the
occurrences of abnormal conditions that impact CICS
performance, such as high number of program compressions,
short-on-storage, and maximum tasks conditions.  Once a
problem has been detected using this report, you can then
select one of the detail reports in the service or workload
area to further investigate the cause of the problem.


REPORT FORMAT:

This inquiry produces a tabular report which provides a
summary line for each CICS region found in input.  In
addition, the report provides a summary line for overall CICS
performance for the enterprise (summed across SYSIDs and
CICSs), as well as CICS performance at the system level
(summarized by SYSID).  A sample output of this inquiry is
shown in Figure 3-34.  Each field in the report is described
below:

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.

AVG RESP:   The average response time for all transactions,
            excluding those assigned as TRANTYPE X in your
            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.

%AVAIL:     The CICS availability expressed in a percentage.
            This number is derived by dividing the total CICS
            uptime by the total report duration.

CPU TOTAL:  The total amount of TCB and SRB time consumed.
            This also includes subtask time for CMF.

CPU         Percentage of total CPU time consumed by user
%USER:      transactions.

CPU         Percentage of total CPU time consumed by task
%KCP:       control (system overhead).

CPU         Percentage of total CPU time consumed by journal
%JCP:       control (system overhead).

CPU         Percentage of total CPU time consumed by terminal
%TCP:       control (system overhead).

CPU         Percentage of SRB time out of total CPU time.
%SRB:

CPU         Percentage of subtask time out of total CPU time.
%SUB:

DSA SIZE:   The size of CICS dynamic storage area as defined
            in the SIT (system initialization table).

DSA HWM:    The maximum dynamic storage area used.

COMPRS:     The number of program compressions performed.

SOS:        The number of time CICS experienced short-on-
            storage condition due to release of the storage
            cushion.

MAXTASK:    The number of time CICS experienced MAXTASK
            conditions and stopped initiating new tasks.

VIOL:       The number of transactions with storage
            violation.

% ABND:     The percentage of transactions that abended for
            this application.

INQUIRY ID:

     CICLWP (tabular report)

DATA SOURCE (file/timespan):

     CICCSY01 in the WEEKS timespan.

DATA ELEMENTS USED:

     CICSID   - CICS System Identifier
     CSYABEND - Abnormal Terminations
     CSYADSTM - Total Address Space Time
     CSYCPUTM - Total CPU Time
     CSYDAMSC - Storage Violations
     CSYDSASZ - DSA Size
     CSYETRN  - Excluded transactions
     CSYMEMSZ - DSA High Water Mark
     CSYMXTSK - Max Task Conditions
     CSYPCMDC - Number of Program Compressions
     CSYSOS   - Short-on-storage Conditions
     CSYSRBTM - SRB Time
     CSYTCPTM - Terminal Control CPU Time
     CSYTCUTM - User CPU Time
     CSYCPJTM - JCP CPU Time
     CSYTRANS - Transactions Processed
     CSYTRSTM - Transaction Response Time Total
     CSYTSRTM - Task Control CPU Time
     CSYUPTM  - CICS Availability Time
     MONTH    - Month of Year
     YEAR     - Year of Century
     ZONE     - Time Zone
     SYSID    - System Identifier

   CALCULATIONS:

     Average response time = CSYTRSTM/CSYTRANS
     Percent abend = CSYABEND/SUM(CSYTRANS,CSYETRN)
     Percent availability = CSYUPTM/calculated up time
     Percent user CPU = CSYTCUTM/CSYADSTM*100
     Percent KCP CPU = CSYTSRTM/CSYADSTM*100
     Percent JCP CPU = CSYCPJTM/CSYADSTM*100
     Percent TCP CPU = CSYTCPTM/CSYADSTM*100
     Percent SRB CPU = CSYSRBTM/CSYADSTM*100
     Percent SUB CPU = (CSYADSTM-CSYTCBTM)/CSYADSTM*100

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 start of the report period in
              ddmmmyy format.

              For this inquiry, the default is the previous
              week.

     ZONE   - Optionally, select one or more CA 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 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:

     %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.

WEEKLY CICS PERFORMANCE SUMMARY REPORT your_company_name FOR WEEK STARTING MARCH 05, 2007 INQUIRY: CICLWP RUN DATE: 16MAR07 AVG % % % % -------------- CPU -------------- % SYSID CICSID RESP TRANS SHORT MED LONG CONV TOTAL %USER %KCP %SRB %SUB COMPRS SOS MAXTSK VIOL ABND *ALL *ALL 0.32 644,528 56 0 36 8 1:42 57 13 14 16 0 0 62 0 0 PRD2 *ALL 0.32 644,528 56 0 36 8 1:42 57 13 14 16 0 0 62 0 0 LCP1 0.12 469,815 77 0 14 9 0:43 51 13 19 17 0 0 61 0 0 RCP1 0.13 77,933 1 0 91 8 0:17 51 13 19 17 0 0 0 0 0 RCP2 0.34 68,652 0 0 99 1 0:19 72 11 4 13 0 0 0 0 0 RCP3 0.26 2,606 29 0 51 19 0:01 59 13 8 20 0 0 0 0 0 TCP4 0.61 24,056 0 0 96 4 0:20 65 11 8 17 0 0 1 0 0 TCT2 0.27 1,288 0 0 60 40 0:01 26 41 18 15 0 0 0 0 0 TCT7 563.10 178 0 0 4 96 0:00 25 43 14 18 0 0 0 0 0 TOTAL # REGIONS: 7

 Figure 3-34. Weekly CICS Performance Summary Report Sample Output