qsig(1) - f37

1qsig(1B)                              PBS                             qsig(1B)
2
3
4

NAME

6       qsig - signal pbs batch job
7

SYNOPSIS

9       qsig [-s signal] job_identifier ...
10

DESCRIPTION

12       The  qsig  command  requests  that  a signal be sent to executing batch
13       jobs.  The signal is sent to the session leader of the job.
14
15       If the -s option is not specified, `SIGTERM' is sent.  The  request  to
16       signal a batch job will be rejected if:
17
18       -      The user is not authorized to signal the job.
19
20       -      The job is not in the running state.
21
22       -      The  requested  signal is not supported by the system upon which
23              the job is executing.
24
25       The qsig command sends a Signal Job batch request to the  server  which
26       owns the job.
27

OPTIONS

29       -s signal      Declares which signal is sent to the job.
30
31                      The  signal  argument  is  either  a  signal  name, e.g.
32                      SIGKILL, the signal name without the  SIG  prefix,  e.g.
33                      KILL,  or  a unsigned signal number, e.g. 9.  The signal
34                      name SIGNULL is allowed; the server will send the signal
35                      0  to  the job which will have no effect on the job, but
36                      will cause an obituary to be  sent  if  the  job  is  no
37                      longer  executing.   Not all signal names will be recog‐
38                      nized by qsig. If it doesn't recognize the signal  name,
39                      try issuing the signal number instead.
40
41                      Two  special  signal  names, "suspend" and "resume", are
42                      used to suspend and resume jobs.  Cray systems  use  the
43                      Cray-specific suspend()/resume() calls.
44
45                      On  non-Cray system, suspend causes a SIGTSTP to be sent
46                      to all processes in job's top task, wait 5 seconds,  and
47                      then send a SIGSTOP to all processes in all tasks on all
48                      nodes in the job.  This differs from TORQUE 2.0.0  which
49                      did  not have the ability to propogate signals to sister
50                      nodes.  Resume sends a SIGCONT to all processes  in  all
51                      tasks on all nodes.
52
53                      When   suspended,  a  job  continues  to  occupy  system
54                      resources but is not executing and is  not  charged  for
55                      walltime.   The  job  will  be  listed in the "S" state.
56                      Manager or operator privilege is required to suspend  or
57                      resume a job.
58
59                      Note  that  interactive  jobs  may  not  resume properly
60                      because the top-level shell  will  background  the  sus‐
61                      pended child process.
62

OPERANDS

64       The  qsig  command  accepts  one or more job_identifier operands of the
65       form: sequence_number[.server_name][@server]
66

STANDARD ERROR

68       The qsig command will write a diagnostic messages to standard error for
69       each error occurrence.
70

EXIT STATUS

72       Upon  successful  processing  of all the operands presented to the qsig
73       command, the exit status will be a value of zero.
74
75       If the qsig command fails to process any  operand,  the  command  exits
76       with a value greater than zero.
77