condor_hold(1)						      General Commands Manual						    condor_hold(1)

Name
       condor_hold put - jobs in the queue into the hold state

Synopsis
       condor_hold [-help -version]

       condor_hold[-debug]   [-reason	reasonstring]	[-subcode   number]   [-pool   centralmanagerhostname[:portnumber]-name  scheddname][-addr
       "<a.b.c.d:port>"] cluster... cluster.process... user... -constraint expression...

       condor_hold[-debug]  [-reason   reasonstring]   [-subcode   number]   [-pool   centralmanagerhostname[:portnumber]-name	 scheddname][-addr
       "<a.b.c.d:port>"] -all

Description
       condor_holdplaces jobs from the Condor job queue in the hold state. If the -nameoption is specified, the named condor_scheddis targeted for
       processing. Otherwise, the local condor_scheddis targeted. The jobs to be held 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 place the
       job on hold.

       A job in the hold state remains in the job queue, but the job will not run until released with condor_release.

       A currently running job that is placed in the hold state by condor_holdis sent a hard kill signal. For a standard universe job, this  means
       that the job is removed from the machine without allowing a checkpoint to be produced first.

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>"

       -debug

	  Causes debugging information to be sent to  stderr , based on the value of the configuration variable  TOOL_DEBUG

       -reason reasonstring

	  Sets	the  job  ClassAd attribute  HoldReason to the value given by reasonstring. reasonstringwill be delimited by double quote marks on
	  the command line, if it contains space characters.

       -subcode number

	  Sets the job ClassAd attribute  HoldReasonSubCode to the integer value given by number.

       cluster

	  Hold all jobs in the specified cluster

       cluster.process

	  Hold the specific job in the cluster

       user

	  Hold all jobs belonging to specified user

       -constraint expression

	  Hold all jobs which match the job ClassAd expression constraint (within quotation marks). Note that quotation marks must be escaped with
	  the backslash characters for most shells.

       -all

	  Hold all the jobs in the queue

See Also
       condor_release(on page )

Examples
       To place on hold all jobs (of the user that issued the condor_hold command) that are not currently running:

       % condor_hold  -constraint "JobStatus!=2"

       Multiple  options  within  the  same command cause the union of all jobs that meet either (or both) of the options to be placed in the hold
       state. Therefore, the command

       % condor_hold  Mary -constraint "JobStatus!=2"

       places all of Mary's queued jobs into the hold state, and the constraint holds all queued jobs not currently running. It also sends a  hard
       kill  signal  to any of Mary's jobs that are currently running. Note that the jobs specified by the constraint will also be Mary's jobs, if
       it is Mary that issues this example condor_holdcommand.

Exit Status
       condor_holdwill 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_hold(1)