This topic has not yet been rated - Rate this topic

IScheduler.CloneJob Method

Clones the specified job.

Namespace: Microsoft.Hpc.Scheduler
Assembly: Microsoft.Hpc.Scheduler (in Microsoft.Hpc.Scheduler.dll)

Copy

'Usage
Dim instance As IScheduler
Dim jobId As Integer
Dim returnValue As ISchedulerJob

returnValue = instance.CloneJob(jobId)

Syntax

C++

Copy

ISchedulerJob CloneJob (
	int jobId
)

Copy

ISchedulerJob CloneJob (
	int jobId
)

JScript

Copy

function CloneJob (
	jobId : int
) : ISchedulerJob

Parameters

jobId: The identifier of the job to clone.

Return Value

An ISchedulerJob interface that defines the newly cloned job.

Example

For an example, see Cloning a Job.

Remarks

Only the owner of the job can clone the job. The job can be in any state when cloned.

The state of the new job is Configuring. After modifying the job (if necessary), call the SubmitJob method to schedule the new job to run. If the job is not ready to run, call the AddJob method to save the job in the scheduler.

The method copies all the tasks (and instances for a parametric task) and the following subset of job and task properties.

Cloned job properties	Cloned task properties
AutoCalculateMax	CommandLine
AutoCalculateMin	DependsOn
EncryptedPassword	EndValue
FailOnTaskFailure	Id
IsExclusive	IncrementValue
JobTemplate	IsExclusive
JobType	IsParametric
MaxCores	IsRerunnable
MaxCoresPerNode	MaxCores
MaxMemory	MaxNodes
MaxNodes	MaxSockets
MaxSockets	MinCores
MinCores	MinNodes
MinCoresPerNode	MinSockets
MinMemory	Name
MinNodes	RequiredNodes
MinSockets	RuntimeSeconds
Name	StartValue
NextJobTaskId	StdErrFilePath
NodeGroups	StdInFilePath
OrderBy	StdOutFilePath
Owner	WorkDirectory
Priority
Project
RequestedNodes
RuntimeSeconds
RunUntilCanceled
SoftwareLicense
UnitType
UserName

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 HPC Server 2008, Windows HPC Server 2008 R2, Windows Server 2008 R2, Windows Server 2008, Windows 7, Windows Vista, Windows XP

Target Platforms

Windows Server 2003 R2 with HPC Pack 2008 R2 Client Utilities, Microsoft Windows HPC Server 2008, Windows Server 2008 with HPC Pack 2008 Client Utilities, Windows Vista with HPC Pack 2008 Client Utilities, Windows XP with HPC Pack 2008 Client Utilities, Windows HPC Server 2008 R2, Windows Server 2008 R2 with HPC Pack 2008 R2 Client Utilities, Windows Vista with SP2 and HPC Pack 2008 R2 Client Utilities, Windows XP with SP2 (32-bit version) or SP3 (64-bit version) and HPC Pack 2008 R2 Client Utilities

Reference

IScheduler Interface
IScheduler Members
Microsoft.Hpc.Scheduler Namespace
IScheduler.CreateJob
ISchedulerJob.RestoreFromXml(String)

Build Date:

2012-04-16

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Content Add

FAQ