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

Purpose

The user ID passed in the commarea section of the data is translated from the client's ASCII to the server's EBCDIC code page. In addition, the exit provides the opportunity to do the following:

• Modify the user ID supplied by the client application before it is translated.
• Validate the supplied, optionally modified, and translated security data through an External Security Manager.
• Verify that an enhanced security buffer exists.
• Perform customer-specific security authorization.
• Use the Port and IP Address data for customer-specific activities.
• Provide a System ID to use to transaction route the server via the SYSID operand of the EXEC CICS START API call.
• Modify the value entered for the GIVTIME 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 the socket to be taken (using the GIVESOCKET/TAKESOCKET process) by the server.
• Provide a value to populate the TIMEOUT Microseconds parameter of the SELECT Sockets API call used by the Listener to wait for the socket to be taken by the server.
• Provide a CICS TERMID to be used to start the server transaction.
• Set the Check flag so that the servers are started with the NOCHECK parameter.