Creating an asynchronous resource group
To create an asynchronous resource group, you must set the Type element to Async. Use Disabled to enable or disable the resource group.
Use Volume to indicate whether the resource group is assigned to a specific Encyclopedia volume. Valid settings for Volume are an Encyclopedia volume name or an empty string. If you set an Encyclopedia volume name and a request to generate a job comes from a different volume, BIRT iHub rejects the job. If you set an empty string, you assign the resource group to all Encyclopedia volumes on BIRT iHub.
Set a priority range using MinPriority and MaxPriority. The resource group runs only jobs that have priority settings within this range.
If you set a value in Reserved for an asynchronous resource group, BIRT iHub ignores the value. You can reserve only a synchronous resource group.
In ResourceGroupSettings, indicate the name of the BIRT iHub on which the resource group runs. Set Activate to True or False to indicate whether the BIRT iHub is a member of the resource group. Indicate the maximum number of Factory processes to assign to the resource group. List the executable file types the resource group can run.
The following example creates a resource group to run asynchronous jobs from the Corinth Encyclopedia volume, using any one of two executable file types:
<SOAP-ENV:Body>
<CreateResourceGroup>
<ResourceGroup>
<Name>End-of-Quarter Sales</Name>
<Disabled>false</Disabled>
<Type>async</Type>
<Volume>Corinth</Volume>
<MinPriority>500</MinPriority>
<MaxPriority>1000</MaxPriority>
<Reserved>false</Reserved>
</ResourceGroup>
<ResourceGroupSettingsList>
<ResourceGroupSettings>
<ServerName>Orinda</ServerName>
<Activate>true</Activate>
<MaxFactory>2</MaxFactory>
<FileTypes>
<String>RPTDESIGN</String>
<String>RPTDOCUMENT</String>
</FileTypes>
</ResourceGroupSettings> </ResourceGroupSettingsList>
</CreateResourceGroup>
</SOAP-ENV:Body>
The response to CreateResourceGroup is an empty operation if the job succeeds.
<SOAP-ENV:Body>
<CreateResourceGroupResponse>
</CreateResourceGroupResponse>
</SOAP-ENV:Body>
If the job fails, an error message appears.