FreeBSD Manual Pages
pbs_statserver(3B) PBS pbs_statserver(3B) NAME pbs_statserver - obtain status of a pbs batch server SYNOPSIS #include <pbs_error.h> #include <pbs_ifl.h> struct batch_status *pbs_statserver(int/ connect, struct/ attrl/ *attrib, char/ *extend) void pbs_statfree(struct batch_status *psj) DESCRIPTION Issue a batch request to obtain the status of a batch server. A Status Server batch request is generated and sent to the server over the connection specified by connect which is the return value of pbs_connect(). The parameter, attrib, is a pointer to an attrl structure which is de- fined in pbs_ifl.h as: struct attrl { struct attrl *next; char *name; char *resource; char *value; }; The attrib list is terminated by the first entry where next is a null pointer. If attrib is given, then only the attributes in the list are returned by the server. Otherwise, all the attributes of the server are returned. When an attrib list is specified, the name member is a pointer to a attribute name as listed in pbs_alter(3) and pbs_sub- mit(3). The resource member is only used if the name member is ATTR_l, otherwise it should be a pointer to a null string. The value member should aways be a pointer to a null string. The parameter, extend, is reserved for implementation defined exten- sions. The return value is a pointer to a list of batch_status structures, which is defined in pbs_ifl.h as: struct batch_status { struct batch_status *next; char *name; struct attrl *attribs; char *text; } It is up the user to free the space when no longer needed, by calling pbs_statfree(). SEE ALSO qstat(1B) and pbs_connect(3B) DIAGNOSTICS When the batch request generated by pbs_statserver() function has been completed successfully by a batch server, the routine will return a pointer to a batch_status structure. Otherwise, a null pointer is re- turned and the error code is set in pbs_errno. Local pbs_statserver(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_statserver&sektion=3b&manpath=FreeBSD+12.0-RELEASE+and+Ports>