NAME
     qrls - release Sun  Grid  Engine  jobs  from  previous  hold
     states

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

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

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

OPTIONS
     -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  sub-
          mitted  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 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
          operation to the array job task range specified as suf-
          fix 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 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 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.


     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), qhold(1), qsub(1).


COPYRIGHT
     See sge_intro(1) for a full statement of rights and  permis-
     sions.