    NAME
         qhold - hold back Sun 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

    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,...
              Changes are only made on those jobs which were  submit-
              ted  by  users  specified  in  the  list  of usernames.
              Managers are allowed to use the qhold -u "*" command to
              set a hold for all jobs of all users.

              If a user uses the -u switch, the user may  specify  an
              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 array job task range specified
              as suffix to the job id (see the -t option  to  qsub(1)
              for further details on array jobs).

              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 Sun Grid Engine
                        standard configuration files.

         SGE_CELL       If set, specifies the default Sun Grid Engine
                        cell. To address a Sun 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.

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

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

    COPYRIGHT
         See  sge_intro(1)  for  a  full  statement  of  rights   and
         permissions.