Base channel number for xfServerPlus

WTSupported in traditional Synergy on Windows
WNSupported in Synergy .NET on Windows
USupported on UNIX
VSupported on OpenVMS

The XFPL_BASECHAN setting specifies the channel number to be used by xfServerPlus to open files, such as the Synergy Method Catalog (SMC) files.


2 through 254.


By default, xfServerPlus uses 243 as the base channel number. This is the channel number that xfServerPlus tries first whenever it needs to open a channel. For example, when opening the SMC files (cdt.ism and cmpdt.ism), xfServerPlus attempts to use channels 243 and 244. If 243 is not available, it tries 244, then 245, and so on until an open channel is found. If your Synergy server applications use hard-coded channels that are in the range used by xfServerPlus, you may receive a “Channel is in use” error ($ERR_CHNUSE). To avoid this problem, set XFPL_BASECHAN in the xfpl.ini file to specify that a different base channel number be used.

For example, if you set


xfServerPlus will attempt to open the SMC files on channels 150 and 151. If 150 is currently in use, xfServerPlus will try 151, then 152, and so on until it finds an open channel. Should xfServerPlus reach channel 255 without finding an open channel, it will go to XFPL_BASECHAN – 1 (149 in our example) and continue down from there to channel 1.

Setting location

The xfpl.ini file.

Used by


See also