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

DESCRIPTION

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

SEE ALSO

34       qsig(1B) and pbs_connect(3B)
35

DIAGNOSTICS

37       When the batch request generated by pbs_sigjob() function has been com‐
38       pleted successfully by a  batch  server,  the  routine  will  return  0
39       (zero).   Otherwise, a non zero error is returned.  The error number is
40       also set in pbs_errno.
41
42
43
44
45
46Local                                                           pbs_sigjob(3B)