condor_vacate_job(1)					      General Commands Manual					      condor_vacate_job(1)

Name
       condor_vacate_job vacate - jobs in the Condor 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 Condor 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. Condor 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 Condor will restart the job from the begin-
       ning 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. con-
       dor_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
       Condor Team, University of Wisconsin-Madison

Copyright
       Copyright  (C)  1990-2012  Condor  Team,  Computer  Sciences Department, University of Wisconsin-Madison, Madison, WI. All Rights Reserved.
       Licensed under the Apache License, Version 2.0.

       See the Condor Version 7.8.2 Manualor http://www.condorproject.org/licensefor additional notices. condor-admin@cs.wisc.edu

								  September 2012					      condor_vacate_job(1)