NAME
     qhold - hold back Grid Engine jobs from execution

SYNTAX
     qhold [ -h {u|o|s},...  ] [ -help ] [ job/task_id_list ]

     qhold [ -h {u|o|s},...  ] [ -help ] -u user_list | -uall

DESCRIPTION
     Qhold provides a means for a user/operator/manager to  place
     so  called holds on one or more jobs pending to be scheduled
     for execution.  As long as any type of hold is assigned to a
     job, the job is not eligible for scheduling.

     Holds can be removed with the qrls(1) or the qalter(1)  com-
     mand.

     There are three different types of holds:

     user User holds can be assigned  and  removed  by  managers,
          operators and the owner of the jobs.

     operator
          Operator holds can be assigned and removed by  managers
          and operators.

     system
          System holds can be assigned and  removed  by  managers
          only.

     If no hold type is specified with the -h option (see  below)
     the user hold is assumed by default.

     An alternate way to assign holds to jobs is the  qsub(1)  or
     the qalter(1) command (see the -h option).

OPTIONS
     -h {u|o|s},...
          Assign a u(ser), o(perator) or s(system) hold or a com-
          bination thereof to one or more jobs.

     -help
          Prints a listing of all options.

     -u username,... | -uall
          Changes are only made on those jobs which were  submit-
          ted  by  users specified in the list of usernames.  For
          managers it is possible to use the qhold -uall  command
          to set a hold for all jobs of all users.

          If you use the -u or -uall switch it is be permitted to
          specify a additional job/task_id_list.

     job/task_id_list
          Specified by the following form:

              job_id[.task_range][,job_id[.task_range],...]

          If present, the task_range restricts the effect of  the
          qhold  operation  to the job array task range specified
          as suffix to the job id (see the -t option  to  qsub(1)
          for further details on job arrays).

          The task range specifier has the  form  n[-m[:s]].  The
          range  may  be a single number, a  simple range  of the
          form n-m or a range with a step size.

          Instead of job/task_id_list it is possible to  use  the
          keyword  'all' to modify the hold state for all jobs of
          the current user.

ENVIRONMENTAL VARIABLES
     SGE_ROOT       Specifies the location  of  the  Grid  Engine
                    standard configuration files.

     SGE_CELL       If set, specifies  the  default  Grid  Engine
                    cell.  To  address  a  Grid Engine cell qhold
                    uses (in the order of precedence):

                         The name of the cell  specified  in  the
                         environment  variable SGE_CELL, if it is
                         set.

                         The  name  of  the  default  cell,  i.e.
                         default.


     SGE_DEBUG_LEVEL
                    If  set,  specifies  that  debug  information
                    should  be written to stderr. In addition the
                    level of detail in which debug information is
                    generated is defined.

     COMMD_PORT     If set,  specifies  the  tcp  port  on  which
                    sge_commd(8)  is  expected to listen for com-
                    munication requests.  Most installations will
                    use  a  services  map entry instead to define
                    that port.

     COMMD_HOST     If set, specifies the host on which the  par-
                    ticular  sge_commd(8)  to  be  used  for Grid
                    Engine  communication  of  the  qhold  client
                    resides.  Per default the local host is used.


SEE ALSO
     sge_intro(1), qalter(1), qrls(1), qsub(1).

COPYRIGHT
     See sge_intro(1) for a full statement of rights and  permis-
     sions.















































Man(1) output converted with man2html