TCP/IP report

The TCP/IP report is produced using a combination of EXEC CICS INQUIRE TCPIP and EXEC CICS EXTRACT STATISTICS TCPIP commands. The statistics data is mapped by the DFHSOGDS DSECT.

Table 1. Fields in the TCP/IP report
Field Heading Description
TCP/IP Status The current status of TCP/IP for this CICS® system.

Source field: EXEC CICS INQUIRE TCPIP OPENSTATUS()

SSLCACHE setting The setting for the SSLCACHE system initialization parameter, which specifies whether SSL is to use the local or sysplex caching of session ids.

Source field: SOG-SSLCACHE

Active SSL TCBs The number of S8 TCBs in the SSL pool.

Source field: INQUIRE DISPATCHER ACTSSLTCBS()

Maximum SSL TCBs (MAXSSLTCBS) The maximum number of S8 TCBs allowed in the SSL pool, as specified by the MAXSSLTCBS system initialization parameter.

Source field: INQUIRE DISPATCHER MAXSSLTCBS()

Max IP sockets (MAXSOCKETS) limit The maximum number of IP sockets that can be managed by the CICS sockets domain.

Source field: SOG-MAXSOCKETS-LIMIT

Times the MAXSOCKETS limit was reached The number of times the maximum number of IP sockets limit (MAXSOCKETS) was reached.

Source field: SOG-TIMES-AT-MAXSOCKETS

Current Active IP sockets The current number of IP sockets managed by the CICS sockets domain.

Source field: EXEC CICS INQUIRE TCPIP ACTSOCKETS()

Current number of inbound sockets The current number of inbound sockets.

Source field: SOG-CURR-INBOUND-SOCKETS

Current non-persistent inbound sockets The current number of non-persistent inbound sockets.

Source field: SOG-CURR-NPERS-INB-SOCKETS

Current persistent inbound sockets The current number of persistent inbound sockets.

Source field: SOG-CURR-INBOUND-SOCKETS - SOG-CURR-NPERS-INB-SOCKETS

Peak number of inbound sockets The peak number of inbound sockets.

Source field: SOG-PEAK-INBOUND-SOCKETS

Peak non-persistent inbound sockets The peak number of non-persistent inbound sockets.

Source field: SOG-PEAK-NPERS-INB-SOCKETS

Peak persistent inbound sockets The peak number of persistent inbound sockets.

Source field: SOG-PEAK-PERS-INB-SOCKETS

Number of inbound sockets created The total number of inbound sockets created.

Source field: SOG-INBOUND-SOCKETS-CREATED

Non-persistent inbound sockets created The total number of non-persistent inbound sockets created.

Source field: SOG-NPERS-INB-SOCKETS-CREATED

Persistent inbound sockets created The total number of persistent inbound sockets created.

Source field: SOG-INB-SOCKETS-CREATED - SOG-NPERS-INB-SOCKETS-CREATED

Current number of outbound sockets The current number of outbound sockets.

Source field: SOG-CURR-OUTB-SOCKETS + SOG-CURR-PERS-OUTB-SOCKETS

Current non-persistent outbound sockets The current number of non-persistent outbound sockets.

Source field: SOG-CURR-OUTB-SOCKETS

Current persistent outbound sockets The current number of persistent outbound sockets.

Source field: SOG-CURR-PERS-OUTB-SOCKETS

Peak number of outbound sockets The peak number of both persistent and non-persistent outbound sockets.

Source field: SOG-PEAK-BOTH-OUTB-SOCKETS

Peak non-persistent outbound sockets The peak number of non-persistent outbound sockets.

Source field: SOG-PEAK-OUTB-SOCKETS

Peak persistent outbound sockets The peak number of persistent outbound sockets.

Source field: SOG-PEAK-PERS-OUTB-SOCKETS

Total times pooled sockets reused The total number of times a pooled connection was reused.

Source field: SOG-TIMES-OUTB-REUSED

Number of outbound sockets created The total number of outbound sockets created.

Source field: SOG-OUTBOUND-SOCKETS-CREATED

Persistent outbound sockets created The total number of persistent outbound sockets created.

Source field: SOG-PERS-OUTBOUND-CREATED

Number of outbound sockets closed The total number of outbound sockets closed.

Source field: SOG-OUTBOUND-SOCKETS-CLOSED

Total number of inbound and outbound sockets created The total number of inbound and outbound sockets created.

Source field: SOG-INBOUND-SOCKETS-CREATED + SOG-OUTBOUND-SOCKETS-CREATED

Create socket requests delayed by MAXSOCKETS The number of create socket requests that were delayed because the system had reached the MAXSOCKETS limit.

Source field: SOG-DELAYED-AT-MAX-SOCKETS

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

Source field: SOG-QTIME-AT-MAX-SOCKETS

Average MAXSOCKETS delay time The average time that a create socket request was delayed because the system had reached the MAXSOCKETS limit.

Source field: SOG-QTIME-AT-MAX-SOCKETS / SOG-DELAYED-AT-MAX-SOCKETS

Create requests that timed-out at MAXSOCKETS The number of create socket requests that were timed out while delayed because the system had reached the MAXSOCKETS limit.

Source field: SOG-TIMEDOUT-AT-MAXSOCKETS

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

Source field: SOG-CURR-DELAYED-AT-MAX

Peak create socket reqs delayed by MAXSOCKETS The peak number of create socket requests delayed because the system had reached the MAXSOCKETS limit.

Source field: SOG-PEAK-DELAYED-AT-MAX

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

Source field: SOG-CURRENT-QTIME-AT-MAX

Average delay for current requests The average delay time for the create socket requests that are currently delayed because the system is at the MAXSOCKETS limit.  

Source field: SOG-CURRENT-QTIME-AT-MAX / SOG-CURR-DELAYED-AT-MAX

Performance tuning for HTTP connections Indicates whether performance tuning for HTTP connections is enabled.  

Source field: SOG-SOTUNING

Listener pausing listening for HTTP connections 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.

Source field: SOG-PAUSING-HTTP-LISTENING

Times listener notified at task 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.

Source field: SOG-TIMES-AT-ACCEPT-LIMIT

Last time paused 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

Source field: SOG-TIME-LAST-PAUSED-LISTENING

Region stopping HTTP connection 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.

Source field: SOG-STOPPING-PERSISTENCE

Times region stopped HTTP connection persistence 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.

Source field: SOG-TIMES-STOPPED-PERSISTENT

Region last stopped persistence 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. If the DFH0STAT report shows the date and time as --/--/---- --:--:--:----, that indicates that this situation has not occurred since the statistics were last reset.  

Source field: SOG-TIME-LAST-STOPPED-PERSIST

Persistent connections made non-persistent The number of times a persistent HTTP connection was made non-persistent because the number of tasks in the region had exceeded the limit.  

Source field: SOG-TIMES-MADE-NON-PERSISTENT

Times disconnected a connection at max uses The number of times a persistent HTTP connection was disconnected because the number of uses had exceeded the limit.  

Source field: SOG-TIMES-CONN-DISC-AT-MAX