z/OS User Exits › z/OS Middleware User Exits—CICS TCP/IP Direct Connect Exits › TIRSLTMX—CICS Sockets Server Listener TIMEOUT Exit › Purpose

Purpose

This exit can be used to customize the Listener's SELECT API Calls timeout value that controls the wait time involved with accepting new connections (ACCEPT), reading input data, and reading data for error processing. The corresponding values entered in the EZACONFG file are passed to this exit in the seconds field. These values can remain as they are or can be modified. In addition an extra value may be provided at the microsecond level.

The exit provides the opportunity to do the following tasks:

• Modify the value entered for the ACCTIME parameter in the EZACONFG file. This value is used to populate the TIMEOUT Seconds parameter of the SELECT Sockets API call used by the listener to wait for new connections.
• Provide the value to populate the TIMEOUT Microseconds parameter of the SELECT Sockets API call used by the listener to wait for new connections.
• Modify the value entered for the REATIME parameter in the EZACONFG file. This value is used by the listener to populate the TIMEOUT Seconds parameter of the SELECT Sockets API call used by the TISRVLIS listener when first reading input data. In the TISRVMSL listener, it is used as a wait time.
• Provide the value to populate the TIMEOUT Microseconds parameter of the SELECT Sockets API call used by the listener when first reading input data.
• Modify the value used by the Listener to populate the TIMEOUT Seconds parameter of the SELECT Sockets API call used by the listener when reading input data to process error conditions that require sending an error response to the client.
• Modify the value used by the Listener to populate the TIMEOUT Microseconds parameter of the SELECT Sockets API call used by the listener when reading input data to process error conditions that require sending an error response to the client.
• Modify the value to turn on including the IP Address in some of the socket and CICS error messages.