3.1.4.13 GetRollupConfiguration

A DSS calls the GetRollupConfiguration method to obtain information on the USS's report rollup configuration settings.

 <wsdl:operation name="GetRollupConfiguration">
   <wsdl:input message="tns:GetRollupConfigurationSoapIn" />
   <wsdl:output message="tns:GetRollupConfigurationSoapOut" />
 </wsdl:operation>

The SOAP operation is defined as follows.

 <soap:operation soapAction="http://www.microsoft.com/SoftwareDistribut
 ion/GetRollupConfiguration" style="document" />

Request validation:

The USS performs no input validation.

Data processing:

The USS MUST compose a GetRollupConfigurationResponse message in response, as follows:

  1. DoDetailedRollup: Set to the DoDetailedRollup value stored in the Server Configuration Table.

  2. RollupResetGuid: Set to the RollupResetGuid value stored in the Server Configuration Table.

  3. ServerId: Set to the ServerID value stored in the Server Configuration Table.

  4. RollupDownstreamServersMaxBatchSize: Set to the maximum number of DownstreamServerRollupClientSummary structures the USS will accept in a single RollupDownstreamServers request, summed across all DownstreamServerRollupInfo structures in the request. The value is implementation-specific.<46>

  5. RollupComputersMaxBatchSize: Set to the maximum number of ComputerRollupInfo structures the USS will accept in a single RollupComputers request. The value is implementation-specific.<47>

  6. GetOutOfSyncComputersMaxBatchSize: Set to the maximum number of ComputerLastRollupNumber structures the USS will accept in a single GetOutOfSyncComputers request. The value is implementation-specific.<48>

  7. RollupComputerStatusMaxBatchSize: Set to the maximum number of ComputerStatusRollupInfo structures the USS will accept in a single RollupComputerStatus request. The value is implementation-specific.<49>

Response:

If no errors occur during processing, the USS MUST return the response to the DSS. If an error occurs during processing, the USS MUST return a SOAP fault indicating that an error occurred. This protocol does not define a mechanism for returning information on the cause of the failure. The DSS MUST stop the protocol when a SOAP fault is received.