pbs_holdjob - Man Page

#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.