1pbs_sigjob(3B)                        PBS                       pbs_sigjob(3B)
2
3
4

NAME

6       pbs_sigjob - send a signal to a pbs batch job
7

SYNOPSIS

9       #include <pbs_error.h>
10       #include <pbs_ifl.h>
11
12       int pbs_sigjob(int connect, char *job_id, char *signal, char *extend)
13
14       int pbs_sigjobasync(int connect, char *job_id, char *signal,
15       char *extend)
16

DESCRIPTION

18       Issue a batch request to send a signal to a batch job.
19
20       A Signal Job batch request is generated and sent to the server over the
21       connection specified by connect which is the return value  of  pbs_con‐
22       nect().   If  the  batch  job is in the running state, the batch server
23       will send the job the signal number corresponding to the  signal  named
24       in  signal.   When the asynchronous pbs_sigjobasync() call is used, the
25       server will reply before passing the signal request to the pbs_mom.
26
27       The argument, job_id, identifies which job is to  be  signaled,  it  is
28       specified in the form: sequence_number.server
29
30       If the name of the signal is not a recognized signal name on the execu‐
31       tion host, no signal is sent and an error is returned.  If the  job  is
32       not in the running state, no signal is sent and an error is returned.
33
34       The  parameter,  extend,  is reserved for implementation defined exten‐
35       sions.
36

SEE ALSO

38       qsig(1B) and pbs_connect(3B)
39

DIAGNOSTICS

41       When   the   batch   request   generated   by   the   pbs_sigjob()   or
42       pbs_sigjobasync()  function  has been completed successfully by a batch
43       server, the routine will return 0 (zero).  Otherwise, a non zero  error
44       is returned.  The error number is also set in pbs_errno.
45
46
47
48
49
50Local                                                           pbs_sigjob(3B)