text: pbs_deljob (3) - Linux Man Pages
  pbs_deljob: delete a pbs batch job
  NAME
  pbs_deljob - delete a pbs batch job
  SYNOPSIS#include <pbs_error.h>
  #include <pbs_ifl.h>
  int pbs_deljob(int connect, char
  *job_id, char *extend)
  DESCRIPTIONIssue a batch request to delete a batch job. If the batch job is running, the execution server will send the SIGTERM signal followed by SIGKILL .
  A Delete Job batch request is generated and sent to the server over the connection specified by which is the return value of pbs_connect().
  The argument, identifies which job is to be deleted, it is specified in the form:
  The argument,
  is overloaded to serve two purposes.
  If the pointer is the null pointer or points to a null string, the administrator established default time delay is used.
  If points to a string other than the above, it is taken as text to be appended to the message mailed to to the job owner. This mailing occurs if the job is deleted by a user other than the job owner.
  DIAGNOSTICSWhen the batch request generated by the pbs_deljob() 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.