SOMAXCONN statement

Use the SOMAXCONN statement to specify the maximum number of connection requests queued for any listening socket.

Syntax

Rule: Specify the parameters in the order shown here.


   .-SOMAXCONN 1024------------------.   
>>-+---------------------------------+-------------------------><
   '-SOMAXCONN --maximum_queue_depth-'

Parameters

maximum_queue_depth

The maximum number of pending connection requests queued for any listening socket. The minimum value is 1, the maximum value is 2147483647, and the default value is 1024.

This number is stored as a fullword integer, but most implementations of TCP/IP hardcode a value in the range 5 - 10.

This number is the maximum depth for any listening stream socket, but you can specify a shorter queue length when the listen performed for the socket.

Steps for modifying

To modify parameters for the SOMAXCONN statement, you must respecify the statement with the new parameters.

Examples

This example shows a SOMAXCONN statement specifying the default number of listening sockets.

SOMAXCONN                   1024

Usage notes

A SOMAXCONN constant with a value of 10 is defined in the SOCKET.H header file. If your C socket programs use this constant to determine the acceptable maximum listening backlog queue length, remember to change the header file to specify the value that you specified for TCP/IP for the maximum_queue_depth on the SOMAXCONN statement.