CICS Transaction Gateway reports
The CICS® Transaction Gateway
reports provide comprehensive reporting of CICS TG Statistics (SMF 111) records.
- The Activity Summary report provides a high-level overview of Gateway daemon address spaces and their workloads. This report also indicates whether connected users or systems might have experienced problems due to communications failure or request time out.
- The Usage and Capacity report summarizes Gateway daemon resource usage over time, including 31-bit region and Java™ heap storage utilization, communication sessions, and connection manager and worker thread pools.
- The Configuration Summary report provides a snapshot of key configuration values for each active Gateway daemon in your system. You can view and compare configurations of multiple Gateway daemons within one report. The reports also provide a useful historical reference for identifying changes in configuration over time.
- The Client Workload report provides a high-level overview of the application workload in terms of response time, network latency, request volumes, data transfer, and transaction type, broken down by Gateway daemon instance. This report can give insight into application usage patterns throughout a daily, weekly, or monthly cycle, and in time can reveal longer term trends. It can also be used to see the impact on end users of incidents in the overall system. Cross referencing a particular interval with the CICS Workload report can then lead you to identify which CICS region might be associated with a particular incident.
- The CICS Workload report provides an overview of workload between Gateway daemons and their connected CICS regions, broken down by Gateway daemon instance and CICS connection. This report allows you to identify which CICS regions are most heavily loaded, and to identify when a CICS region experienced abnormal response times during a particular interval or when some requests to a CICS region were affected by communications problems.
- The Web Services Workload report provides a high-level overview in terms of response time, request volumes, and data transfer, broken down by Gateway daemon instance. This report can give insight into web service usage patterns throughout a daily, weekly, or monthly cycle, and in time can reveal longer-term trends. It can also be used to see the impact on end users of incidents in the overall system.
To request the reports, enter line action S against the CICS Transaction Gateway Statistics
Report on the Report Set panel. If reports of this type have been
previously specified, the list of CICS Transaction
Gateway Reports is displayed. Otherwise, the CICS Transaction Gateway Report panel is displayed
for you to define your first report of this type.
Figure 1. CICS Transaction
Gateway Reports
File Filter Edit Systems Options Help
------------------------------------------------------------------------------
SAMPLE - CICS Transaction Gateway Reports Row 1 from 1
Command ===> ________________________________________________ Scroll ===> ____
---- System Selection ----
/ Exc APPLID + Image + Group + Output
_ CICSP001 ________ ________ STTG0001
_ CICST001 ________ ________ STTG0002
******************************* Bottom of data ********************************
This panel displays the list of CICS TG reports in this Report Set. You can select (edit), delete, or include/exclude any report, insert new ones, or rearrange them (move/copy).
The line actions are the same as those for the Performance List Reports panel. See Performance List report.
If the list of previously specified reports is displayed, enter
line action S against a particular report in the list.
Figure 2. CICS Transaction Gateway Report
File Systems Options Help
------------------------------------------------------------------------------
SAMPLE - CICS Transaction Gateway Report
Command ===> _________________________________________________________________
System Selection: Report Output:
APPLID . . CICSP001 + DDname . . . . . . . . . STTG0001
Image . . ________ + Print Lines per Page . . ___ (1-255)
Group . . ________ +
Reports Required:
/ Activity Summary
/ Usage and Capacity Ratio: 90 (Pipes or Sessions ratio)
/ Configuration Summary
/ Client Workload
/ CICS Workload
/ Web Services Workload
Report Format:
Title . . ________________________________________________________________
________________________________________________________________
F1=Help F3=Exit F4=Prompt F7=Backward F8=Forward F10=Actions
F12=Cancel
Use this panel to select the reports and specify report options:
- Reports Required
- Enter / to select the reports you want produced:
- Activity Summary
- Requests the Activity Summary report. This option generates the ACTIVITY operand.
- Usage and Capacity
- Requests the Usage and Capacity report. This option generates the USAGE operand.
- Configuration Summary
- Requests the Configuration Summary report. This option generates the CONFIGURATION operand.
- Client Workload
- Requests the Client Workload report. This option generates the CLIENTWORKLOAD operand.
- CICS Workload
- Requests the CICS Workload report. This option generates the CICSWORKLOAD operand.
- Web Services Workload
- Requests the Web Services Workload report. This option generates the WEBSERVICES operand.
- Ratio
- This option applies only to the Usage and Capacity report. A warning indicator is displayed against the EXCI pipes
or IPIC sessions fields in the report when the Num/Max ratio or Num/Avail
ratio exceeds the specified value. The default is 90.
This value generates the RATIO(value) suboperand.
The report options and Title are the same as those for the Performance List report (see Performance List report).
CICS PA provides a default Report Output DDname in the format STTGnnnn where nnnn is 0001-9999. All selected reports will be written consecutively to this ddname. To separate the reports, create individual CICS TG reports and change the Report Output DDname for each one.