pbs_rlsjob (3) - Linux Manuals
pbs_rlsjob: release a hold on a pbs batch job
pbs_rlsjob - release a hold on a pbs batch job
int pbs_rlsjob(int connect, char
*job_id, char *hold_type, char *extend)
DESCRIPTIONIssue a batch request to release a hold from a job.
A Release 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 the job from which the hold is to be released, it is specified in the form:
The parameter, contains the type of hold to be released. The possible values are defined in pbs_ifl.h as:
- #define USER_HOLD u
- Available to the owner of the job, the batch operator, and the batch administrator.
- #define OTHER_HOLD o
- Available to the batch operator and the batch administrator.
- #define SYSTEM_HOLD s
- Available only to the batch administrator.
If is either a null pointer or points to a null string, USER_HOLD will be released.
DIAGNOSTICSWhen the batch request generated by pbs_rlsjob() 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.