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

NAME

6       pbs_manager - administrator a pbs batch object
7

SYNOPSIS

9       #include <pbs_error.h>
10       #include <pbs_ifl.h>
11
12       int pbs_manager(int connect, int command, int obj_type, char *obj_name,
13       struct attropl *attrib, char *extend)
14

DESCRIPTION

16       Issue  a batch request to perform administration functions at a server.
17       With this request server objects such as  queues  can  be  created  and
18       deleted, and have their attributes set and unset.
19
20       A  Manage  batch  request  is generated and sent to the server over the
21       connection specified by connect which is the return value  of  pbs_con‐
22       nect().  This request requires full batch administrator privilege.
23
24       The  parameter,  command,  specifies the operation to be performed, see
25       pbs_ifl.h:
26           #define MGR_CMD_CREATE 0
27           #define MGR_CMD_DELETE 1
28           #define MGR_CMD_SET    2
29           #define MGR_CMD_UNSET  3
30
31       The parameter, obj_type, declares the type of  object  upon  which  the
32       command operates, see pbs_ifl.h:
33           #define MGR_OBJ_SERVER  0
34           #define MGR_OBJ_QUEUE   1
35
36       The parameter, obj_name, is the name of the specific object.
37
38       The  parameter,  attrib, is a pointer to an attropl structure which are
39       defined in pbs_ifl.h as:
40
41           struct attropl {
42               char   *name;
43               char   *resource;
44               char   *value;
45               enum batch_op op;
46               struct attropl *next;
47           };
48
49       The attrib list is terminated by the first entry where next is  a  null
50       pointer.
51
52       The name member points to a string which is the name of the attribute.
53
54       If the attribute is one which contains a set of resources, the specific
55       resource is specified in the structure member resource.  Otherwise, the
56       member resource is pointer to a null string.
57
58       The  value  member  points  to  a  string which is the new value of the
59       attribute.
60
61       The op member defines the manner in which the new value is assigned  to
62       the  attribute.   The  operators  are: enum batch_op { ..., SET, UNSET,
63       INCR, DECR };
64
65       The parameter extend is reserved for implementation defined extensions.
66
67       Functions MGR_CMD_CREATE and MGR_CMD_DELETE require PBS Manager  privi‐
68       lege.   Functions  MGR_CMD_SET and MGR_CMD_UNSET require PBS Manager or
69       Operator privilege.
70

SEE ALSO

72       qmgr(1B) and pbs_connect(3B)
73

DIAGNOSTICS

75       When the batch request generated by  pbs_manager()  function  has  been
76       completed  successfully  by  a  batch server, the routine will return 0
77       (zero).  Otherwise, a non zero error is returned.  The error number  is
78       also set in pbs_errno.
79
80
81
82
83Local                                                          pbs_manager(3B)
Impressum