VOX_CTI.ini file configuration

The first line of the VOX_CTI.ini file must be [General], and all .ini file items must be placed under this General section. The only compulsory tag in the VOX_CTI ini file is the port tag.

[General] port = 3000

port

The port tag can be set to a single number or to a list of port numbers. For example, to start a listening socket for ports 3000 and 3001 the entry in the .ini file would be port = 3000 3001.

dt_children

The dt_children tag specifies the number of child processes to initially spawn when the VOX_CTI custom server is started. Each Blueworx Voice Response channel that is using the VOX_CTI custom server requires one child process to service the requests. Therefore if dt_children = 20, then 20 channels can simultaneously issue VOX commands without the VOX_CTI custom server having to spawn more children.

The dt_children tag is optional and the default value is 0 as the VOX_CTI custom server will spawn more child processes as they are needed. The minimum and maximum values are 0 and 480 respectively.

vox_timeout

The vox_timeout tag specifies the number of milliseconds to wait for a VOX response after issuing a VOX command. If the VOX response does not arrive before the timeout the VOX_CTI function will return VOX_TIMED_OUT.

The vox_timeout tag is optional and the default value is 5000. The minimum and maximum values are 500 and 60000 respectively.

newcall_timeout

The newcall_timeout tag specifies the number of milliseconds to wait before forcing the association between the state table and the channel (from the VOX Server point of view). This timeout is only used if a call arrives at a channel and a Newcall function has been called whilst an existing channel process or state table is still using the channel (that is, it has not issued a Gone command). Gone is issued automatically after the timeout for the existing channel process or state table, and the Newcall proceeds. The default is to allow the original state table two seconds to issue a Gone response after it detects a hang up.

The newcall_timeout tag is optional and has a default value of 2000. The minimum and maximum values are 500 and 20000 respectively.

send_buffer_size

The send_buffer_size tag specifies the number of VOX commands that can be buffered in the TCP send buffer. As its default value, the TCP send buffer uses the size of the AIX TCP send buffer. However, the default AIX send buffer size is 4096 bytes, which is equivalent to only four VOX commands (each VOX command requires 1024 bytes). It is preferable to increase the AIX TCP send buffer size to 16K bytes (to allow for 16 simultaneous VOX commands) and also to omit the send_buffer_size tag from the .ini file. This can be achieved by using the no command no -o tcp_sendspace = 16384.

The send_buffer_size tag is optional and has a default value of -1 (this means use AIX's TCP send buffer size). The minimum and maximum values are 4 and 128 respectively.

recv_buffer_size

The recv_buffer_size tag specifies the number of VOX requests that can be buffered in the TCP recv buffer. As its default value, the TCP recv buffer uses the size of the AIX TCP recv buffer. However the default AIX buffer size is 4096 bytes which is equivalent to only four VOX responses (each VOX response requires 1024 bytes). It is preferable to increase the AIX TCP recv buffer size to 16K bytes (to allow for 16 simultaneous VOX responses) and also to omit the recv_buffer_size tag from the ini file. This can be achieved by using the no command no -o tcp_recvspace = 16384.

The recv_buffer_size tag is optional and has a default value of -1 (this means use AIX's TCP recv buffer size). The minimum and maximum values are 4 and 128 respectively.