QRLS(1)                    Grid Engine User Commands                   QRLS(1)



NNAAMMEE
       qrls - release Grid Engine jobs from previous hold states

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

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

DDEESSCCRRIIPPTTIIOONN
       _q_r_l_s provides a means for a user/operator/manager to release _h_o_l_d_s from
       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 schedul-
       ing.

       Holds can be assigned to jobs with the _q_h_o_l_d(1), _q_s_u_b(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 release holds is the _q_a_l_t_e_r(1) command (see the  _-_h
       option).

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

       --hheellpp  Prints a listing of all options.

       --uu uusseerrnnaammee,,......
              Modifies the hold state of those jobs which  were  submitted  by
              users  specified in the list of usernames.  Managers are allowed
              to use the qqrrllss --uu ""**"" command to modify the hold state for jobs
              of all users.

              If a user uses the --uu switch, the user may specify an additional
              _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 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 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_r_l_s 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_h_o_l_d(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.1                   $Date: 2007/06/26 22:21:08 $                  QRLS(1)
