Previous Topic: Default ProcessingNext Topic: Building on z/OS


Customizing the Exit

This is an exit for the TISRVLIS or TISRVMSL listener programs, not the server application. The exit is invoked before TISRVLIS or TISRVMSL accepts a connection from a client and has access to the data sent by the client.

The SLTRANID and the CICSAPPL can be used to decide if the TIMEOUT values provided by the EZACONFG file to be used by the Listener suffice or must be changed.

The Listener Accept TIMEOUT Seconds, as received by this exit contains the value specified in the EZACONFG file for the ACCTIME parameter. This value can be changed, including zeroed out. In addition, if a value smaller than 1 second is required the Listener Accept TIMEOUT Microseconds variable can be used.

The Listener Read TIMEOUT Seconds, as received by this exit contains the value specified in the EZACONFG file for the REATIME parameter. This value can be changed, including zeroed out. In addition, if a value smaller than 1 second is required the Listener Read TIMEOUT Microseconds variable can be used.

When an error condition is encountered that requires the Listener to send an error message to the client, the Listener must first read all the data present at the socket before sending the error message. Part of this read involves a SELECT Sockets API call. The ERRTOUTS and ERRTOUTM values provided in this exit are used to make up this TIMEOUT parameter. The ERRTOUTS value passed to this exit on input is the value specified in the listener code and is zero seconds. The listener code sets the ERROR TIMEOUT - Microseconds to 50. The only opportunity to provide a value for these parameters is in this exit.

The IP Address Flag is set in this exit to turn on the writing of the IP Address as part of some of the socket and CICS error messages. The default is N—do not write the IP Address.

This exit includes sample code that can be used to set the various TIMEOUT parameters as required. Modify the exit to execute the desired code.