IPredModelBuilder::Start

Article
06/07/2013

Ee825118.vb_on(en-US,CS.10).gif

Use this method to create a new model build thread.

Definition

HRESULT IPredModelBuilder::Start(BSTRsDWConnStr,BSTR sSiteName,BSTRsConfigName,BSTRsModelName,BSTRsXMLBuildParams,VARIANT_BOOL bOverWrite,long*plBuildID);

Parameters

sDWConnStr

[in] A BSTR that contains the connection information for the data warehouse.

sSiteName

[in] A BSTR that is not used. Pass an empty string.

sConfigName

[in] A BSTR that contains the model configuration name.

sModelName

[in] A BSTR that contains the model name.

sXMLBuildParams

[in] A BSTR that contains the run-time build parameters for the model in XML format.

bOverWrite

[in] A VARIANT_BOOL that indicates whether to overwrite the model if it already exists.

plBuildID

[out, retval] A pointer to a long that contains the identifier for the new build thread.

Return Values

This method returns an HRESULT indicating whether it completed successfully. See the following Error Values section for more details.

Error Values

This method returns S_OK (0x00000000) to indicate success and standard COM HRESULT error values to indicate failure. For more information about standard COM errors, see Standard COM Errors. Additional information may be available using the global Err object, which can be accessed using the API function GetErrorInfo. In particular, the GetDescription method of the IErrorInfo interface may return a text description of the error.

The following standard COM error value has a particular meaning in the context of this method.

E_FAIL

The overwrite flag is False, and the specified model already exists or the build thread failed.

Remarks

For information on the run-time build parameters contained in the sXMLBuildParams parameter, see PredictorModels Table. The sXMLBuildParams parameter must be passed in as the return value of the SaveXML method of the IPersistXML interface of a Dictionary object containing the build parameters. For an example of this technique, see Code to Build a New Model.

Connect to the data warehouse to access the model configuration.

Associating the site name with the PredModelBuilder object allows logging of performance monitoring counters to be aggregated over the site. See the PredictorClient object for more information.

Use the returned identifier for all subsequent access to the build thread.

If a model with the same name already exists and the overwrite parameter is False, the Start method fails.

The priority of a build thread may be set using the Priority property.

Use the Status property to check the status of a build thread.

Use the Stop method to stop a build thread that is currently running. A stopped thread may not be resumed. The thread must be restarted with the Start method.

Use the Pause method to temporarily suspend the execution of a build thread. Use the Resume method to resume execution of the suspended thread.

For more information about memory ownership issues related to COM property and method parameters, see Managing COM Parameter Memory.

The plBuildID parameter contains valid data only if the method completes successfully.