Man Linux: Main Page and Category List


       qrls - release Sun Grid Engine jobs from previous hold states


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

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


       Qrls  provides a means for a user/operator/manager to release so called
       holds 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 scheduling.

       Holds can be assigned  to  jobs  with  the  qhold(1),  qsub(1)  or  the
       qalter(1) command.

       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 holds can be  assigned  and  removed  by  managers  and

       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 release holds is the qalter(1) command (see the  -h


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

       -help  Prints a listing of all options.

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

              If a user uses the -u switch, the user may specify an additional

              Specified by the following form:


              If present, the task_range restricts the effect of the 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

              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 all jobs of the current user.


       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 qrls 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.

                      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.

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


       sge_intro(1), qalter(1), qhold(1), qsub(1).


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