xenial (1) condor_hold.1.gz

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

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

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

       Center for High Throughput Computing, University of Wisconsin-Madison

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