Previous Topic: 3.1.7 CICS Transaction Gateway Inquiries

Next Topic: 3.2 Changing Report Parameters

3.1.7.1 CICLDG: CICS Transaction Gateway Daily Throughput


The CA MICS CICS Transaction Gateway Daily Throughput
inquiry, CICLDG, provides both summary and detailed reports
of CICS Transaction Gateway (CTG) throughput.
 
The summary report is generated first.  It shows the overall
daily request throughput, request data volume, processing
throughput rate, and average transaction response time for
each CTG.  The summary data is organized by z/OS SYSID so
that overall throughput can be easily seen for each
individual CTG by z/OS system.
 
The detail report follows and generates a report page for
each CTG.  The same data seen in the summary report is
displayed for the CTG at the hourly level.
 
Both the summary and detail reports show throughput metrics
in two groups:
 
o The first group of metrics provides information about
  Gateway daemon throughput and response time.
 
o The second group of metrics provides information about
  CICS region throughput and response time for CTG requests.
REPORT FORMAT:
 
The format of the summary and detail report sections are
described below.
SUMMARY REPORT
--------------
The summary report header displays the report inquiry name,
run date, report title, summarization level, and the date
being reported. If a particular ZONE was requested for the
report, the ZONE value and ZONE descriptive name are
displayed.
 
The summary report body displays the following measurements
from left to right:
 
o System Identification                   - SYSID
o CICS Transaction Gateway ID             - CTGID
Gateway daemon statistics are presented next, beginning with
the number of client transactions processed, megabytes of
data for both requests and responses, the number of
transactions processed per second, and the average
transaction response time:
 
o Client Requests Processed               - GSAGREQP
o Client Request MB Data                  - GSACLRQD
o Client Response MB Data                 - GSACLRSD
o Client Requests per Second              - GSAPSGTW
o Average Client Request Response Time    - GSAAVGTM
CICS region statistics are presented next, beginning with the
number of CICS transactions processed, megabytes of data for
both requests and responses, the number of transactions
processed per second, and the average request transaction
response time:
 
o CICS Requests Processed                 - GSACREQP
o CICS Request MB Data                    - GSACIRQD
o CICS Response MB Data                   - GSACIRSD
o CICS Requests per Second                - GSAPSCIC
o Average CICS Request Response Time      - GSAAVCTM
If multiple CTGIDs are found for a single SYSID, a total
line will appear that provides z/OS system level totals for
all CTGIDs on the system.
 
Note: If the CTGIDs for a system continue onto a second page,
the SYSID value will have an asterisk (*) next to it to
indicate the continuation.
DETAIL REPORT
-------------
The summary report displayed one line for each CTG, showing a
days worth of throughput information. The detail report
presents a page of data for each CTG, with the same
statistics reported at the hourly level.
 
The detail report header displays the report inquiry name,
run date, report title, summarization level, and the date
being reported. If a particular ZONE was requested for the
report, the ZONE value and ZONE descriptive name are
displayed.
Next, the detail report header provides additional
information about the CTG being reported:
 
o System Identification                   - SYSID
o CICS Transaction Gateway ID             - CTGID
o CICS Transaction Gateway APPLID         - CTGAPPL
o CTG Release Level                       - CTGRLVL
The detail report body displays the following measurements
from left to right:
 
o Day of week                             - from ENDTS
o Hour of day                             - HOUR
 
Gateway daemon statistics are presented next, beginning with
the number of client transactions processed, megabytes of
data for both requests and responses, the number of
transactions processed per second, and the average
transaction response time:
 
o Client Requests Processed               - GSAGREQP
o Client Request MB Data                  - GSACLRQD
o Client Response MB Data                 - GSACLRSD
o Client Requests per Second              - GSAPSGTW
o Average Client Request Response Time    - GSAAVGTM
Next, CICS region statistics are presented beginning with the
number of CICS transactions processed, megabytes of data for
both requests and responses, the number of transactions
processed per second, and the average request transaction
response time:
 
o CICS Requests Processed                 - GSACREQP
o CICS Request MB Data                    - GSACIRQD
o CICS Response MB Data                   - GSACIRSD
o CICS Requests per Second                - GSAPSCIC
o Average CICS Request Response Time      - GSAAVCTM
 
At the bottom of the detail report, a line is generated that
shows summary totals, minimums, maximums, averages, or
percentages, as appropriate for the hourly data in each
column.
INQUIRY ID:
 
     CICLDG (printer graphic format)
 
DATA SOURCE (file/timespan):
 
     CTGGSA at the DAYS timespan
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 report will
              include data from all SYSIDs in the input file.

     CTGID  - Optionally, specify the CTGID to be reported.
              If no value is specified, all Transaction
              Gateways in the input file will be included in
              the report.
     DATE   - Optionally, enter the date to be reported in
              ddmmmyy format.
 
              For this inquiry, the default is the data
              contained in the DAYS timespan 01 cycle, which
              is generally data from yesterday.

     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 for this inquiry:

     %GCTG  -  Select CTGIDs for report.

     %GSYS  -  Select SYSIDs for report.
A sample output of this inquiry, where data for ZONE=1 was
selected, is shown in Figure 3-54.

Inquiry : CICLDG CA MICS - CICS Transaction Gateway Daily Throughput Summary Page 001 Run Date: 27JANyy Data Summarized by CTGID and DAY Report Start: 26JANyy:07:59 Reporting on ZONE 1 - PRIME TIME REPORT PAGE: Data for Date=26JANyy Report End : 26JANyy:16:59 ---------------------------------------------------------------------------------------------------------------------------------- +------------- Gateway Daemon Activity ------------+ +-------------- CICS Server Activity --------------+ | | | | Client Client Client Client Client CICS CICS CICS CICS CICS Requests Request Resp Request Avg Resp Requests Request Resp Request Avg Resp SYSID CTGID Processed MB Data MB Data per/sec Time Processed MB Data MB Data per/sec Time ----- ---- --------- ------- ------- ------- -------- --------- ------- ------- ------- -------- SYS1 GTP0 119794 2875.80 2861.28 3.697 0.1268 119794 2862.53 2862.24 3.697 0.1227 GTP1 146823 3484.11 3466.19 4.532 0.1295 146823 3467.86 3467.25 4.532 0.1257 GTP2 91381 940.79 876.79 2.820 0.1120 91381 930.65 930.57 2.820 0.1101 GTP3 107977 1207.31 1134.22 3.333 0.0980 107977 1195.35 1195.31 3.333 0.0959 GTP5 1296 9.67 9.56 0.040 0.2282 1296 9.48 9.48 0.040 0.2184 GTP6 2625 18.56 18.35 0.081 0.2279 2625 18.19 18.19 0.081 0.2204 ----- ---- --------- ------- ------- ------- -------- --------- ------- ------- ------- -------- Total *ALL* 469896 8536.24 8366.39 14.503 0.1190 469896 8484.06 8483.04 14.503 0.1158 SYS2 GTS0 204 2.49 2.23 0.007 1.6213 204 2.46 1.00 0.007 1.5368 GTU1 64673 988.84 972.44 1.996 0.1765 64673 981.42 954.33 1.996 0.1750 ----- ---- --------- ------- ------- ------- -------- --------- ------- ------- ------- -------- Total *ALL* 64877 991.33 974.67 2.003 0.1811 64877 983.88 955.33 2.003 0.1793 SYS3 GTP0 167836 3808.77 3786.12 5.180 0.1283 167836 3790.20 3789.73 5.180 0.1246 GTP1 166221 3951.78 3932.20 5.130 0.1336 166221 3933.38 3932.92 5.130 0.1300 GTP2 105042 1252.70 1178.66 3.242 0.1339 105042 1241.05 1241.02 3.242 0.1318 GTP3 103851 1229.55 1146.53 3.205 0.1153 103851 1218.03 1217.98 3.205 0.1134 GTP5 1217 4.35 4.24 0.038 0.3950 1217 4.16 4.16 0.038 0.3939 GTP6 2235 20.91 20.73 0.069 0.1226 2235 20.60 20.60 0.069 0.1202 ----- ---- --------- ------- ------- ------- -------- --------- ------- ------- ------- -------- Total *ALL* 546402 10268.1 10068.5 16.864 0.1291 546402 10207.4 10206.4 16.864 0.1261 SYS4 TGA0 35159 481.53 430.64 1.116 0.0741 35159 476.99 476.84 1.116 0.0731 TGE0 1 0.00 0.00 0.000 6.1920 1 0.00 0.00 0.000 5.6440 TGT0 10 0.07 0.07 0.000 1.1803 10 0.07 0.07 0.000 1.0568 ----- ---- --------- ------- ------- ------- -------- --------- ------- ------- ------- -------- Total *ALL* 35170 481.60 430.71 1.117 0.0746 35170 477.06 476.91 1.117 0.0735 ----------------------------------------------------------------------------------------------------------------------------------


Inquiry : CICLDG CA MICS - CICS Transaction Gateway Daily Throughput Detail Page 001 Run Date: 27JANyy Data Presented by HOUR for each CTGID Report Start: 26JANyy:07:59 Reporting on ZONE 1 - PRIME TIME REPORT PAGE: Data for Date=26JANyy Report End : 26JANyy:16:59 SYSID : SYS1 Gateway ID: GTP0 APPLID: CICSTGP0 Release Level: 7.1.0 ---------------------------------------------------------------------------------------------------------------------------------- +------------- Gateway Daemon Activity ------------+ +-------------- CICS Server Activity --------------+ | | | | Day Client Client Client Client Client CICS CICS CICS CICS CICS of Requests Request Resp Request Avg Resp Requests Request Resp Request Avg Resp Week HOUR Processed MB Data MB Data per/sec Time Processed MB Data MB Data per/sec Time ---- ---- --------- ------- ------- ------- -------- --------- ------- ------- ------- -------- Tue 8 5499 131.08 130.28 1.527 0.1496 5499 130.47 130.47 1.527 0.1458 9 9817 234.38 233.07 2.727 0.1590 9817 233.29 233.00 2.727 0.1551 10 9739 238.35 237.33 2.705 0.1303 9739 237.27 237.27 2.705 0.1266 11 19523 480.52 478.18 5.423 0.1231 19523 478.33 478.33 5.423 0.1191 12 22538 550.99 548.51 6.261 0.1139 22538 548.50 548.50 6.261 0.1099 13 12074 275.78 274.12 3.354 0.1326 12074 274.47 274.47 3.354 0.1290 14 10721 244.90 243.47 2.978 0.1215 10721 243.71 243.71 2.978 0.1176 15 16111 378.98 376.99 4.475 0.1384 16111 377.20 377.20 4.475 0.1339 16 13772 340.81 339.32 3.826 0.1037 13772 339.28 339.28 3.826 0.0989 -------- ----------- ------- ------- ------- -------- --------- ------- ------- ------- -------- *TOTALS* 119794 2875.80 2861.28 3.697 0.1268 119794 2862.53 2862.24 3.697 0.1227 ----------------------------------------------------------------------------------------------------------------------------------

 
 Figure 3-54.  CICS Transaction Gateway Daily Throughput Report