pbs_deljob (3) - Linux Manuals
pbs_deljob: delete a pbs batch job
pbs_deljob - delete a pbs batch job
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:
is overloaded to serve two purposes.
If the pointer
points to a string of the form:
it is used to provide control over the delay between sending SIGTERM and SIGKILL signals to a running job. The characters nnnn specify a unsigned decimal integer time delay in seconds. If is the null pointer or points to a null string, the administrator established default time delay is used.
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.