You can define more than one configuration for connection to the database. You can do this static via the configuration file or dynamic via the addConfiguration function. It is possible to tell DAL which configuration to use when connecting to the database. If you don't specify a configuration to use DAL will use the first configuration that occurs in the list.
boolean addConfiguration( string $configName
, string $userName
, string $password
, string $connectString
);
The adding of a configuration can be rejected by DAL. This can be due the name not being unique. In this case you get a nice error message telling that the name is not unique and the addconfiguration function returns false. Another thing that can occur is that the configuration is locked. When setting up DAL it is possible to lock the configuration (see also the config file).
Selecting a specified configuration can be done with the function selectConfiguration .
boolean selectConfiguration( string $name
);