NAME

       condor_vacate_job - HTCondor Manual

       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_job  finds  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 running job running 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 -fast option is used, the job(s) will be immediately killed.

       If the -name option is specified, the named condor_schedd is targeted for processing. If the -addr option
       is  used,  the  condor_schedd  at  the  given  address  is targeted for processing.  Otherwise, the local
       condor_schedd is 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_job on 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_job with condor_vacate.  condor_vacate is 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_vacate to evict jobs from a given host. condor_vacate_job is 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 vanilla universe jobs owned by Mary:

          $ condor_vacate_job -constraint 'JobUniverse == 5 && 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_job will exit with a status value of 0 (zero) upon success, and it will exit with the value
       1 (one) upon failure.

AUTHOR

       HTCondor Team

COPYRIGHT

       1990-2024,  Center  for High Throughput Computing, Computer Sciences Department, University of Wisconsin-
       Madison, Madison, WI, US. Licensed under the Apache License, Version 2.0.

                                                  Aug 25, 2024                              CONDOR_VACATE_JOB(1)