Documentation Center

  • Trial Software
  • Product Updates

delete

Remove job or task object from cluster and memory

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. Invalid objects should be removed 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. These remaining references should be cleared 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 will also be invalid, and you should 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.

Because its data is lost when you delete an object, delete should be used only after you have retrieved all required output data from the effected object.

Examples

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)
Was this topic helpful?