Selecting Advantage Server Types via the ADS.INI File

Advantage Concepts

The ADS_SERVER_TYPE key in the ADS.INI file can be used to select the Advantage server type(s) to use when obtaining an Advantage server connection if the server type is not specified programmatically within the Advantage application. The available Advantage Server types are ADS_REMOTE_SERVER (Advantage Database Server), ADS_AIS_SERVER (Advantage Internet Server), and ADS_LOCAL_SERVER (Advantage Local Server). ADS_REMOTE_SERVER has the value 2, ADS_AIS_SERVER has the value 4, and ADS_LOCAL_SERVER has the value 1. For example, if you wanted your Advantage application to attempt to connect to all Advantage server types, if necessary, you need to set the value for the ADS_SERVER_TYPE key to 7 (1 + 2 + 4 = 7). The default ADS_SERVER_TYPE value is to use ADS_REMOTE_SERVER and ADS_AIS_SERVER, which are 6 (2 + 4 = 6). See ads.ini File Support for more information.

For more information on programmatically selecting the Advantage server type, that is, not using the ADS.INI setting, see the appropriate Help documentation for the following products:

Note Each Advantage product and their corresponding help files are installed separately. You need to only reference the Help file associated with the product that you have installed.

Note The ADS_SERVER_TYPE value will only change the default Advantage server type setting. If your application programmatically changes the Advantage server type setting, it will override the ADS_SERVER_TYPE value in the ADS.INI file.

If the Advantage server types in which to connect are specified as either the Advantage Database Server or the Advantage Local Server, the Advantage application will first attempt to connect to the Advantage Database Server and then to the Advantage Local Server if the Advantage Database Server is not available. The very first connect attempt to the Advantage Database Server may take up to two seconds to time out if the Advantage Database Server is not available before automatically attempting to connect to the Advantage Local Server. The two second timeout will only occur if the Advantage Database Server is not present on the specified server and if the Advantage remote communication DLL (AXCWS32.DLL) is located in the client PC's search path. If the Advantage remote communication DLL is NOT located in the client PC's search path, the connection timeout to the Advantage Database Server will be immediate.