pbs_holdjob (3) - Linux Man Pages
pbs_holdjob: place a hold on a pbs batch job
pbs_holdjob - place a hold on a pbs batch job
int pbs_holdjob(int connect, char
*job_id, char *hold_type, char *extend)
DESCRIPTIONIssue a batch request to place a hold upon a job.
A Hold Job batch request is generated and sent to the server over the connection specified by which is the return value of pbs_connect().
The argument, identifies which job is to be held, it is specified in the form:
contains the type of hold to be applied. The possible values are
defined in pbs_ifl.h as:
Available to the owner of the job, the batch operator, and the batch administrator.
Available to the batch operator and the batch administrator.
Available only to the batch administrator.
If is either a null pointer or points to a null string, USER_HOLD will be applied.
DIAGNOSTICSWhen the batch request generated by pbs_holdjob () 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.