Windows-based Hosting::ModifyCustomerDatabaseFile

  • Article

The ModifyCustomerDatabaseFile procedure modifies settings for a specified database. This procedure is used to modify the size of the database dataFile and customer database's allocation. This procedure should not be used to modify the datalog file.

Arguments

The ModifyCustomerDatabaseFile procedure has the following input parameters.

Input Argument Description

<org>

The Lightweight Directory Access Protocol (LDAP) path of the owning organization.

<databaseName>

The name of the database to be modified.

<preferredDomainController>

The name of the preferred domain controller.

<logicalName>

The logical name of the database dataFile.

<megabytes>

The size to be allocated to the resource.

<sqlUserName>

The user name for connecting to the SQL server via SQL Authentication. If this node is present, the connection will be made via SQL Authentication rather than Windows Authentication. The existence of this node also requires that the <sqlUserPass/> node exist.

<sqlUserPass>

The password for connecting to the SQL server via SQL Authentication, using the username indicated by <sqlUserName/>. If the <sqlUserName/> node is not present, this node is ignored.

Output Arguments

The ModifyCustomerDatabaseFile procedure has no return values.

Remarks

Security

The ModifyCustomerDatabaseFile procedure has the following security requirements:

  • The caller is impersonated.

  • The caller is tested for OrgCreator permissions.

Process Steps

The following steps occur when modifying a customer database file with the ModifyCustomerDatabaseFile procedure of the Managed Windows-based Hosting Namespace:

  • Modify the size and other attributes of the specified data and log files by calling Managed Data Hosting::ModifyCustomerDatabase.

  • Update Resource Manager allocations.

Sample Code

Example XML Request

The following is an example of an XML request for the ModifyCustomerDatabaseFile procedure of the Managed Windows-based Hosting Namespace:

<request> 
        <procedure> 
                <execute namespace="Windows-based Hosting"  
                procedure="ModifyCustomerDatabaseFile" impersonate="1"> 
                        <executeData> 
                        <preferredDomainController>AD01-wh.fabrikam.com 
                        </preferredDomainController> 
                        <org>LDAP://ou=WbH_Org1,ou=consolidatedMessenger, 
                        ou=hosting,dc=fabrikam,dc=com</org> 
                        <databaseName>TestDB1</databaseName> 
                        <logicalName>name</logicalName> 
                        <megabytes>10</megabytes> 
                        </executeData> 
                        <after source="executeData" destination="data" mode="merge"/> 
                </execute>   
        </procedure> 
</request>

Applies To

Managed Windows-based Hosting Namespace API for:

  • Hosted Messaging and Collaboration version 3.5

  • Hosted Messaging and Collaboration version 3.0

  • Windows-based Hosting version 4.5

  • Windows-based Hosting version 4.0

  • Windows-based Hosting version 3.5

  • Windows-based Hosting for Applications version 1.0

See also

Tasks

Windows-based Hosting::CreateCustomerDatabase
Windows-based Hosting::DeleteCustomerDatabase