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

FreeBSD Manual Pages

  
 
  

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

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)

DESCRIPTION
       Issue  a	batch request to delete	a batch	job.  If the batch job is run-
       ning, 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 connect which is	the return value  of  pbs_con-
       nect().

       The  argument,  job_id,	identifies  which  job is to be	deleted, it is
       specified in the	form: sequence_number.server

       The argument, extend, is	overloaded to  serve  two  purposes.   If  the
       pointer extend points to	a string of the	form:
       deldelay=nnnn,
       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 extend is the null
       pointer or points to a null string, the administrator  established  de-
       fault time delay	is used.

       If  extend 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	 mail-
       ing occurs if the job is	deleted	by a user other	than the job owner.

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

DIAGNOSTICS
       When  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.

Local								pbs_deljob(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_deljob&sektion=3b&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help