NAME

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

ENVIRONMENT VARIABLES

       SGE_ROOT       Specifies the location of the Grid Engine standard configuration files.

       SGE_CELL       If set, specifies the default Grid Engine cell. To address  a  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 communication 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 permissions.