1pbs_rlsjob(3B)                        PBS                       pbs_rlsjob(3B)
2
3
4

NAME

6       pbs_rlsjob - release a hold on a pbs batch job
7

SYNOPSIS

9       #include <pbs_error.h>
10       #include <pbs_ifl.h>
11
12       int pbs_rlsjob(int connect, char *job_id, char *hold_type, char *extend)
13

DESCRIPTION

15       Issue a batch request to release a hold from a job.
16
17       A  Release  Job  batch request is generated and sent to the server over
18       the connection specified by  connect  which  is  the  return  value  of
19       pbs_connect().
20
21       The  argument,  job_id, identifies the job from which the hold is to be
22       released, it is specified in the form: sequence_number.server
23
24       The parameter, hold_type, contains the type of  hold  to  be  released.
25       The possible values are defined in pbs_ifl.h as:
26
27              #define USER_HOLD "u"
28                     Available  to  the  owner of the job, the batch operator,
29                     and the batch administrator.
30
31              #define OTHER_HOLD "o"
32                     Available to the batch operator and the batch administra‐
33                     tor.
34
35              #define SYSTEM_HOLD "s"
36                     Available only to the batch administrator.
37
38       If  hold_type  is  either  a  null  pointer or points to a null string,
39       USER_HOLD will be released.
40
41       The parameter, extend, is reserved for  implementation  defined  exten‐
42       sions.
43

SEE ALSO

45       qrls(1B), qhold(1B), qalter(1B), pbs_alterjob(3B), pbs_connect(3B), and
46       pbs_holdjob(3B)
47

DIAGNOSTICS

49       When the batch request generated by pbs_rlsjob() function has been com‐
50       pleted  successfully  by  a  batch  server,  the  routine will return 0
51       (zero).  Otherwise, a non zero error is returned.  The error number  is
52       also set in pbs_errno.
53
54
55
56
57
58Local                                                           pbs_rlsjob(3B)
Impressum