Statistics resource groups

Every statistic belongs to a resource group. Resource groups define an area for which statistical data can be associated and retrieved. Resource groups are available from the CICS Transaction Gateway.

A resource group is a logical grouping of resources, such as connection managers. It defines an area for which statistical data can be associated and retrieved. Each resource group has these characteristics:
ID
A unique identifier for the resource group. The ID is used by ctgadmin and the statistical API to retrieve statistics, and is not case-sensitive.
Name
The name of the resource group, displayed when ctgadmin is used to display statistical information.
Description
A description of the resource group.
These resource groups are defined:
Table 1. Resource groups
ID Name Description
CD Client daemon statistics Statistics about the Client daemon process.
CM Connection manager statistics Statistics about connection manager threads.
CS CICS server (all) statistics Statistics about all CICS servers.
CSx CICS server (instance) statistics Statistics for an individual CICS server, where x is the APPLID of the CICS server.
GD Gateway daemon statistics Statistics on transaction counts, request counts, and Gateway status.
PH Protocol handler statistics Statistics about protocol handlers.
SE System environment statistics Statistics about the System Environment of the Gateway daemon.
WT Worker thread statistics Statistics about worker threads.

Client daemon resource group (CD)

The Client daemon resource group contains statistical values reflecting the status and activity of the Client daemon component. Client daemon statistics are only available through the Gateway daemon administration interface, ctgadmin, or the statistics API. This means that both the Gateway daemon and the Client daemon must be active to display or retrieve Client daemon statistics.

Client daemon statistics are initialized when the Client daemon is started and the values are not reset if the Gateway daemon is started later. If a CICS server connection is stopped using the CICSCLI command, then statistics for that CICS server will persist for the lifetime of the Client daemon. If a CICS server connection is stopped and restarted the statistic values are not reset.

CICS server statistics will be taken for the CICS servers that are actually used to process the work. When the Workload Manager is in use, the CICS server identified by an application might not be the CICS server that processes the work.

Connection manager resource group (CM)

Statistics are available for connection manager threads. These statistics identify the characteristics for the pool of connection manager threads and are useful for analyzing resource usage, capacity planning and diagnosing system problems.

CICS Server (all) resource group (CS)

Statistics are available that summarize interactions with all associated CICS servers.

CICS Server (instance) resource group (CSx)

Statistics are available for each specific CICS server "x". In general, the statistic IDs of the CS resource group which summarize activity across all associated CICS servers, can be found for each CICS server in the corresponding CSx resource group.

For example, a CICS Transaction Gateway connected to a CICS server defined by the name CICSAOR1 is represented by resource group CSCICSAOR1. An example of a statistical ID available for such a resource group is CSCICSAOR1_LALLREQ. If the server name contains any underscores (_), they are replaced with hyphens (-) in the resource group ID.

A CSx resource group is available for a connected CICS server regardless of the protocol used. However, there are some protocol-specific statistic IDs. The CSx_SPROTOCOL statistic is provided to distinguish the set of values that can be expected for a given CSx resource group, especially for use by a Statistics API program.

Statistics for CICS servers connected over SNA and TCP/IP are available immediately after initialization. Statistics for CICS servers connected over IPIC are available after a connection is attempted.

Gateway daemon resource group (GD)

Statistics are available for the Gateway daemon. These statistics include status, an indication of work done on behalf of remote mode Client applications, completed and active transactions. Although there is a correlation between the number of requests counted in the GD and CS resource groups, requests counted in the GD resource group reflect remote Client requests and are likely to be different from the CS resource group request counts. Some Client requests do not require any interaction with a CICS server; for example, list systems. Other Client requests might require more than one interaction with a CICS server.

Protocol handler resource group (PH)

Statistics are available to identify whether the SSL and TCP protocol handlers are enabled and the port numbers in use. A value of -1 is returned if the protocol is not enabled.

System environment resource group (SE)

Statistics are available to assist in the analysis of storage usage by the Gateway daemon. JVM Heap storage and Garbage Collection (GC) information is provided.

Worker thread resource group (WT)

Statistics are available for the worker threads. These statistics identify the characteristics for the pool of worker threads that can be used by connection managers. These statistics are useful for analyzing resource usage and capacity planning, and for diagnosing system problems.


Reference Reference

Feedback


Timestamp icon Last updated: Tuesday, 19 November 2013


https://ut-ilnx-r4.hursley.ibm.com/tg_latest/help/topic/com.ibm.cics.tg.doc//ctgunx/stat_rg.html