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



[1mNAME[0m
       qrls - release Grid Engine jobs from previous hold states

[1mSYNTAX[0m
       [1mqrls [22m[ [1m-h [22m{[1mu[22m|[1mo[22m|[1ms[22m},...  ] [ [1m-help [22m] [ [1mjob/task_id_list [22m]

       [1mqrls [22m[ [1m-h [22m{[1mu[22m|[1mo[22m|[1ms[22m},...  ] [ [1m-help [22m] [1m-u user_list[0m

[1mDESCRIPTION[0m
       [4mQrls[24m  provides a means for a user/operator/manager to release so called
       [4mholds[24m 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 [4mqhold[24m(1), [4mqsub[24m(1)  or  the  [4mqal-[0m
       [4mter[24m(1) command.

       There are three different types of holds:

       [1muser   [22mUser  holds  can  be assigned and removed by managers, operators
              and the owner of the jobs.

       [1moperator[0m
              Operator holds can be assigned and removed by managers and oper-
              ators.

       [1msystem [22mSystem holds can be assigned and removed by managers only.

       If  no  hold  type is specified with the [1m-h [22moption (see below) the user
       hold is assumed by default.

       An alternate way to release holds is the [4mqalter[24m(1) command (see the  [4m-h[0m
       option).

[1mOPTIONS[0m
       [1m-h [22m{[1mu[22m|[1mo[22m|[1ms[22m},...
              Releases a u(ser), o(perator) or s(system) hold or a combination
              thereof from one or more jobs.

       [1m-help  [22mPrints a listing of all options.

       [1m-u username,...[0m
              Modifies the hold state of those jobs which  were  submitted  by
              users  specified in the list of usernames.  Managers are allowed
              to use the [1mqrls -u "*" [22mcommand to modify the hold state for jobs
              of all users.

              If a user uses the [1m-u [22mswitch, the user may specify an additional
              [4mjob/task_id_list[24m.

       [1mjob/task_id_list[0m
              Specified by the following form:

                  [4mjob_id[.task_range][,job_id[.task_range],...][0m

              If present, the [4mtask_range[24m restricts the effect of the operation
              to  the  array  job task range specified as suffix to the job id
              (see the [1m-t [22moption to  [4mqsub[24m(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  [4mjob/task_id_list[24m  it is possible to use the keyword
              'all' to modify all jobs of the current user.

[1mENVIRONMENTAL VARIABLES[0m
       [1mSGE_ROOT       [22mSpecifies the location of the Grid Engine standard  con-
                      figuration files.

       [1mSGE_CELL       [22mIf  set,  specifies  the  default  Grid  Engine cell. To
                      address a Grid Engine cell [4mqrls[24m 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. [1mdefault[22m.


       [1mSGE_DEBUG_LEVEL[0m
                      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.

       [1mSGE_QMASTER_PORT[0m
                      If set, specifies the tcp port on  which  [4msge_qmaster[24m(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.

[1mSEE ALSO[0m
       [4msge_intro[24m(1), [4mqalter[24m(1), [4mqhold[24m(1), [4mqsub[24m(1).

[1mCOPYRIGHT[0m
       See [4msge_intro[24m(1) for a full statement of rights and permissions.



GE 6.0                   $Date: 2007/01/05 20:31:02 $                  QRLS(1)
