ITask.Runtime Property

Article
04/17/2009

Retrieves or sets the run-time limit for the task.

Namespace: Microsoft.ComputeCluster
Assembly: CcpAPI (in ccpapi.dll)

Usage

Syntax

'Declaration
Property Runtime As String

string Runtime { get; set; }

property String^ Runtime {
    String^ get ();
    void set (String^ value);
}

/** @property */
String get_Runtime ()

/** @property */
void set_Runtime (String value)

function get Runtime () : String

function set Runtime (value : String)

Property Value

The run-time limit for the task. 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.

Remarks

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

If the task's run-time value is greater than the job's run-time value, then the task will run until it exceeds the job's run-time value. If this occurs, the task is terminated and its status becomes Failed.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

Microsoft Windows Compute Cluster Server 2003, Windows Server 2003, Windows XP

Target Platforms

Microsoft Windows Compute Cluster Server 2003, Windows Server 2003 with Compute Cluster Pack Client Utilities, Windows XP with Compute Cluster Pack Client Utilities