QRLS(1)                     General Commands Manual                    QRLS(1)



NAME
       qrls - release Univa 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  qal-
       ter(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 oper-
              ators.

       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.

ENVIRONMENTAL VARIABLES
       SGE_ROOT       Specifies the location of the Univa Grid Engine standard
                      configuration files.

       SGE_CELL       If set, specifies the default Univa Grid Engine cell. To
                      address a Univa 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 writ-
                      ten  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 ser-
                      vice "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.



Univa Grid Engine User Commands    UGE 8.5.4                           QRLS(1)