pbs_orderjob man page
pbs_orderjob — reorder pbs batch jobs in a queue
int pbs_orderjob(int connect, char *job_id1, char *job_id2, char *extend)
Issue a batch request to swap the order of two jobs with a single queue.
An Order Job batch request is generated and sent to the server over the connection specified by connect which is the return value of pbs_connect().
The parameters job_id1 and job_id2 identify which jobs are to be swapped. They are specified in the form: sequence_number.server.
The parameter, extend, is reserved for implementation defined extensions.
qorder(1B), qmove(1B), qsub(1M), and pbs_connect(3B)
When the batch request generated by pbs_orderjob() function has been completed successfully by a batch server, the routine will return 0 (zero). Otherwise, a non zero error is returned. The error number is also set in pbs_errno.