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.