vovstop

vovstop: Usage Message
  
  DESCRIPTION:
     Stop a list of objects.  The jobs are normally descheduled,
     but if the -f (-force) option is used, then also running jobs
     are stopped.
  
  USAGE:
     % vovstop [options]
     % vovstop [options] objectId ...
     % vovstop [options] setName ...
  
  OPTIONS:
      Most options can be abbreviated to one character.
  
     -help               -- Print this message.
     -q                  -- Quiet.
     -s                  -- Quiet (same as -q).
     -silent             -- Quiet (same as -q).
     -v                  -- Increase verbosity.
     -f                  -- Stop running jobs also, same as -force
     -force              -- Stop running jobs also, same as -f
     -running            -- Stop running jobs ONLY, do not dequeue jobs
     -dir      <dirname> -- Stop jobs in a directory.
     -subdirs  <dirname> -- Stop jobs in a directory and all subdirs.
     -downcone           -- Stop also all jobs in the downcone
                            of the specified nodes.
  
     -retraces           -- Stop all current retrace requests.
     -alljobs            -- Stop all jobs.
     -project            -- Stop current project.
     -signals <SIGLIST>  -- Comma separated list of signals to send to the jobs
                            (default sequence is TERM,HUP,INT,KILL )
                            This can be also set with property NC_STOP_SIGNALS
                            or with the environment variables NC_STOP_SIGNALS
                            or VOV_STOP_SIGNALS.
                            Priority: 1. Option -signal
                                      2. job property NC_STOP_SIGNALS,
                                         STOP_SIGNALS
                                      3. env variable VOV_STOP_SIGNALS,
                                         NC_STOP_SIGNALS
                                      4. default (can be configured as
                                         defaultStopSignalCascade in policy.tcl)
                            See also:  vovshow -env VOV_STOP_SIGNALS
                                       vovshow -env NC_STOP_SIGNALS
     -sig     <SIGLIST>  -- Same as -signals.
     -exclude <PROCLIST> -- List of processes to exclude from receiving the
                            signal.
     -include <PROCLIST> -- List of processes to receive the signal.
     -delay   <s>        -- Minimum delay between signals (in seconds),
                            between 0 and 20s. Default is 3.
                            This can also be set with the property
                            NC_STOP_SIG_DELAY, or with the environment
                            variables NC_STOP_SIG_DELAY or
                            VOV_STOP_SIGNAL_DELAY. If both NC_STOP_SIG_DELAY
                            and VOV_STOP_SIGNAL_DELAY are present in the
                            environment, the value of NC_STOP_SIG_DELAY will
                            be used.
                            Priority: 1. Option -delay
                                      2. job property NC_STOP_SIG_DELAY
                                      3. env variable VOV_STOP_SIGNAL_DELAY,
                                         NC_STOP_SIG_DELAY
                                      4. default
      -why    <REASON>   -- The reason why vovstop is being called. This gets
                            passed to the WHYSTATUS field and property if it
                            causes a status change.
  The 'objectId' argument can refer to a: job, user, retrace, set,
                                          bucket, or file
  
  EXAMPLES:
     % vovstop System:jobs           -- Stop jobs in specified set.
     % vovstop 00023456              -- Stop job by id.
                                        The id refers to a job, set, retrace,
                                        file, bucket, or user.
     % vovstop -dir .                -- Stop jobs in current dir.
     % vovstop -subdirs .            -- Stop jobs in current dir
                                        and all subdirs.
     % vovstop -alljobs
     % vovstop -f -alljobs           -- Stop and kill all jobs
     % vovstop -f -signal HUP,TERM   -- Send SIGHUP and SIGTERM to all jobs
     % vovstop -f -include sleep     -- Stop all "sleep" jobs
     % vovstop -f -exclude sleep,ls  -- Stop all jobs EXCEPT "sleep" and
                                        "ls" jobs
     % vovstop -retraces -why "The reason why all retraces were stopped"