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 HTCondor 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_USERSmacro) 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  HoldReasonto  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 HoldReasonSubCodeto 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

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_hold command.

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

       Center for High Throughput Computing, University of Wisconsin–Madison

Copyright

       Copyright  © 1990-2016 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.

                                           January 2020                            condor_hold(1)