This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English version of the page.

Note: This page has been translated by MathWorks. Click here to see
To view all translated materials including this page, select Country from the country navigator on the bottom of this page.


Promote job in MATLAB Job Scheduler cluster queue





The MATLAB® Job Scheduler cluster object that contains the job.


Job object promoted in the queue.


promote(c,job) promotes the job object job, that is queued in the MATLAB Job Scheduler cluster c.

If job is not the first job in the queue, promote exchanges the position of job and the previous job.


Create and submit multiple jobs to the cluster identified by the default cluster profile, assuming that the default cluster profile uses an MATLAB Job Scheduler:

c = parcluster();
pause(c) % Prevent submissions from running.

j1 = createJob(c,'Name','Job A');
j2 = createJob(c,'Name','Job B');
j3 = createJob(c,'Name','Job C');

Promote Job C by one position in its queue:


Examine the new queue sequence:

[pjobs,qjobs,rjobs,fjobs] = findJob(c);
    'Job A'
    'Job C'
    'Job B'


After a call to promote or demote, there is no change in the order of job objects contained in the Jobs property of the MATLAB Job Scheduler cluster object. To see the scheduled order of execution for jobs in the queue, use the findJob function in the form [pending queued running finished] = findJob(c).

Introduced before R2006a