qsig(1B) PBS qsig(1B)
NAME
qsig - signal pbs batch job
SYNOPSIS
qsig [-s signal] job_identifier ...
DESCRIPTION
The qsig command requests that a signal be sent to executing
batch jobs. The signal is sent to the session leader of the job.
If the -s option is not specified, `SIGTERM' is sent. The
request to signal a batch job will be rejected if:
- The user is not authorized to signal the job.
- The job is not in the running state.
- The requested signal is not supported by the system
upon which the job is executing.
The qsig command sends a Signal Job batch request to the
server which owns the job.
OPTIONS
-s signal Declares which signal is sent to the job.
The signal argument is either a signal
name, e.g. SIGKILL, the signal name with�
out the SIG prefix, e.g. KILL, or a
unsigned signal number, e.g. 9. The signal
name SIGNULL is allowed; the server will
send the signal 0 to the job which will
have no effect. Not all signal names will
be recognized by qsig. If it doesn't recog�
nize the signal name, try issuing the sig�
nal number instead.
For Unicos on Cray systems only, two spe�
cial signal names, "suspend" and "resume",
are used to suspend and resume jobs. When
suspended, a job continues to occupy system
resources but is not executing and is not
charged for walltime. Manager or operator
privilege is required to suspend or resume
a job.
OPERANDS
The qsig command accepts one or more job_identifier
operands of the form: sequence_num�
ber[.server_name][@server]
STANDARD ERROR
The qsig command will write a diagnostic messages to stan�
dard error for each error occurrence.
EXIT STATUS
Upon successful processing of all the operands presented
to the qsig command, the exit status will be a value of
zero.
If the qsig command fails to process any operand, the com�
mand exits with a value greater than zero.
SEE ALSO
qsub(1B), pbs_sigjob(3B), pbs_resources_*(7B) where * is
system type, and the PBS ERS.
Local qsig(1B)