Report content

You can select individual reports, but by default all reports are produced.

Activity Summary

See the sample Activity Summary report in this section, which was created with the following command:

CICSPA CTGSTATISTICS(ACTIVITY,OUTPUT(ddname))

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))

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

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.

Start of change

Configuration Summary

See the sample Configuration Summary report in this section, which was created with the following command:

CICSPA CTGSTATISTICS(CONFIGURATION,OUTPUT(ddname))

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.
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.
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.
End of change
Start of change

Client Workload

See the sample Client Workload report in this section, which was created with the following command:

CICSPA CTGSTATISTICS(CLIENTWORKLOAD,OUTPUT(ddname))

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.

End of change
Start of change

CICS Workload

See the sample CICS Workload report in this section, which was created with the following command:

CICSPA CTGSTATISTICS(CICSWORKLOAD,OUTPUT(ddname))

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.
End of change

Information Information

Feedback


Timestamp icon Last updated: Thursday, 7 November 2013


http://pic.dhe.ibm.com/infocenter/cicsts/v5r1/topic//report-reference/stats-cicstg-cont.htm