| pbs_holdjob - place a hold on a pbs batch job |
|
#include <pbs_error.h> #include <pbs_ifl.h> |
int pbs_holdjob(int connect, char *job_id, char *hold_type, char *extend) |
| Issue 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 connect which is the return value of pbs_connect(). |
| The argument, job_id, identifies which job is to be held, it is specified in the form: sequence_number.server |
| The parameter, hold_type, contains the type of hold to be applied. 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 hold_type is either a null pointer or points to a null string, USER_HOLD will be applied. |
| The parameter, extend, is reserved for implementation defined extensions. |
| qhold(1B) , pbs_connect(3B) , pbs_alterjob(3B) , and pbs_rlsjob(3B) |
| When 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. |