QHOLD(1)                   Grid Engine User Commands                  QHOLD(1)



[1mNAME[0m
       qhold - hold back Grid Engine jobs from execution

[1mSYNTAX[0m
       [1mqhold [22m[ [1m-h [22m{[1mu[22m|[1mo[22m|[1ms[22m},...  ] [ [1m-help [22m] [ [1mjob/task_id_list [22m]

       [1mqhold [22m[ [1m-h [22m{[1mu[22m|[1mo[22m|[1ms[22m},...  ] [ [1m-help [22m] [1m-u user_list[0m

[1mDESCRIPTION[0m
       [4mQhold[24m  provides  a means for a user/operator/manager to place so called
       [4mholds[24m 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 [4mqrls[24m(1) or the [4mqalter[24m(1) command.

       There are three different types of holds:

       [1muser   [22mUser holds can be assigned and removed  by  managers,  operators
              and the owner of the jobs.

       [1moperator[0m
              Operator holds can be assigned and removed by managers and oper-
              ators.

       [1msystem [22mSystem holds can be assigned and removed by managers only.

       If no hold type is specified with the [1m-h [22moption (see  below)  the  user
       hold is assumed by default.

       An  alternate  way  to  assign holds to jobs is the [4mqsub[24m(1) or the [4mqal-[0m
       [4mter[24m(1) command (see the [4m-h[24m option).

[1mOPTIONS[0m
       [1m-h [22m{[1mu[22m|[1mo[22m|[1ms[22m},...
              Assign a u(ser), o(perator) or s(system) hold or  a  combination
              thereof to one or more jobs.

       [1m-help  [22mPrints a listing of all options.

       [1m-u username,...[0m
              Changes  are  only  made  on  those jobs which were submitted by
              users specified in the list of usernames.  Managers are  allowed
              to  use  the  [1mqhold -u "*" [22mcommand to set a hold for all jobs of
              all users.

              If a user uses the [1m-u [22mswitch, the user may specify an additional
              [4mjob/task_id_list[24m.

       [1mjob/task_id_list[0m
              Specified by the following form:

                  [4mjob_id[.task_range][,job_id[.task_range],...][0m

              If  present,  the  [4mtask_range[24m  restricts the effect of the [4mqhold[0m
              operation to the array job task range specified as suffix to the
              job  id  (see  the  [1m-t  [22moption to [4mqsub[24m(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 [4mjob/task_id_list[24m it is possible to  use  the  keyword
              'all' to modify the hold state for all jobs of the current user.

[1mENVIRONMENTAL VARIABLES[0m
       [1mGE_ROOT        [22mSpecifies the location of the Grid Engine standard  con-
                      figuration files.

       [1mGE_CELL        [22mIf  set,  specifies  the  default  Grid  Engine cell. To
                      address a Grid Engine cell [4mqhold[24m uses (in the  order  of
                      precedence):

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

                             The name of the default cell, i.e. [1mdefault[22m.


       [1mGE_DEBUG_LEVEL [22mIf set, specifies that debug information should be writ-
                      ten  to stderr. In addition the level of detail in which
                      debug information is generated is defined.

       [1mGE_QMASTER_PORT[0m
                      If set, specifies the tcp port on which [4mge_qmaster[24m(8) is
                      expected  to  listen  for  communication requests.  Most
                      installations will use a services map entry for the ser-
                      vice "sge_qmaster" instead to define that port.

[1mSEE ALSO[0m
       [4mge_intro[24m(1), [4mqalter[24m(1), [4mqrls[24m(1), [4mqsub[24m(1).

[1mCOPYRIGHT[0m
       See [4mge_intro[24m(1) for a full statement of rights and permissions.



GE 6.2u2                 $Date: 2007/01/05 19:56:12 $                 QHOLD(1)
