Provided by: htcondor_8.4.2~dfsg.1-1build1_amd64 bug

Name

       condor_vacate_job  vacate  -  jobs  in  the  HTCondor  queue from the hosts where they are
       running

Synopsis

       condor_vacate_job [-help -version]

       condor_vacate_job[-pool     centralmanagerhostname[:portnumber]-name     scheddname][-addr
       "<a.b.c.d:port>"] [-fast] cluster... cluster.process... user... -constraint expression...

       condor_vacate_job[-pool     centralmanagerhostname[:portnumber]-name     scheddname][-addr
       "<a.b.c.d:port>"] [-fast] -all

Description

       condor_vacate_jobfinds one or more jobs from the HTCondor job queue and vacates them  from
       the  host(s) where they are currently running. The jobs remain in the job queue and return
       to the idle state.

       A job running under the standard universe will first produce a checkpoint and then the job
       will be killed. HTCondor will then restart the job somewhere else, using the checkpoint to
       continue from where it left off. A job running under any other universe  will  be  sent  a
       soft  kill  signal  (SIGTERM by default, or whatever is defined as the  SoftKillSig in the
       job ClassAd), and HTCondor will restart the job from the beginning somewhere else.

       If the -fastoption is used, the job(s) will be immediately killed, meaning  that  standard
       universe  jobs  will  not be allowed to checkpoint, and the job will have to revert to the
       last checkpoint or start over from the beginning.

       If the -nameoption is specified, the named condor_scheddis targeted for processing. If the
       -addroption  is  used,  the  condor_scheddat the given address is targeted for processing.
       Otherwise, the local condor_scheddis targeted. The jobs to be vacated  are  identified  by
       one  or more job identifiers, as described below. For any given job, only the owner of the
       job or one of the queue super users (defined by the  QUEUE_SUPER_USERS macro)  can  vacate
       the job.

       Using condor_vacate_jobon jobs which are not currently running has no effect.

Options

       -help

          Display usage information

       -version

          Display version information

       -pool centralmanagerhostname[:portnumber]

          Specify a pool by giving the central manager's host name and an optional port number

       -name scheddname

          Send the command to a machine identified by scheddname

       -addr <a.b.c.d:port>

          Send the command to a machine located at "<a.b.c.d:port>"

       cluster

          Vacate all jobs in the specified cluster

       cluster.process

          Vacate the specific job in the cluster

       user

          Vacate jobs belonging to specified user

       -constraint expression

          Vacate all jobs which match the job ClassAd expression constraint

       -all

          Vacate all the jobs in the queue

       -fast

          Perform a fast vacate and hard kill the jobs

General Remarks

       Do  not confuse condor_vacate_jobwith condor_vacate. condor_vacateis given a list of hosts
       to vacate, regardless of what jobs happen to be running on them. Only machine  owners  and
       administrators  have  permission  to  use  condor_vacateto  evict  jobs from a given host.
       condor_vacate_jobis given a list of job to vacate, regardless of which hosts  they  happen
       to  be  running on. Only the owner of the jobs or queue super users have permission to use
       condor_vacate_job.

Examples

       To vacate job 23.0:

       % condor_vacate_job  23.0

       To vacate all jobs of a user named Mary:

       % condor_vacate_job  mary

       To vacate all standard universe jobs owned by Mary:

       % condor_vacate_job  -constraint 'JobUniverse == 1 && Owner == "mary"'

       Note that the entire constraint, including the quotation marks, must be enclosed in single
       quote marks for most shells.

Exit Status

       condor_vacate_jobwill  exit with a status value of 0 (zero) upon success, and it will exit
       with the value 1 (one) upon failure.

Author

       Center for High Throughput Computing, University of Wisconsin-Madison

Copyright

       Copyright  (C)  1990-2015  Center  for  High  Throughput  Computing,   Computer   Sciences
       Department,  University  of  Wisconsin-Madison, Madison, WI. All Rights Reserved. Licensed
       under the Apache License, Version 2.0.

                                          February 2016                      condor_vacate_job(1)