With the VDBManagement action, you can dynamically (without restarting the Distributed Action Handler) bring VDBs online or take them offline, when running in non-Mirror mode.

If a VDB is marked as offline, the Distributed Action Handler sends no requests (even polling requests) to it, until it is brought back online again.

Note: This is an administrative action that can be sent only from Distributed Action HandlerAdminClients (which are set in the Distributed Action Handler configuration file [Server] section).



This action uses port 25000 to take offline the VDBs with IDs 2 and 4 of the Distributed Action Handler on the host Hobbes.


Parameter Description Required
VDBAction The action to take on the specified VDBs. Yes
VDBID The IDs of the VDBs to perform the specified action on. see Comments
VDBInternal Whether to make the virtual database internal.  
VDBName The names of the VDBs to perform the specified action on. see Comments
VDBMapsTo The database(s) to which the virtual database is mapped.  
VDBType Type of virtual databases, identified by either Distributor or Combinator.  

This action accepts the following standard ACI action parameters:

Parameter Description
ActionID A string to use to identify an ACI action.
EncryptResponse - Deprecated Encrypt the output.
FileName The file to write output to.
ForceTemplateRefresh Forces the server to load the template from disk.
Output Writes output to a file.
ResponseFormat The format of the action output.
Template The template to use for the action output.
TemplateParamCSVs A list of variables to use for the specified template.