ICluster::CreateJobFromXml method

Creates a job using the specified XML document.

Syntax


HRESULT CreateJobFromXml(
  [in]  BSTR xmlDocument,
  [out] IJob **pRetVal
);

Parameters

xmlDocument [in]

An XML string that defines the job to create. If the job contains tasks, the tasks are also created. For information about writing the XML string, see Job Schema.

pRetVal [out]

An IJob interface that represents the job.

Return value

If the method succeeds, the return value is S_OK. Otherwise, the return value is an error code. To get a description of the error, call the ICluster::get_ErrorMessage method.

Remarks

The initial state of the job is JobStatus_NotSubmitted. After creating the job, call the ICluster::AddJob method to add the job to the cluster. If the XML did not contain tasks, you can then call the ICluster::AddTask or ICluster::AddTasks method to add one or more tasks to the job. When the job is ready (you have added all the tasks and set all the job terms), call the ICluster::SubmitJob method to add the job to the scheduling queue.

To add and submit the job in one step, call the ICluster::QueueJob method. If the XML did not contain tasks, call the IJob::AddTask method to add tasks to the job before calling the QueueJob method.

Requirements

Product

Compute Cluster Pack Client Utilities

Type library

Ccpapi.tlb

See also

ICluster
ICluster::AddJob
ICluster::CreateJob
ICluster::CreateJobFromXmlFile
ICluster::CreateTaskFromXml

 

 

Show: