%SYN_FREECHN
Get the next available channel
WTSupported in traditional Synergy on Windows
|
WNSupported in Synergy .NET on Windows
|
USupported on UNIX
|
VSupported on OpenVMS
|
%SYN_FREECHN was deprecated in Synergy/DE version 10.3.3g; we recommend you pass a variable with a value of 0 to the OPEN statement instead. This will cause the next free channel number to be used. For example, open(var=0, i, "mylst") |
channel = %SYN_FREECHN([start][, end])
Return value
channel
The number of the next available channel, or 0 if no channel is available. (n)
Arguments
start
(optional) The first channel to consider. (n)
end
(optional) The last channel to consider. (n)
Discussion
%SYN_FREECHN checks the channels between start and end, if specified, and returns the first available channel.
%SYN_FREECHN is not thread safe on Synergy .NET and should not be used in multi-threaded programs.
The example below checks the channels between 101 and 199 and returns the first available channel encountered.
record chn ,i4 proc chn = %syn_freechn(101, 199) if (.not. chn) writes(1, "no channels available")