Report content
You can select individual reports, but by default all reports are produced.
- 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.
Activity Summary
See the sample Activity Summary report in this section, which was created with the following command:
CICSPA CTGSTATISTICS(ACTIVITY,OUTPUT(ddname))
V5R3M0 CICS Performance Analyzer
CICS Transaction Gateway - Activity Summary
_____________________________________________
STTG0001 Printed at 12:34:56 02/15/2015 Data from 11:35:00 6/22/2014 to 13:00:00 6/22/2014 Page 1
Gateway ID Start time Up time Number of Number of Peak Peak TPS time Connect Worker
Intervals requests TPS Timeouts Timeouts
CICSTG.CAI000 2014-06-22 12.33 0days 00.22.15 6 626066 617 2014-06-22 12.55.00 0 0
The following fields are shown on the Activity Summary report:
- Gateway ID
- CICS TG APPLID.
- Start time
- CICS TG daemon start time.
- Up time
- CICS TG daemon running time.
- Number of intervals
- For a given CICS TG daemon instance, this is a count of the SMF records written for a unique collection time.
- Number of requests
- Number of requests processed. This is taken from the most recent SMF record for a given CICS TG daemon instance.
- Peak TPS
- Peak transaction rate per second. This figure is obtained by evaluating GD_IALLREQ / GD_IRUNTIM to find the highest transaction rate across all intervals for this CICS TG daemon instance.
- Peak time
- Peak transaction rate interval start. This is the collection time of the interval that contained the Peak TPS value.
- Connect timeouts
- The number of times connect timeout occurred.
- Worker timeouts
- The number of times worker timeout occurred.
Usage and Capacity
The following command produces the Usage and Capacity report:
CICSPA CTGSTATISTICS(ACTIVITY,USAGE(RATIO(90),OUTPUT(ddname))
CICS Transaction Gateway - Usage and Capacity
_____________________________________________
STTG0002 Printed at 12:34:56 02/15/2015 Data from 11:35:00 6/22/2014 to 11:35:00 6/22/2014 Page 1
Gateway ID : GBIBMIYA.CTGA22 Jobname : CTGA22 VRM : 910 Start Time : 2014-06-22 11.09
Collection time Region Java heap Clients Web Services Workers EXCI pipes IPIC sessions Client Connections
Size/Max Size/Max Peak/Max Peak/Max Peak/Max Num/Max Num/Avail Established/New
2014-06-22 11.10.00 549M/700M 59M/375M 0/1 0/100 0/100 0/250 0/0 0/100
2014-06-22 11.15.00 548M/700M 59M/375M 0/1 0/100 0/100 0/250 0/0 0/0
2014-06-22 11.20.00 548M/700M 59M/375M 0/1 0/100 0/100 0/250 0/0 0/0
2014-06-22 11.25.00 548M/700M 59M/375M 0/1 0/100 0/100 0/250 0/0 0/0
2014-06-22 11.30.00 561M/700M 315M/375M 0/1 3/100 3/100 0/250 0/999 0/0
2014-06-22 11.35.00 564M/700M 313M/375M 0/1 2/100 2/100 0/250 0/999 0/0
The following fields are shown on the Usage and Capacity report:
- Gateway ID
- CICS TG APPLID.
- Start time
- CICS TG daemon start time.
- Collection time
- Statistics collection time.
- Region size
- The amount of used memory ELOAL.
- Region max
- The amount of available memory ELIM.
- Java heap size
- The JVM heap size after garbage collection.
- Java heap max
- The JVM maximum heap size.
- Clients peak
- Peak number of allocated connection manager threads.
- Clients max
- Maximum number of connection managers.
- Web Services peak
- Peak number of web services threads.
- Web Services max
- Maximum number of web services threads.
- Workers peak
- Peak number of allocated worker threads.
- Workers max
- Maximum number of worker threads.
- EXCI pipes num
- Number of EXCI pipes allocated.
- EXCI pipes max
- EXCI pipe limit.
- IPIC sessions num
- Number of IPIC sessions in use.
- IPIC sessions avail
- Number of negotiated IPIC sessions.
- Client connections established
- Number of existing client connections.
- Client connections new
- Number of new client connections.
The Capacity ratio is a user-defined value that can be specified in the RATIO suboperand. It is used to determine if an asterisk (*) is inserted as a warning indicator in the EXCI pipes or IPIC sessions columns when the Num to Max/Avail ratio exceeds the specified ratio. The default is 90.
Configuration Summary
See the sample Configuration Summary report in this section, which was created with the following command:
CICSPA CTGSTATISTICS(CONFIGURATION,OUTPUT(ddname))
V5R3M0 CICS Performance Analyzer
CICS Transaction Gateway - Configuration Summary
________________________________________________
STTG0001 Printed at 12:34:56 02/15/2015 Data from 11:35:00 6/22/2014 to 11:35:00 6/22/2014 Page 1
Gateway ID : CICSTG.CAI000 Jobname : CTGD00CA VRM : 910
Start Time : 2014-06-22 11.09
Gateway Daemon Settings
Resource
Initial Connection Managers (CM_SINIT): 1
Max Connection Managers (CM_SMAX): 250
Max Web Services Threads (WS_SMAXHTTP): 100
Initial Worker Threads (WT_SINIT): 1
Max Worker Threads (WT_SMAX): 250
Logging
Host Name (GD_SHOSTNAME): wmvs123.example.com
Default Server (GD_SDFLTSRV):
Protocol
TCP Protocol Port Number (PH_SPORTTCP): 3180
TCP Protocol Bind Address (PH_SBINDTCP): wmvs123.example.com
SSL Protocol Port Number (PH_SPORTSSL): Undefined
SSL Protocol Bind Address (PH_SBINDSSL): Undefined
HTTP Protocol Port Number (PH_SPORTHTTP): 22014
HTTP Protocol Bind Address (PH_SBINDHTTP):
HTTPS Protocol Port Number (PH_SPORTHTTPS): Undefined
HTTPS Protocol Bind Address (PH_SBINDHTTPS): Undefined
System Environment
ELIM Available Memory (SE_SELIM): 400M
JVM Initial Heap Size (SE_SHEAPINIT): 128M
Max Heap Size (SE_SHEAPMAX): 128M
CICS Server Connections
EXCI NetName (CS_SNETNAME): CTG8EXCI
EXCI Pipe Limit (CS_SLOGONLIM): 250
Defined IPIC Servers (CS_SCOUNT): 11
The following fields are shown on the Configuration Summary report:
- Gateway ID
- CICS TG APPLID.
- Jobname
- CICS TG daemon name.
- Start time
- CICS TG daemon start time.
- Initial Connection Managers
- The initial number of connection manager threads (initconnect) created by the Gateway daemon.
- Max Connection Managers
- The maximum number of connection manager threads (maxconnect) that can possibly be created and allocated by the Gateway daemon.
- Max Web Services Threads
- The maximum number of web services threads (maxhttpconnect) that can possibly be created and allocated by the Gateway daemon.
- Initial Worker Threads
- The initial number of worker threads (initworker) created by the Gateway daemon.
- Max Worker Threads
- The maximum number of parallel requests (maxworker) that the Gateway daemon can process.
- Host Name
- The host name of the CICS TG computer.
- Default Server
- The default CICS TG server.
- TCP Protocol Port Number
- The TCP protocol handler port number, or -1 if the protocol is not enabled.
- TCP Protocol Bind Address
- The address or host name to which the TCP protocol handler is bound. This statistic does not contain a value if the protocol handler is not enabled.
- SSL Protocol Port Number
- The SSL protocol handler port number, or -1 if the protocol is not enabled.
- SSL Protocol Bind Address
- The address or host name to which the SSL protocol handler is bound. This statistic does not contain a value if the protocol handler is not enabled.
- HTTP Protocol Port Number
- The HTTP protocol handler port number, or -1 if the protocol is not enabled.
- HTTP Protocol Bind Address
- The address or host name to which the HTTP protocol handler is bound. This statistic does not contain a value if the protocol handler is not enabled.
- HTTPS Protocol Port Number
- The HTTPS protocol handler port number, or -1 if the protocol is not enabled.
- HTTPS Protocol Bind Address
- The address or host name to which the HTTPS protocol handler is bound. This statistic does not contain a value if the protocol handler is not enabled.
- ELIM Available Memory
- The amount of available extended user private storage (in bytes) in the Gateway daemon address space. This amount is less than or equal to the amount of storage specified by the job REGION parameter.
- JVM Initial Heap Size
- The size of the Gateway daemon initial JVM heap (in bytes).
- Max Heap Size
- The size of the Gateway daemon maximum JVM heap (in bytes).
- EXCI NetName
- The NETNAME of the specific pipe used for EXCI calls or empty string if generic pipes are being used. The NETNAME is defined by the environment variable DFHJVPIPE.
- EXCI Pipe Limit
- The maximum EXCI pipe allocation for each MVS™ address space. This value is the equivalent to the CICS subsystem initialization parameter LOGONLIM.
- Defined IPIC Servers
- The number of CICS servers defined in the configuration file.
Client Workload
See the sample Client Workload report in this section, which was created with the following command:
CICSPA CTGSTATISTICS(CLIENTWORKLOAD,OUTPUT(ddname))
V5R3M0 CICS Performance Analyzer
CICS Transaction Gateway - Client Workload
________________________________________________
STTG0001 Printed at 12:34:56 02/15/2015 Data from 11:35:00 6/22/2014 to 11:35:00 6/22/2014 Page 1
Gateway ID Start time Collection time Resp Network Total Sync Transaction -Tot Data- -Avg Data- Timeout
Time Latency Requests Trans Ext XA Sent Rcvd Send Rcvd Con Wrk
CICSTG.CAI000 2014-06-22 11.09 2014-06-22 11.10.00 .119 .013 31254 0 15627 0 480M 478M 15K 15K 0 0
CICSTG.CAI000 2014-06-22 11.09 2014-06-22 11.15.00 .123 .014 164248 0 82114 0 2527M 2515M 15K 15K 0 0
CICSTG.CAI000 2014-06-22 11.09 2014-06-22 11.20.00 .116 .014 81796 0 40898 0 1257M 1252M 15K 15K 0 0
CICSTG.CAI000 2014-06-22 11.09 2014-06-22 11.25.00 .124 .013 150211 0 75109 0 2306M 2300M 15K 15K 0 0
CICSTG.CAI000 2014-06-22 11.09 2014-06-22 11.30.00 .122 .014 185253 0 92625 0 2849M 2837M 15K 15K 0 0
CICSTG.CAI000 2014-06-22 11.09 2014-06-22 11.35.00 .114 .013 13304 0 6660 0 201M 203M 15K 15K 0 0
The following fields are shown on the Client Workload report:
- Gateway ID
- CICS TG APPLID.
- Start time
- CICS TG daemon start time.
- Collection time
- Statistics collection time.
- Resp Time
- Average CICS TG daemon response time.
- Network Latency
- Average network I/O time.
- Total Requests
- Number of requests processed.
- Sync Trans
- Successful SYNCONRETURN transactions.
- Transaction
- Ext: Number of extended LUW transactions.
XA: Number of XA transactions.
- -Tot Data-
- Sent: The amount of client request data.
Rcvd: The amount of client response data.
- -Avg Data-
- Sent: The average client request size.
Rcvd: The average client response size.
- Timeout
- Con: The number of times that the Gateway daemon failed to allocate
a connection manager thread to a client application within the defined connecttimeout length
of time.
Wrk: The number of times the Gateway daemon failed to allocate a worker thread to a connection manager within the defined workertimeout length of time.
CICS Workload
See the sample CICS Workload report in this section, which was created with the following command:
CICSPA CTGSTATISTICS(CICSWORKLOAD,OUTPUT(ddname))
V5R3M0 CICS Performance Analyzer
CICS Transaction Gateway - CICS Workload
________________________________________________
STTG0001 Printed at 12:34:56 02/15/2015 Data from 11:35:00 6/22/2014 to 11:35:00 6/22/2014 Page 1
Gateway ID : CICSTG.CAI000 Start Time : 2014-06-22 11.09
Collection Time CICS Protocol Resp Total -Tot Data- -Avg Data- Comms
Time Requests Sent Rcvd Sent Rcvd Failures
2014-06-22 11.10.00 IYCNONCE EXCI .222 7846 239M 239M 31K 31K 0
IYCNONCE IPIC .117 7781 242M 241M 31K 31K 0
2014-06-22 11.15.00 IYCNONCE EXCI .233 42025 1282M 1281M 31K 31K 0
IYCNONCE IPIC .123 40182 1253M 1246M 31K 31K 0
2014-06-22 11.20.00 IYCNONCE EXCI .227 19896 607M 607M 31K 31K 0
IYCNONCE IPIC .113 20997 655M 651M 31K 31K 0
2014-06-22 11.25.00 IYCNONCE EXCI .233 38283 1168M 1169M 31K 31K 0
IYCNONCE IPIC .124 36751 1146M 1141M 31K 31K 0
2014-06-22 11.30.00 IYCNONCE EXCI .234 46646 1423M 1422M 31K 31K 0
IYCNONCE IPIC .121 46047 1436M 1428M 31K 31K 0
2014-06-22 11.35.00 IYCNONCE EXCI .205 3599 109M 110M 31K 31K 0
IYCNONCE IPIC .118 2980 93M 93M 31K 32K 0
The following fields are shown on the CICS Workload report:
- Gateway ID
- CICS TG APPLID.
- Start time
- CICS TG daemon start time.
- Collection time
- Statistics collection time.
- CICS
- The CICS connection.
- Protocol
- The CICS server protocol.
- Resp Time
- Average CICS response time.
- Total Requests
- Number of requests processed.
- -Tot Data-
- Sent: The amount of CICS request data.
Rcvd: The amount of CICS response data.
- -Avg Data-
- Sent: The average CICS request size.
Rcvd: The average CICS response size.
- Comms Failures
- Number of CICS communication failures.
Web Services Workload
See the sample Web Services Workload report in this section, which was created with the following command:
CICSPA CTGSTATISTICS(WEBSERVICES,OUTPUT(ddname))
V5R3M0 CICS Performance Analyzer
CICS Transaction Gateway - Web Services Workload
________________________________________________
STTG0001 Printed at 12:34:56 02/15/2015 Data from 11:35:00 6/22/2014 to 11:35:00 6/22/2014 Page 1
Gateway ID : LP01XXXX.DMCTG01 Start Time : 2014-06-22 11.09
Collection time Response Total Peak Total Avg Total Avg
Time Requests Requests Data Sent Data Sent Data Rcvd Data Rcvd
2014-06-22 11.10.00 .000 0 0 0 0 0 0
2014-06-22 11.15.00 .000 0 0 0 0 0 0
2014-06-22 11.20.00 .000 0 0 0 0 0 0
2014-06-22 11.25.00 .000 0 0 0 0 0 0
2014-06-22 11.30.00 .012 514 3 53K 106 66K 133
2014-06-22 11.35.00 .004 599 2 61K 105 77K 132
The following fields are shown on the Web Services Workload report:
- Gateway ID
- CICS TG APPLID.
- Start time
- CICS TG daemon start time.
- Collection time
- Statistics collection time.
- Response Time
- Average CICS TG daemon response time.
- Total Requests
- The number of web service requests that have been processed. Successful and failed requests are included.
- Peak Requests
- The peak number of concurrent web service transactions that have been in flight at the same time.
- Total Data Sent
- The amount of application request data (in bytes) returned to clients.
- Avg Data Sent
- The average client request size.
- Total Data Rcvd
- The amount of application request data (in bytes) received from clients.
- Avg Data Rcvd
- The average client response size.