TCP/IP: Global statistics
You can retrieve TCP/IP global statistics by using the EXEC CICS EXTRACT STATISTICS TCPIP command. They are mapped by the DFHSOGDS DSECT.
| DFHSTUP name | Field name | Description |
|---|---|---|
| Current number of inbound sockets | SOG_CURR_INBOUND_SOCKETS | The current number of inbound sockets. Reset characteristic: not reset |
| Current number of nonpersistent inbound sockets | SOG_CURR_NPERS_INB_SOCKETS | The current number of nonpersistent inbound sockets. Reset characteristic: reset to zero |
| Peak number of inbound sockets | SOG_PEAK_INBOUND_SOCKETS | The peak number of inbound sockets. Reset characteristic: reset to current |
| Peak number of nonpersistent inbound sockets | SOG_PEAK_NPERS_INB_SOCKETS | The peak number of nonpersistent inbound
sockets. Reset characteristic: reset to current |
| Peak number of persistent inbound sockets | SOG_PEAK_PERS_INB_SOCKETS | The peak number of persistent inbound
sockets. Reset characteristic: reset to current |
| Total number of inbound sockets created | SOG_INB_SOCKETS_CREATED | The total number of inbound sockets created. Reset characteristic: reset to zero |
| Total number of nonpersistent inbound sockets created | SOG_NPERS_INB_SOCKETS_CREATED | The total number of nonpersistent inbound sockets
created. Reset characteristic: reset to zero |
| Current number of outbound sockets | SOG_CURR_OUTB_SOCKETS | The current number of outbound sockets. Reset characteristic: not reset |
| Peak number of outbound sockets | SOG_PEAK_OUTB_SOCKETS | The peak number of outbound sockets.
Reset characteristic: reset to current |
| Total number of times outbound sockets reused | SOG_TIMES_OUTB_REUSED | 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 | The total number of outbound sockets created. Reset characteristic: reset to zero |
| Total number of outbound sockets closed | SOG_OUTB_SOCKETS_CLOSED | 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 | 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 | 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 | 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 | 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 | 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 | 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 | 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 | 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 | 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 | 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 | 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 nonpersistent
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 | The number of times the region took action to close existing persistent connections when
their next request completes and make new connections nonpersistent 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 | The last time the region took action to close existing persistent connections when their next
request completes and make new connections nonpersistent 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 nonpersistent. | SOG_TIMES_MADE_NON_PERSISTENT | The number of times a persistent HTTP connection was made nonpersistent because the number of
tasks in the region that exceeded the limit. Reset characteristic: reset to zero |
| Number of times disconnected an HTTP connection at max uses | SOG_TIMES_CONN_DISC_AT_MAX | The number of times a persistent HTTP connection was disconnected because the number of uses
that exceeded the limit. Reset characteristic: reset to zero |
| Maximum parallel TLS handshakes | SOG_S8TLSHS_REQUESTS_MAX | The maximum number of TLS handshakes that are allowed to run
in parallel. Reset characteristic: not reset |
| Current parallel TLS handshakes | SOG_S8TLSHS_REQUESTS_CUR | The current number of TLS handshakes that are running in
parallel. Reset characteristic: not reset |
| Peak parallel TLS handshakes | SOG_S8TLSHS_REQUESTS_PEAK | The peak number of TLS handshakes that were running in
parallel. Reset characteristic: reset to current |
| Maximum waiting TLS handshakes | SOG_S8TLSHS_WAITERS_MAX | The maximum number of TLS handshakes that are allowed to wait
to run. 9999 means no limit. Reset characteristic: not reset |
| Current waiting TLS handshakes | SOG_S8TLSHS_WAITERS_CUR | The current number of TLS handshakes that are
waiting. Reset characteristic: not reset |
| Peak waiting TLS handshakes | SOG_S8TLSHS_WAITERS_PEAK | The peak number of TLS handshakes that were
waiting. Reset characteristic: reset to current |
| 6.16.2 Inbound: TLS 1.1 | SOG_TIMES_CICSTLS11_INB_USED | Total of newly established inbound connections that
used TLS 1.1 protocol, which come from TCPIPSERVICE with SSL(YES) or SSL(CLIENTAUTH).
Reset characteristic: reset to zero |
| Inbound: TLS 1.2 | SOG_TIMES_CICSTLS12_INB_USED | Total of newly established inbound
connections that used TLS 1.2 protocol, which come from TCPIPSERVICE with SSL(YES) or
SSL(CLIENTAUTH). Reset characteristic: reset to zero |
| Inbound: TLS 1.3 | SOG_TIMES_CICSTLS13_INB_USED | Total of newly established inbound
connections that used TLS 1.3 protocol, which come from TCPIPSERVICE with SSL(YES) or
SSL(CLIENTAUTH). Reset characteristic: reset to zero |
| Inbound: Total | SOG_TIMES_CICSTLSALL_INB_USED | Total number of established inbound
connections that used any TLS protocol, which come from TCPIPSERVICE with SSL(YES) or
SSL(CLIENTAUTH). Reset characteristic: reset to zero |
| 6.16.2 Outbound: TLS 1.1 | SOG_TIMES_CICSTLS11_OUTB_USED | Total of newly established outbound
connections that used TLS 1.1 protocol, which come from URIMAP with USAGE(CLIENT) SCHEME(HTTPS) or
WEB OPEN SCHEME(HTTPS).
Reset characteristic: reset to zero |
| Outbound: TLS 1.2 | SOG_TIMES_CICSTLS12_OUTB_USED | Total of newly established outbound
connections that used TLS 1.2 protocol, which come from URIMAP with USAGE(CLIENT) SCHEME(HTTPS) or
WEB OPEN SCHEME(HTTPS). Reset characteristic: reset to zero |
| Outbound: TLS 1.3 | SOG_TIMES_CICSTLS13_OUTB_USED | Total of newly established outbound
connections that used TLS 1.3 protocol, which come from URIMAP with USAGE(CLIENT) SCHEME(HTTPS) or
WEB OPEN SCHEME(HTTPS). Reset characteristic: reset to zero |
| Outbound: Total | SOG_TIMES_CICSTLSALL_OUTB_USED | Total number of established outbound
connections that used any TLS protocol, which come from URIMAP with USAGE(CLIENT) SCHEME(HTTPS) or
WEB OPEN SCHEME(HTTPS). Reset characteristic: reset to zero |
| Inbound: AT-TLS SSL 3 | SOG_TIMES_ATSSL3_INB_USED | Total number of established inbound connections
that used AT-TLS SSL 3 protocol, which can come from TCPIPSERVICE with SSL(ATTLSAWARE) or
SSL(NO). Reset characteristic: reset to zero |
| Inbound: AT-TLS 1.0 | SOG_TIMES_ATTLS10_INB_USED | Total number of established inbound connections
that used AT-TLS 1.0 protocol, which can come from TCPIPSERVICE with SSL(ATTLSAWARE) or
SSL(NO). Reset characteristic: reset to zero |
| Inbound: AT-TLS 1.1 | SOG_TIMES_ATTLS11_INB_USED | Total number of established inbound connections
that used AT-TLS 1.1 protocol, which can come from TCPIPSERVICE with SSL(ATTLSAWARE) or
SSL(NO). Reset characteristic: reset to zero |
| Inbound: AT-TLS 1.2 | SOG_TIMES_ATTLS12_INB_USED | Total number of established inbound connections
that used AT-TLS 1.2 protocol, which can come from TCPIPSERVICE with SSL(ATTLSAWARE) or
SSL(NO). Reset characteristic: reset to zero |
| Inbound: AT-TLS 1.3 | SOG_TIMES_ATTLS13_INB_USED | Total number of established inbound connections
that used AT-TLS 1.3 protocol, which can come from TCPIPSERVICE with SSL(ATTLSAWARE) or
SSL(NO). Reset characteristic: reset to zero |
| Outbound: AT-TLS SSL 3 | SOG_TIMES_ATSSL3_OUTB_USED | Total number of established outbound
connections that used AT-TLS SSL 3 protocol, which can come from URIMAP with USAGE(CLIENT)
SCHEME(HTTP) or WEB OPEN SCHEME(HTTP). Reset characteristic: reset to zero |
| Outbound: AT-TLS 1.0 | SOG_TIMES_ATTLS10_OUTB_USED | Total number of established outbound
connections that used AT-TLS 1.0 protocol, which can come from URIMAP with USAGE(CLIENT)
SCHEME(HTTP) or WEB OPEN SCHEME(HTTP). Reset characteristic: reset to zero |
| Outbound: AT-TLS 1.1 | SOG_TIMES_ATTLS11_OUTB_USED | Total number of established outbound
connections that used AT-TLS 1.1 protocol, which can come from URIMAP with USAGE(CLIENT)
SCHEME(HTTP) or WEB OPEN SCHEME(HTTP). Reset characteristic: reset to zero |
| Outbound: AT-TLS 1.2 | SOG_TIMES_ATTLS12_OUTB_USED | Total number of established outbound
connections that used AT-TLS 1.2 protocol, which can come from URIMAP with USAGE(CLIENT)
SCHEME(HTTP) or WEB OPEN SCHEME(HTTP). Reset characteristic: reset to zero |
| Outbound: AT-TLS 1.3 | SOG_TIMES_ATTLS13_OUTB_USED | Total number of established outbound
connections that used AT-TLS 1.3 protocol, which can come from URIMAP with USAGE(CLIENT)
SCHEME(HTTP) or WEB OPEN SCHEME(HTTP). Reset characteristic: reset to zero |
| Inbound: Full | SOG_HANDSHAKES_FULL_INB | Total number of inbound full TLS
handshakes. Reset characteristic: reset to zero |
| Inbound: Abbreviated | SOG_HANDSHAKES_ABBREV_INB | Total number of inbound abbreviated TLS
handshakes. Reset characteristic: reset to zero |
| Outbound: Full | SOG_HANDSHAKES_FULL_OUTB | Total number of outbound full TLS
handshakes. Reset characteristic: reset to zero |
| Outbound: Abbreviated | SOG_HANDSHAKES_ABBREV_OUTB | Total number of outbound abbreviated TLS
handshakes. Reset characteristic: reset to zero |