gtpi1m56 | System Installation Support Reference |
The TCP/IP native stack support accept connection user exit, UACC, allows
you to verify a remote client connection request.
UACC is called when an accept or activate_on_accept
function call is made for a socket that uses TCP/IP native stack
support.
UACC is called in segments C511 and CTSG.
Input
- userexit_s
- The file descriptor of a new socket associated with the client connection
request.
- userexit_addr
- A pointer to the socket address buffer that contains the client address
information.
- userexit_addrlen
- The size of the socket address buffer.
Programming Considerations
- IBM provides sample code for UACC, which accepts all new client connection
requests.
- All entry control block (ECB) fields and data levels must be returned to
the caller in the same state they were on entry.
- UACC is a subsystem-unique dynamic load module (DLM).
- If UACC rejects the connection request:
- The TPF system issues a close function call for the new
socket.
- The TPF system returns -1 with sock_errno set to
SOCACCES.
Return Values
UACC returns one of the following values:
- -1
- Reject the connection request.
- userexit_s
- Accept the connection request.