TCP/IP Analysis situations

The predefined situations in this category monitor CICS's use of TCP/IP services.

Note:
All the attribute names in this group are prefixed with CICSplex_Internet_Status. except where stated
CICSplex_TCPIP_Critical
Critical threshold exceeded for TCP/IP.

CICS internal sockets support has not yet been activated or has been terminated. If CICS internal sockets supported is required, set the System Initialization Table's TCP parameter to YES.

Formula

If the value of CICSplex_TCPIP_Statistics.Open_Status does not equal Open
then situation CICSplex_TCPIP_Critical is true.
CICSplex_TCPIPDis_Warning
Warning threshold exceeded for TCP/IP: exit not enabled.

Issue the EZAO,START,CICS transaction to start the CICS Sockets Interface and enable the Task Related User Exit. If the interface successfully initializes, consider placing EZACIC20 into the PLT so that the Sockets Interface will automatically initialize when CICS is started. If the interface does not initialize, check the CICS message logs for diagnostic information.

Formula

If the value of TCP/IP_Exit_Not_Enabled equals Yes
then situation CICSplex_TCPIPDis_Warning is true.
CICSplex_TCPIPDis_Critical
Critical threshold exceeded for TCP/IP: exit not enabled.

Issue the EZAO,START,CICS transaction to start the CICS Sockets Interface and enable the Task Related User Exit. If the interface successfully initializes, consider placing EZACIC20 into the PLT so that the Sockets Interface will automatically initialize when CICS is started. If the interface does not initialize, check the CICS message logs for diagnostic information.

Formula

If the value of TCP/IP_Exit_Not_Enabled equals Yes
then situation CICSplex_TCPIPDis_Critical is true.
CICSplex_TCPIPFail_Warning
Warning threshold exceeded for TCP/IP: listener failure.

Examine the CICS message logs for an explanation of why one or more listener tasks have failed. The EZAC transaction of CICS can be used to verify the configuration of each defined listener. Specific information concerning tasks associated with failed listeners can be obtained using the TCP/IP display of the OMEGAMON XE for CICS on z/OS product.

Formula

If the value of TCP/IP_Listener_Failed equals Yes
then situation CICSplex_TCPIPFail_Warning is true.
CICSplex_TCPIPFail_Critical
Critical threshold exceeded for TCP/IP: listener failure.

Examine the CICS message logs for an explanation of why one or more listener tasks have failed. The EZAC transaction of CICS can be used to verify the configuration of each defined listener. Specific information concerning tasks associated with failed listeners can be obtained using the TCP/IP display of the OMEGAMON XE for CICS on z/OS product.

Formula

If the value of TCP/IP_Listener_Failed equals Yes
then situation CICSplex_TCPIPFail_Critical is true.
CICSplex_TCPIPService_Warning
Warning threshold exceeded for TCPIPService

CICS internal sockets support has not yet been activated or has been terminated for this service. If CICS internal sockets support is required, verify that the System Initialization Table parameter TCP has been set to YES and that the service has been defined to open when CICS is started.

Formula

If the value of CICSplex_TCPIP_Service_Statistics.Open_Status
 does not equal OpenCICSplex_TCPIPService_Warning
then situation CICSplex_TCPIPService_Warning is true.
CICSplex_TCPIPWait_Warning
Warning threshold exceeded for TCP/IP: application wait.

Use the TCP/IP Sockets Activity report of OMEGAMON XE for CICS on z/OS to locate the tasks that are waiting for a socket request. If the application is waiting for a READ command to complete, consider issuing a SELECT command prior to the READ request. The SELECT command will indicate whether sockets are ready to be read. Additional information on application status can be obtained using the TSO command NETSTAT SOCKET.

Formula

If the value of TCP/IP_Application_Waiting equals Yes
then situation CICSplex_TCPIPWait_Warning is true.
CICSplex_TCPIPWait_Critical
Critical threshold exceeded for TCP/IP: application wait.

Use the TCP/IP Sockets Activity report of OMEGAMON XE for CICS on z/OS to locate the tasks that are waiting for a socket request. If the application is waiting for a READ command to complete, consider issuing a SELECT command prior to the READ request. The SELECT command will indicate whether sockets are ready to be read. Additional information on application status can be obtained using the TSO command NETSTAT SOCKET.

Formula

If the value of TCP/IP_Application_Waiting equals Yes
then situation CICSplex_TCPIPWait_Critical is true.

See also the CICSplex TCPIP Statistics attribute group.