Learn more about Parallel Computing Toolbox

getAllOutputArguments - Output arguments from evaluation of all tasks in job object

Syntax

data = getAllOutputArguments(obj)

Arguments

`obj`	Job object whose tasks generate output arguments.
`data`	M-by-N cell array of job results.

Description

data = getAllOutputArguments(obj) returns data, the output data contained in the tasks of a finished job. If the job has M tasks, each row of the M-by-N cell array data contains the output arguments for the corresponding task in the job. Each row has N columns, where N is the greatest number of output arguments from any one task in the job. The N elements of a row are arrays containing the output arguments from that task. If a task has less than N output arguments, the excess arrays in the row for that task are empty. The order of the rows in data will be the same as the order of the tasks contained in the job.

Remarks

If you are using a job manager, getAllOutputArguments results in a call to a remote service, which could take a long time to complete, depending on the amount of data being retrieved and the network speed. Also, if the remote service is no longer available, an error will be thrown.

Note that issuing a call to getAllOutputArguments will not remove the output data from the location where it is stored. To remove the output data, use the destroy function to remove the individual task or their parent job object.

The same information returned by getAllOutputArguments can be obtained by accessing the OutputArguments property of each task in the job.

Examples

Create a job to generate a random matrix.

jm = findResource('scheduler','type','jobmanager', ...
          'name','MyJobManager','LookupURL','JobMgrHost');
j = createJob(jm, 'Name', 'myjob');
t = createTask(j, @rand, 1, {10});
submit(j);
data = getAllOutputArguments(j);

Display the 10-by-10 random matrix.

disp(data{1});
destroy(j);