TCP/IP: Global statistics

You can retrieve TCP/IP global statistics by using the EXEC CICS EXTRACT STATISTICS TCPIP system command. They are mapped by the DFHSOGDS DSECT.

Table 1. TCP/IP: Global statistics
DFHSTUP name Field name Description

 

Current number of inbound sockets SOG_CURR_INBOUND_SOCKETS is the current number of inbound sockets.

Reset characteristic: not reset

 

Peak number of inbound sockets SOG_PEAK_INBOUND_SOCKETS is the peak number of inbound sockets.

Reset characteristic: reset to current

 

Current number of non-persistent outbound sockets SOG_CURR_OUTB_SOCKETS is the current number of non-persistent outbound sockets.

Reset characteristic: not reset

 

Peak number of non-persistent outbound sockets SOG_PEAK_OUTB_SOCKETS is the peak number of non-persistent outbound sockets.

Reset characteristic: reset to current

 

Current number of persistent outbound sockets SOG_CURR_PERS_OUTB_SOCKETS is the current number of persistent outbound sockets.

Reset characteristic: not reset

 

Peak number of persistent outbound sockets SOG_PEAK_PERS_OUTB_SOCKETS is the peak number of persistent outbound sockets.

Reset characteristic: reset to current

 

Total number of inbound sockets created SOG_INB_SOCKETS_CREATED is the total number of inbound sockets created.

Reset characteristic: reset to zero

 

Total number of outbound sockets created SOG_OUTB_SOCKETS_CREATED is the total number of outbound sockets created.

Reset characteristic: reset to zero

 

Total number of outbound sockets closed SOG_OUTB_SOCKETS_CLOSED is the total number of outbound sockets closed.

Reset characteristic: reset to zero

 

Total number of inbound and outbound sockets created SOG_INB_SOCKETS_CREATED + SOG_OUTB_SOCKETS_CREATED is the total number of inbound and outbound sockets created.

Reset characteristic: reset to zero

 

SSLCACHE setting SOG_SSLCACHE reports whether SSL caching is taking place locally within a CICS® region, or across a sysplex.

Reset characteristic: not reset

 

Current MAXSOCKETS limit SOG_MAXSOCKETS_LIMIT is the maximum number of IP sockets that can be managed by the CICS sockets domain.

Reset characteristic: not reset

 

Number of times the MAXSOCKETS limit was reached SOG_TIMES_AT_MAX_SOCKETS is the number of times the maximum number of IP sockets limit (MAXSOCKETS) was reached.

Reset characteristic: reset to zero

 

Number of create socket requests delayed by MAXSOCKETS limit SOG_DELAYED_AT_MAX_SOCKETS is the number of create socket requests that were delayed because the system had reached the MAXSOCKETS limit.

Reset characteristic: reset to zero

 

Total MAXSOCKETS delay time SOG_QTIME_AT_MAX_SOCKETS is the total time that create socket requests were delayed because the system had reached the MAXSOCKETS limit.

Reset characteristic: reset to zero

 

Number of create sockets requests timed out at MAXSOCKETS SOG_TIMEDOUT_AT_MAX_SOCKETS is the number of create socket requests that were timed out while delayed because the system had reached the MAXSOCKETS limit.

Reset characteristic: reset to zero

 

Current create socket requests delayed by MAXSOCKETS limit SOG_CURR_DELAYED_AT_MAX is the current number of create socket requests delayed because the system is at the MAXSOCKETS limit.

Reset characteristic: not reset

 

Peak create socket requests delayed at MAXSOCKETS SOG_PEAK_DELAYED_AT_MAX is the peak number of create socket requests delayed becuase the system is at the MAXSOCKETS limit.

Reset characteristic: reset to current

 

Current MAXSOCKETS delay time SOG_CURRENT_QTIME_AT_MAX is the current total delay time for the create socket requests that are currently delayed because the system is at the MAXSOCKETS limit.

Reset characteristic: not reset

 

Performance tuning for HTTP connections SOG_SOTUNING indicates whether performance tuning for HTTP connections will take place.

Reset characteristic: not reset

 

Socket listener has paused listening for HTTP connections SOG_PAUSING_HTTP_LISTENING

indicates whether the listener has paused listening for HTTP connection requests because the number of tasks in the region has reached the limit for accepting new HTTP connection requests

Reset characteristic: not reset

 

Number of times socket listener notified at task accept limit SOG_TIMES_AT_ACCEPT_LIMIT is the number of times the listener has been notified that the number of tasks in the region has reached the limit for accepting new HTTP connection requests.

Reset characteristic: reset to zero

 

Last time socket listener paused listening for HTTP connections SOG_TIME_LAST_PAUSED_HTTP_LISTENING is the last time the socket listener paused listening for HTTP connection requests because the number of tasks in the region had reached the limit for accepting new HTTP connection requests. The DFHSTUP report expresses this time as day/month/year hours:minutes:seconds:decimals; however, the DSECT field contains the time as a store clock (STCK) value in local time. If the DFHSTUP report shows the date and time as --/--/---- --:--:--:---- then that indicates that the listener has never paused listening for HTTP connection requests since the statistics were last reset.

Reset characteristic: reset to zero

 

Region stopping HTTP connection persistence SOG_STOPPING_PERSISTENCE indicates whether the region is stopping HTTP connection persistence because the number of tasks in the region has exceeded the limit.

Reset characteristic: not reset

 

Number of times region stopped HTTP connection persistence SOG_TIMES_STOPPED_PERSISTENT is the number of times the region took action to stop HTTP connection persistence because the number of tasks in the region has exceeded the limit.

Reset characteristic: reset to zero

 

Last time stopped HTTP connection persistence SOG_TIME_LAST_STOPPED_PERSISTENT is the last time the region took action to stop HTTP connection persistence because the number of tasks in the region has exceeded the limit. The DFHSTUP report expresses this time as day/month/year hours:minutes:seconds:decimals; however, the DSECT field contains the time as a store clock (STCK) value in local time. If the DFHSTUP report shows the date and time as --/--/---- --:--:--:---- then that indicates that HTTP connection persistence has not been stopped since the statistics were last reset.

Reset characteristic: reset to zero

 

Number of persistent connections made non-persistent SOG_TIMES_MADE_NON_PERSISTENT is the number of times a persistent HTTP connection was made non-persistent because the number of tasks in the region has exceeded the limit.

Reset characteristic: reset to zero

 

Number of times disconnected an HTTP connection at max uses SOG_TIMES_CONN_DISC_AT_MAX is the number of times a persistent HTTP connection was disconnected because the number of uses had exceeded the limit.

Reset characteristic: reset to zero