KEEPALIVE (JANUS DEFINE parameter)

<section begin="desc" />xxxx<section end="desc" />

KEEPALIVE is a parameter on JANUS DEFINE, which defines and sets characteristics of a Janus port. See the List of JANUS DEFINE parameters.

i1 id=kpalv.Keep-Alive connections, HTTP

The KEEPALIVE parameter indicates the number of seconds a TCP/IP connection is to be held open after an HTTP request on that connection. KEEPALIVE must be followed by a single number between 0 and 32767, which indicates the maximum number of seconds to held the connection open. A setting of 0 means no keep-alive.

For WEBSERV ports, this parameter tells Janus Web Server to keep HTTP connections from a client (often a browser) open for the indicated period of time. For CLSOCK ports, KEEPALIVE tells Janus Sockets to keep an HTTP connection to a web server open for the indicated period of time, and to reuse that connection for other requests to the same server.

ih1 seeid=kpalv.Persistent connection Keep-alive connections, more often referred to as persistent connections, can reduce network traffic and, more significantly, HTTP request latency. Both of these benefits are magnified for SSL connections, where each HTTP request requires a TCP/IP and SSL connection-establishment handshake.

For a Janus Web Server connection to be held open, the client/browser must indicate that it supports HTTP keep-alives. For a Janus Sockets connection to be held open, the web server must indicate that it supports HTTP keep-alives. Most modern browsers and web servers support and take advantage of keep-alives.

For more information about using keep-alives with Janus Web Server, see the Janus Web Server Reference Manual. For more information about using keep-alives with Janus Sockets HTTP client requests, see the Janus Sockets Reference Manual.

The KEEPALIVE parameter is valid only for Janus Web Server and for Janus Sockets CLSOCK ports used for HTTP traffic (that is, not for SMTP connections).

The KEEPALIVE parameter is valid for Janus Sockets CLSOCK but not SRVSOCK ports. It is also not valid for SMTP connections. For more information about using keep-alives with Janus Sockets HTTP client requests, see :hdref refid=keepalc..

The KEEPALIVE parameter is valid for Janus Sockets CLSOCK ports but not Janus Sockets SRVSOCK ports. For more information about using keepalives with Janus Web Server, see :hdref refid=keepals..

KEEPALIVE is new as of Sirius Mods Version 6.8.

References

See: List of Janus commands | List of JANUS DEFINE parameters.