delete

Remove job or task object from cluster and memory

collapse all in page

Syntax

delete(obj)

Description

delete(obj) removes the job or task object, obj, from the local MATLAB® session, and removes it from the cluster's JobStorageLocation. When the object is deleted, references to it become invalid. You can remove invalid objects from the workspace with the clear command. If multiple references to an object exist in the workspace, deleting one reference to that object invalidates the remaining references to it. Clear the remaining references from the workspace with the clear command.

When you delete a job object, this also deletes all the task objects contained in that job. Any references to those task objects also become invalid, and you can clear them from the workspace.

If obj is an array of objects and one of the objects cannot be deleted, the other objects in the array are deleted and a warning is returned.

When you delete an object, you lose any data in the job or task object. You must use delete only after you retrieve all required output data from the job or task object.

example

Examples

collapse all

Create a job object using the default profile. Then delete the job.

myCluster = parcluster;
j = createJob(myCluster,'Name','myjob');
t = createTask(j,@rand,1,{10});
delete(j);
clear j t

Delete all jobs on the cluster identified by the profile myProfile.

myCluster = parcluster('myProfile');
delete(myCluster.Jobs)

Use the syntax with multiple outputs of findJob to obtain the jobs by state. In this example, delete the pending jobs.

myCluster = parcluster;
[pending queued running completed] = findJob(myCluster);
delete(pending);

Alternatively, use findJob to retrieve the jobs that match a specific state. In this example, find the jobs in state failed and delete them.

myCluster = parcluster;
failed = findJob(myCluster,'State','failed');
delete(failed);

Input Arguments

collapse all

Job or task object to delete, specified as a parallel.Job or parallel.Task object. You can create jobs and tasks with createJob and createTask.

Data Types: parallel.Job | parallel.Task

Version History

Introduced in R2012a

See Also

| | | | |