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



NNAAMMEE
       qhold - hold back Grid Engine jobs from execution

SSYYNNTTAAXX
       qqhhoolldd [ --hh {uu|oo|ss},...  ] [ --hheellpp ] [ jjoobb//ttaasskk__iidd__lliisstt ]

       qqhhoolldd [ --hh {uu|oo|ss},...  ] [ --hheellpp ] --uu uusseerr__lliisstt

DDEESSCCRRIIPPTTIIOONN
       _Q_h_o_l_d  provides  a means for a user/operator/manager to place so called
       _h_o_l_d_s 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 _q_r_l_s(1) or the _q_a_l_t_e_r(1) command.

       There are three different types of holds:

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

       ooppeerraattoorr
              Operator holds can be assigned and removed by managers and oper-
              ators.

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

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

       An  alternate  way  to  assign holds to jobs is the _q_s_u_b(1) or the _q_a_l_-
       _t_e_r(1) command (see the _-_h option).

OOPPTTIIOONNSS
       --hh {uu|oo|ss},...
              Assign a u(ser), o(perator) or s(system) hold or  a  combination
              thereof to one or more jobs.

       --hheellpp  Prints a listing of all options.

       --uu uusseerrnnaammee,,......
              Changes  are  only  made  on  those jobs which were submitted by
              users specified in the list of usernames.  For  managers  it  is
              possible  to  use the qqhhoolldd --uu ""**"" command to set a hold for all
              jobs of all users.

              If you use the --uu switch it is be permitted to specify  a  addi-
              tional _j_o_b_/_t_a_s_k___i_d___l_i_s_t.

       jjoobb//ttaasskk__iidd__lliisstt
              Specified by the following form:

                  _j_o_b___i_d_[_._t_a_s_k___r_a_n_g_e_]_[_,_j_o_b___i_d_[_._t_a_s_k___r_a_n_g_e_]_,_._._._]

              If  present,  the  _t_a_s_k___r_a_n_g_e  restricts the effect of the _q_h_o_l_d
              operation to the array job task range specified as suffix to the
              job  id  (see  the  --tt  option to _q_s_u_b(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 _j_o_b_/_t_a_s_k___i_d___l_i_s_t it is possible to  use  the  keyword
              'all' to modify the hold state for all jobs of the current user.

EENNVVIIRROONNMMEENNTTAALL VVAARRIIAABBLLEESS
       SSGGEE__RROOOOTT       Specifies the location of the Grid Engine standard  con-
                      figuration files.

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


       SSGGEE__DDEEBBUUGG__LLEEVVEELL
                      If 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.

       SSGGEE__QQMMAASSTTEERR__PPOORRTT
                      If set, specifies the tcp port on  which  _s_g_e___q_m_a_s_t_e_r(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.

SSEEEE AALLSSOO
       _s_g_e___i_n_t_r_o(1), _q_a_l_t_e_r(1), _q_r_l_s(1), _q_s_u_b(1).

CCOOPPYYRRIIGGHHTT
       See _s_g_e___i_n_t_r_o(1) for a full statement of rights and permissions.



GE 6.0                   $Date: 2005/11/09 18:13:31 $                 QHOLD(1)
