NAME
	  pbs_statserver - obtain status of a batch server

     SYNOPSIS
	  #include <pbs_error.h>
	  #include <pbs_ifl.h>

	  struct batch_status *pbs_statserver
	  (int/ connect, struct/ attrl/ *attrib,
	  char/	*extend)

     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 defined 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_submit(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 extensions.

	  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) 

     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 returned and	the
	  error	code is	set in pbs_errno.