IJob::put_Runtime method

Sets the run-time limit for the job.

Syntax

HRESULT put_Runtime(
  [in] BSTR Val
);

Parameters

  • Val [in]
    The run-time limit. The value can be "Infinite" or a string in the format dd:hh:mm where dd is the number of days, hh is the number of hours, and mm is the number of minutes. You must provide leading zeros; for example, to specify a run time of one minute, use the string "00:00:01". The default is "Infinite".

Return value

If the method succeeds, the return value is S_OK. Otherwise, the return value is an error code.

Remarks

The wall clock is used to determine the run time. The time is your best guess of how long the job will take; however, it needs to be fairly accurate because it is used to allocate resources. If the job exceeds this time, the job is terminated and its status becomes JobStatus_Cancelled.

For more information, see the JobRuntime configuration parameter in the Remarks section of ICluster::SetClusterParameter.

The sum of all ITask::put_Runtime values should be less than the run-time value for the job.

Requirements

Product

Compute Cluster Pack Client Utilities

Type library

Ccpapi.tlb

See also

IJob

IJob::get_Runtime

ITask::put_Runtime