| qsig - signal pbs batch job |
| qsig [-s signal] job_identifier ... |
| 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. |
| -s signal |
| Declares which signal is sent to the job. |
| The signal argument is either a signal name, e.g. SIGKILL, the signal name without 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 recognize the signal name, try issuing the signal number instead. |
| For Unicos on Cray systems only, two special 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. |
| The qsig command accepts one or more job_identifier operands of the form: sequence_number[.server_name][@server] |
| The qsig command will write a diagnostic messages to standard error for each error occurrence. |
| 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 command exits with a value greater than zero. |
| qsub(1B) , pbs_sigjob(3B) , pbs_resources_*(7B) where * is system type, and the PBS ERS. |