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))
Figure 1. CICS Transaction Gateway - Activity Summary report
 V5R1M0                                                 CICS Performance Analyzer                                                  
                                                CICS Transaction Gateway - Activity Summary                                        
                                               _____________________________________________                                       
STTG0001 Printed at 12:03:45 04/17/2013     Data from 12:56:00 10/12/2012 to 12:56:00 10/12/2012                       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      2012-10-12 12.33    0days 00.22.15          6     626066   617  2012-10-12 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))
Figure 2. CICS Transaction Gateway - Usage and Capacity report
                                               CICS Transaction Gateway - Usage and Capacity                                       
                                               _____________________________________________                                       
STTG0001 Printed at 12:03:45 04/17/2013     Data from 12:56:00 10/12/2012 to 12:56:00 10/12/2012                       Page       1
                                                                                                                                   
                                                                                                                                   
Gateway ID         Start time        Collection time       Region      Java heap   Clients   Workers   EXCI pipes IPIC sessions
                                                           Size/Max    Size/Max    Peak/Max  Peak/Max   Num/Max     Num/Avail  
CICSTG.CAI000      2012-10-12 12.33  2012-10-12 12.35.00   351M/400M    37M/128M    100/250   106/250   106/250 *     0/100    
CICSTG.CAI000      2012-10-12 12.33  2012-10-12 12.40.00   357M/400M    39M/128M    100/250   106/250   106/250 *    47/100 *  
CICSTG.CAI000      2012-10-12 12.33  2012-10-12 12.45.00   359M/400M    39M/128M    100/250   105/250   106/250 *    47/100 *  
CICSTG.CAI000      2012-10-12 12.33  2012-10-12 12.50.00   358M/400M    35M/128M    100/250   105/250   106/250 *    20/100    
CICSTG.CAI000      2012-10-12 12.33  2012-10-12 12.55.00   358M/400M    39M/128M    100/250   105/250   106/250 *    49/100 *  
CICSTG.CAI000      2012-10-12 12.33  2012-10-12 12.56.00   358M/400M    36M/128M    100/250   103/250   106/250 *     0/100    

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))
Figure 3. CICS Transaction Gateway - Configuration Summary report
 V5R1M0                                                 CICS Performance Analyzer                                                  
                                            CICS Transaction Gateway - Configuration Summary                                        
                                            ________________________________________________                                       
STTG0001 Printed at 12:03:45 04/17/2013     Data from 12:56:00 10/12/2012 to 12:56:00 10/12/2012                       Page       1
                                                                                                                                   
                                                                                                                                   
Gateway ID : CICSTG.CAI000     Jobname : CTGD00CA VRM : 900                    
Start Time : 2012-10-12 12.33                                                  
                                                                               
Gateway Daemon Settings                                                        
  Resource                                                                     
    Initial Connection Managers            (CM_SINIT): 1                       
    Max Connection Managers                 (CM_SMAX): 250                     
    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               
                                                                               
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.
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))
Figure 4. CICS Transaction Gateway - Client Workload report
 V5R1M0                                                 CICS Performance Analyzer                                                  
                                               CICS Transaction Gateway - Client Workload   
                                            ________________________________________________
STTG0001 Printed at 12:03:45 04/17/2013     Data from 12:56:00 10/12/2012 to 12:56:00 10/12/2012                       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     2012-10-12 12.33 2012-10-12 12.35.00   .119    .013    31254        0 15627     0  480M  478M   15K   15K   0   0
CICSTG.CAI000     2012-10-12 12.33 2012-10-12 12.40.00   .123    .014   164248        0 82114     0 2527M 2515M   15K   15K   0   0
CICSTG.CAI000     2012-10-12 12.33 2012-10-12 12.45.00   .116    .014    81796        0 40898     0 1257M 1252M   15K   15K   0   0
CICSTG.CAI000     2012-10-12 12.33 2012-10-12 12.50.00   .124    .013   150211        0 75109     0 2306M 2300M   15K   15K   0   0
CICSTG.CAI000     2012-10-12 12.33 2012-10-12 12.55.00   .122    .014   185253        0 92625     0 2849M 2837M   15K   15K   0   0
CICSTG.CAI000     2012-10-12 12.33 2012-10-12 12.56.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.

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))
Figure 5. CICS Transaction Gateway - CICS Workload report
 V5R1M0                                                 CICS Performance Analyzer                                                  
                                                 CICS Transaction Gateway - CICS Workload   
                                            ________________________________________________
STTG0001 Printed at 12:03:45 04/17/2013     Data from 12:56:00 10/12/2012 to 12:56:00 10/12/2012                       Page       1
                                                                                                                                   
                                                                                                                                   
Gateway ID : CICSTG.CAI000     Start Time : 2012-10-12 12.33                                 
                                                                                             
Collection Time      CICS      Protocol    Resp     Total  -Tot  Data-  -Avg  Data-     Comms
                                           Time  Requests   Sent  Rcvd   Sent  Rcvd  Failures
2012-10-12 12.35.00  IYCNONCE  EXCI        .222      7846   239M  239M    31K   31K         0
                     IYCNONCE  IPIC        .117      7781   242M  241M    31K   31K         0
2012-10-12 12.40.00  IYCNONCE  EXCI        .233     42025  1282M 1281M    31K   31K         0
                     IYCNONCE  IPIC        .123     40182  1253M 1246M    31K   31K         0
2012-10-12 12.45.00  IYCNONCE  EXCI        .227     19896   607M  607M    31K   31K         0
                     IYCNONCE  IPIC        .113     20997   655M  651M    31K   31K         0
2012-10-12 12.50.00  IYCNONCE  EXCI        .233     38283  1168M 1169M    31K   31K         0
                     IYCNONCE  IPIC        .124     36751  1146M 1141M    31K   31K         0
2012-10-12 12.55.00  IYCNONCE  EXCI        .234     46646  1423M 1422M    31K   31K         0
                     IYCNONCE  IPIC        .121     46047  1436M 1428M    31K   31K         0
2012-10-12 12.56.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.
End of change

Information Information

Feedback


Timestamp icon Last updated: Saturday, 8 February 2014


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