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.
| 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 |
| Current number of non-persistent inbound sockets | SOG_CURR_NPERS_INB_SOCKETS | is the current number of non-persistent inbound sockets. Reset characteristic: reset to zero |
| Peak number of inbound sockets | SOG_PEAK_INBOUND_SOCKETS | is the peak number of inbound sockets. Reset characteristic: reset to current |
| Peak number of non-persistent inbound sockets | SOG_PEAK_NPERS_INB_SOCKETS | is the peak number of non-persistent inbound
sockets. Reset characteristic: reset to current |
| Peak number of persistent inbound sockets | SOG_PEAK_PERS_INB_SOCKETS | is the peak number of persistent inbound
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 non-persistent inbound sockets created | SOG_NPERS_INB_SOCKETS_CREATED | is the total number of non-persistent inbound
sockets created. Reset characteristic: reset to zero |
| Current number of non-persistent outbound sockets | SOG_CURR_OUTB_SOCKETS | is the current number of non-persistent outbound sockets. Reset characteristic: not reset |
| 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 outbound sockets | SOG_PEAK_BOTH_OUTB_SOCKETS | is the peak number of both persistent and
non-persistent outbound sockets. Reset characteristic: reset to current |
| 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 |
| 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 times outbound sockets reused | SOG_TIMES_OUTB_REUSED | is the total number of times a pooled connection was
reused. 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 persistent outbound sockets created | SOG_PERS_OUTBOUND_CREATED | is the total number of persistent 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 because 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 is enabled. 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 --/--/----
--:--:--:----, 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 closing existing
persistent connections when their next request completes and is making new connections
non-persistent, 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 close existing persistent connections when
their next request completes and make new connections non-persistent, because the number of tasks in
the region had 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 close existing persistent connections when their
next request completes and make new connections non-persistent, because the number of tasks in the
region had 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 --/--/----
--:--:--:----, that indicates that this situation has not occurred 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 had 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 |