Click above to get retro games delivered to your door ever month!

 SPXConnFreeGet()
------------------------------------------------------------------------------
 Purpose:
 Get the number of available SPX connections.

 Syntax:
 iConFree = SPXConnFreeGet()

 Parameters:
 None.

 Returns:
 A numeric value (signed short int).

 The CA-Clipper name for this function is:
 SPXConFreGet()

 Description:
 SPXConnFreeGet() returns the number of available SPX connections on the
 calling workstation. The SHELL limits the number of simultaneous SPX
 connections for each workstation. By default the limit is 15, of which
 one is used by NETX. SPXConnFreeGet() should be called before attempting
 to establish an SPX connection to ensure there is a free connection slot.

 SPXConnFreeGet() returns NOVERRINT if an error occurs.

 Example:
 // To find out if there are any free SPX connection slots:
 iSPXConn = SPXConnFreeGet()
 if (iSPXConn != NOVERRINT)
    if iSPXConn > 0
       ? "There are ",iSPXConn," available SPX connections."
    else
       ? "There are NO available SPX connections."
    endif
 else
    ? "An error occurred"
 endif

 Notes:
 The maximum number of SPX connection slots can be increased by
 adding the line:

 SPX CONNECTIONS=< number >
 in SHELL.CFG file for the workstation.