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

NAME

6       pbs_rescreserve, pbs_rescrelease - reserve/free batch resources
7

SYNOPSIS

9       #include <pbs_error.h>
10       #include <pbs_ifl.h>
11
12       int pbs_rescreserve(int connect, char **resourcelist, int arraysize,
13       resource_t *resource_id)
14
15       int pbs_rescrelease(int connect, resource_t resource_id)
16

DESCRIPTION

18       pbs_rescreserver
19         Issue  a  request to the batch server to reserve specified resources.
20         connect is the connection returned by pbs_connect().  resourcelist is
21         an  array  of  one  or  more  strings  specifying the resources to be
22         queried.  arraysize is the is the number of strings in  resourcelist.
23         resource_id is a pointer to a resource handle.  The pointer cannot be
24         null.  If the present value of the resource handle is RESOURCE_T_NULL
25         , this request is for a new reservation and if successful, a resource
26         handle will be returned in resource_id.
27
28         If the value  of  resource_id  as  supplied  by  the  caller  is  not
29         RESOURCE_T_NULL   ,   this   is  a  existing  (partial)  reservation.
30         Resources currently reserved for this handle will be released and the
31         full  reservation  will  be attempted again.  If the caller wishes to
32         release the resources allocated to a partial reservation, the  caller
33         should pass the resource handle to pbs_rescrelease().
34
35         At  the  present  time  the only resources which may be specified are
36         "nodes".  It should be specified as nodes=specification where  speci‐
37         fication is what a user specifies in the -l option arguement list for
38         nodes, see qsub (1B).
39
40       pbs_rescrelease
41         The pbs_rescrelease() call releases or frees resources reserved  with
42         the  resource handle of resource_id returned from a prior pbs_rescre‐
43         serve() call.  connect is the connection returned by pbs_connect().
44
45       Both functions require that the issuing user have operator or  adminis‐
46       trator privilege.
47

SEE ALSO

49       qsub(1B),  pbs_connect(3B),  pbs_disconnect(3B),  pbs_rescquery(3B) and
50       pbs_resources(7B)
51

DIAGNOSTICS

53       pbs_rescreserve() and pbs_rescrelease() return zero on success.  Other‐
54       wise,  a  non  zero error is returned.  The error number is also set in
55       pbs_errno.
56
57       PBSE_RMPART
58              is a special case indicating  that  some  but  not  all  of  the
59              requested resources could be reserved; a partial reservation was
60              made.  The reservation request should either be rerequested with
61              the returned handle or the partial resources released.
62
63       PBSE_RMBADPARAM
64              a  parameter is incorrect, such as a null for the pointer to the
65              resource_id.
66
67       PBSE_RMNOPARAM
68              a parameter is missing, such as a null resoruce list.
69
70Local                                                      pbs_rescreserve(3B)
Impressum