Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
pbs_rescreserve(3B)		      PBS		   pbs_rescreserve(3B)

NAME
       pbs_rescreserve,	pbs_rescrelease	- reserve/free batch resources

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

       int pbs_rescreserve(int connect,	char **resourcelist, int arraysize,
       resource_t *resource_id)

       int pbs_rescrelease(int connect,	resource_t resource_id)

DESCRIPTION
       pbs_rescreserver
	 Issue	a  request to the batch	server to reserve specified resources.
	 connect is the	connection returned by pbs_connect().  resourcelist is
	 an  array  of	one  or	 more  strings	specifying the resources to be
	 queried.  arraysize is	the is the number of strings in	 resourcelist.
	 resource_id is	a pointer to a resource	handle.	 The pointer cannot be
	 null.	If the present value of	the resource handle is RESOURCE_T_NULL
	 , this	request	is for a new reservation and if	successful, a resource
	 handle	will be	returned in resource_id.

	 If the	value of resource_id as	supplied by  the  caller  is  not  RE-
	 SOURCE_T_NULL , this is a existing (partial) reservation.   Resources
	 currently reserved for	this handle will  be  released	and  the  full
	 reservation will be attempted again.  If the caller wishes to release
	 the resources allocated to a partial reservation, the	caller	should
	 pass the resource handle to pbs_rescrelease().

	 At  the  present  time	 the only resources which may be specified are
	 "nodes".  It should be	specified as nodes=specification where	speci-
	 fication is what a user specifies in the -l option arguement list for
	 nodes,	see qsub (1B).

       pbs_rescrelease
	 The pbs_rescrelease() call releases or	frees resources	reserved  with
	 the  resource handle of resource_id returned from a prior pbs_rescre-
	 serve() call.	connect	is the connection returned by pbs_connect().

       Both functions require that the issuing user have operator or  adminis-
       trator privilege.

SEE ALSO
       qsub(1B),  pbs_connect(3B),  pbs_disconnect(3B),	 pbs_rescquery(3B) and
       pbs_resources(7B)

DIAGNOSTICS
       pbs_rescreserve() and pbs_rescrelease() return zero on success.	Other-
       wise,  a	 non  zero error is returned.  The error number	is also	set in
       pbs_errno.

       PBSE_RMPART
	      is a special case	indicating that	some but not all  of  the  re-
	      quested  resources  could	be reserved; a partial reservation was
	      made.  The reservation request should either be rerequested with
	      the returned handle or the partial resources released.

       PBSE_RMBADPARAM
	      a	 parameter is incorrect, such as a null	for the	pointer	to the
	      resource_id.

       PBSE_RMNOPARAM
	      a	parameter is missing, such as a	null resoruce list.

Local							   pbs_rescreserve(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_rescreserve&sektion=3b&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help