# pbs_sigjob

NAME
SYNOPSIS
DESCRIPTION
SEE ALSO
DIAGNOSTICS

## 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 connect 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 signal.

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

| 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, extend, 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.