pbs_delresv(3B)

NAME
pbs_delresv - delete a reservation

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

int pbs_delresv(int connect, char *resv_id, char *extend)

DESCRIPTION
Issue a batch request to delete a reservation. If the reservation is in state RESV_RUNNING, and there are jobs remaining in the reservation queue, the jobs will be deleted before the reservation is deleted.

A Delete Reservation batch request is generated and sent to the server over the connection specified by connect which is the return value of pbs_connect().

The argument, resv_id , identifies which reservation is to be deleted, it is specified in the form:
    R<sequence_number>.<server>

The argument, extend is currently unused.

SEE ALSO
pbs_rdel(1B) and pbs_connect(3B)

DIAGNOSTICS
When the batch request generated by the pbs_delresv() 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.