Rogue Wave Server 5.5 and 5.4 Release Notes > New Environment Variables
 
New Environment Variables
The following environment variables have been added:
Name of the Variable
Description
Default Value
ILS_IOCTL_RETRIES
On Solaris, it may happen that the FIONREAD ioctl function returns 0 even if the socket is not closed. So, we can ask to retry ioctl call several times when it returns 0. Set the ILS_IOCTL_RETRIES environment variable to set the number of retries.
 
ILS_MVTCP_LISTEN_BACKLOG
Set the backlog of the listen socket.
3
ILS_TCP_USE_RECV_TIMEOUT
When a network failure occurs during reception of a buffer, the ::recv socket operation may block without returning an error. A ::select() call has been added to the MvTCP library, before any call to ::recv, to work around this behavior. To enable this work-around, you have to set up the ILS_TCP_USE_RECV_TIMEOUT environment variable. The time out can be set using the ILS_TCP_RECV_TIMEOUT environment variable (ms). The default value is 30s. If the ::select() times out, a communication error is triggered.
The default behavior when such an error is detected is to close the corresponding connection. This behavior is controlled by the method IlsMvProcess::DisconnectOnComError() which is, by default, set to true.
This behavior can also be triggered by the function:
void SetIlsTcpUseRecvTimeout(IlsBoolean useRecvTimeout, IlsTime recvTimeout).
 
ILS_TCP_RECV_TIMEOUT
Set the recv time out when ILS_TCP_USE_RECV_TIMEOUT is set.
30s
ILS_TCP_IGN_SIGPIPE
Used to ignore the SIGPIPE signal instead of trapping it. As this signal may be triggered by the system during network operation on UNIX® platform, Rogue Wave® Server traps it. In not well defined situation, this signal may still be fired without going through the signal handler defined by Rogue Wave Server and stop the process. This environment variable allows ignoring the signal instead of trapping it.
 
ILS_TCP_DONT_RETRY_ON_SIG
The MvTCP read routine is retrying receiving data when the ::recv system call has been interrupted by a signal. Set this environment variable to raise an exception instead.
 
ILS_TCP_OLDRUNBEHAVIOR
The behavior of the main loop has changed: exceptions are no longer raised if an error occurs during execution of the select command on the MvTcp communication layer; instead, only a trace is generated. This behavior can be changed:
* You can restore the old behavior by setting the environment variable ILS_TCP_OLDRUNBEHAVIOR.
* You can change the default behavior yourself by setting the static variable IlsTcpMvProcess_RunHook. The specification of this variable is:
void (* IlsTcpMvProcess_RunHook)(IlsSocketException & e).
 
ILS_TCP_PACKET_SIZE
ILS_TCP_SEND_PACKET_SIZE
ILS_TCP_RECV_PACKET_SIZE
ILS_TCP_SEND_PACKET_SIZE is defining the size of the packets when sending on a socket and ILS_TCP_RECV_PACKET_SIZE, the size of the packets when receiving from a socket. If ILS_TCP_PACKET_SIZE is defined, it is used instead of these two values for both sending and receiving.
The following functions are also defined that allow to set these values by code:
 
* void SetIlsTcpSendPacketSize(unsigned int size)
* void SetIlsTcpRecvPacketSize(unsigned int size)
 
Note: The Microsoft recommended value for packets size sent into a socket is 4 Mo.
 
ILS_TCPD_EXIT_ON_ERROR
Socket errors occurring in tcpd don't stop the service. Set ILS_TCPD_EXIT_ON_ERROR if you want tcpd to stop when encountering errors.
 
ILS_TCP_OLDRUNBEHAVIOR
In the main loop, no exceptions is raised if an error occurs during execution of the select command on the MvTcp communication layer; but only a trace is generated. This behavior can be changed:
*You can restore the old behavior (which raises an exception) by setting the environment variable ILS_TCP_OLDRUNBEHAVIOR.
*You can change the default behavior yourself by setting the static variable IlsTcpMvProcess::RunHook. The specification of this variable is:
void (* IlsTcpMvProcess_RunHook)(IlsSocketException & e)
 
ILS_USE_MLK
Introduces a new memory allocator dedicated to storing a temporary data structure built when a dynamic view is opened. Sets the variable ILS_USE_MLK to revert to the previous behavior (allocating these data structure in the main Rogue Wave Server memory allocator).
 
ILS_VIEWED_CACHE_INCREMENT
Delays the resizing of an internal cache. This cache was resized (size*2) when a view was opened for the second time, it is now resized later. This variable fixes the extra space available before resizing occurs.
1000

Version 6.1
Copyright © 2016, Rogue Wave Software, Inc. All Rights Reserved.