promote
Promote job in MJS cluster queue
Syntax
promote(c,job)
Arguments
|
The MJS cluster object that contains the job. |
|
Job object promoted in the queue. |
Description
promote(c,job)
promotes the job objectjob
, that is queued in the MJS clusterc
.
Ifjob
is not the first job in the queue,promote
exchanges the position ofjob
and the previous job.
Examples
Create and submit multiple jobs to the cluster identified by the default cluster profile, assuming that the default cluster profile uses an MJS:
c = parcluster(); pause(c)% Prevent submissions from running.j - 1 = createJob (c,'Name','Job A'); j2 = createJob(c,'Name','Job B'); j3 = createJob(c,'Name','Job C'); submit(j1);submit(j2);submit(j3);
PromoteJob C
by one position in its queue:
promote(c,j3)
Examine the new queue sequence:
[pjobs,qjobs,rjobs,fjobs] = findJob(c); get(qjobs,'Name')
'Job A' 'Job C' 'Job B'
Tips
After a call topromote
ordemote
, there is no change in the order of job objects contained in theJobs
property of the MJS cluster object. To see the scheduled order of execution for jobs in the queue, use thefindJob
function in the form[pending queued running finished] = findJob(c)
.