pbs_sigjob(3B)

NAME
pbs_sigjob - send a signal to a pbs batch job

SYNOPSIS
#include <pbs_error.h>
#include <pbs_ifl.h>

int pbs_sigjob(int connect, char *job_id, char *signal, char *extend)

DESCRIPTION
Issue a batch request to send a signal to a batch job.

A Signal Job batch request is generated and sent to the server over the connection specified by which is the return value of pbs_connect(). If the batch job is in the running state, the batch server will send the job the signal number corresponding to the signal named in

The argument, identifies which job is to be signaled, it is specified in the form:

If the name of the signal is not a recognized signal name on the execution host, no signal is sent and an error is returned. If the job is not in the running state, no signal is sent and an error is returned.

The parameter, is reserved for implementation defined extensions.

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

DIAGNOSTICS
When the batch request generated by pbs_sigjob() 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.