Address In Use

When using a fixed port range on some IBM systems (and possibly other platforms), the machine can return a message for ‘address in use’ in an unexpected language. This would prevent the Server process from opening the next port in the range and creating a session for the connecting device. This would likely prevent the connection of more than one device, since the first session should be able to use the first port in the fixed port range.

The StayLinked ‘Handler’ log (if enabled) file should show a BindException error reporting that the Server could not open the requested port. In this scenario, it is because the StayLinked Server does not know the port is in use and cannot be used to create a session.

This can be corrected by providing the StayLinked Server with a special configuration file. Create a plain text file named addressinuse.txt and enter the address in use text as the only contents as it appears in the Handler log.

For example, in Italian the string might look like this:
socket è già in uso

The text file should not contain any contents other than this string.

Place this file in the StayLinked directory and trigger a reload of the server configuration file. This is done with a restart the server process, placement of an empty reload.xml file in the config subdirectory or touch of the Server Configuration > Server Settings dialogue contents.

This file will be used by the server to identify the address in use phrase for new connection requests after receiving a bind exception to move on to the next port. It is recommended that you cut and paste this message from the log file to ensure accuracy in the character codes.