Configuring a reception application built with the C API

A reception application built with the C API can be configured with keywords in the configuration file.

Use the following keywords in the configuration file to configure a reception application built with the C API.

ActiveConnections=nn: The number of active connections that the reception process should handle.; The number of possible connections range from 2 to 10000.; A number less than the minimum value sets the value to the minimum value unless that number is zero, which means unlimited connections. A number greater than the maximum value sets the value to the maximum value. Not specifying a value, yields the default value of 128.
Applies to the C API only.
ActiveConnectionsSafety=nn: The percentage of ActiveConnections that the number of actual connections permits must be reduced to a specific number before connections can be processed again. This is a threshold value.; Setting ActiveConnections limits the numbers of active connections handled by the C Event Integration Facility reception process.; For example, if ActiveConnections equals 20 and the ActiveConnectionsSafety equals 80, the reception process stops accepting connections when there are 20 connections. The percent can range from 10 to 90. New connections resume when the number of active connections is reduced to 16 (80% of 20) or less.; The default value is 80 and is only used when ActiveConnections has been specified.; A number less than the minimum value sets the value to the minimum value. A number greater than the maximum value sets the value to the maximum value.
Applies to the C API only.
ConnectionsQueued=nn: The approximate number of queued connections that the reception process will handle.; The server socket queues up connections that are waiting to be accepted by the reception process. Connection attempts fail after this limit has been exceeded.; Use this option to limit the number of connections that can be queued. The actual number of connections queued can be slightly more than or less than the value of ConnectionsQueued. The default is 1000. The range of values can be between 1 and 1000. A number less than the minimum value sets the value to the minimum value. A number greater than the maximum value sets the value to the maximum value.
Applies to the C API only.

Example of a reception application build with the C API receiving events over a SOCKET connection:

BufferEvents=YES
BufEvtPath=/tmp/eif_socket_recv.cache

TransportList=t1
t1Type=SOCKET
t1Channels=t_
t_ServerLocation=myserver.com
t_Port=5151

Example of a reception application build with the C API receiving events over an SSL connection:

BufferEvents=YES
BufEvtPath=/tmp/eif_socket_recv.cache

TransportList=t1
t1Type=SSL
t1Channels=t_
t_ServerLocation=myserver.com
t_Port=5151


t_SSLKeystore=/my/other/location/gbkeys.kdb
t_SSLKeystorePW=password
t_SSLCipherList=SSL_RSA_WITH_3DES_EDE_CBC_SHA
t_SSLFIPSMode=OFF

Note: The procedure to configure a keystore for a reception application is identical to that of a sender application.