FreeBSD Manual Pages
pbs_manager(3B) PBS pbs_manager(3B) NAME pbs_manager - administrator a pbs batch object SYNOPSIS #include <pbs_error.h> #include <pbs_ifl.h> int pbs_manager(int connect, int command, int obj_type, char *obj_name, struct attropl *attrib, char *extend) DESCRIPTION Issue a batch request to perform administration functions at a server. With this request server objects such as queues can be created and deleted, and have their attributes set and unset. A Manage batch request is generated and sent to the server over the connection specified by connect which is the return value of pbs_con- nect(). This request requires full batch administrator privilege. The parameter, command, specifies the operation to be performed, see pbs_ifl.h: #define MGR_CMD_CREATE 0 #define MGR_CMD_DELETE 1 #define MGR_CMD_SET 2 #define MGR_CMD_UNSET 3 The parameter, obj_type, declares the type of object upon which the command operates, see pbs_ifl.h: #define MGR_OBJ_SERVER 0 #define MGR_OBJ_QUEUE 1 The parameter, obj_name, is the name of the specific object. The parameter, attrib, is a pointer to an attropl structure which are defined in pbs_ifl.h as: struct attropl { char *name; char *resource; char *value; enum batch_op op; struct attropl *next; }; The attrib list is terminated by the first entry where next is a null pointer. The name member points to a string which is the name of the attribute. If the attribute is one which contains a set of resources, the specific resource is specified in the structure member resource. Otherwise, the member resource is pointer to a null string. The value member points to a string which is the new value of the at- tribute. The op member defines the manner in which the new value is assigned to the attribute. The operators are: enum batch_op { ..., SET, UNSET, INCR, DECR }; The parameter extend is reserved for implementation defined extensions. Functions MGR_CMD_CREATE and MGR_CMD_DELETE require PBS Manager privi- lege. Functions MGR_CMD_SET and MGR_CMD_UNSET require PBS Manager or Operator privilege. SEE ALSO qmgr(1B) and pbs_connect(3B) DIAGNOSTICS When the batch request generated by pbs_manager() 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. Local pbs_manager(3B)
NAME | SYNOPSIS | DESCRIPTION | SEE ALSO | DIAGNOSTICS
Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=pbs_manager&sektion=3b&manpath=FreeBSD+12.0-RELEASE+and+Ports>