This function is used to add the definition of an association to the list of associations read in the client configuration file. If the same name already exists, the old occurrence is replaced.
Important: This function must be used in the program's client part.
Context
Windows client,
Java client,
Adelia Web client,
Adelia Cloud client.
Parameters
ALPHA(30) |
LogicalServerName |
Name of the association's logical server. *ALL All logical servers with no association. |
ALPHA(30) |
PhysicalServerName |
Name of the association's physical server. Special value: *LOCAL: The logical server points to a local connection (without using the Adelia Middleware). |
ALPHA(30) |
DBName |
Name of the database used by the association. *DFT The server's default database is used. *NONE No database is used. |
BOOL |
ReturnCode |
Return code for the operation: *TRUE if the operation was completed successfully. *FALSE if it was not. |
Example
LogicalServerName = 'MY_SERVER'
PhysicalServerName = 'SITE_LONDON'
DBName = '*DFT'
CALL_DLL 'VATOOLBX.DLL' 'VaToolBxAddAssociation' LogicalServerName PhysicalServerName DBName ReturnCode
List of the VaToolBx functions by topic