NAME
qhold - hold back Grid Engine jobs from execution
SYNTAX
qhold [ -h {u|o|s},... ] [ -help ] [ job/task_id_list ]
qhold [ -h {u|o|s},... ] [ -help ] -u user_list | -uall
DESCRIPTION
Qhold provides a means for a user/operator/manager to place
so called holds on 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 removed with the qrls(1) or the qalter(1) com-
mand.
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 assign holds to jobs is the qsub(1) or
the qalter(1) command (see the -h option).
OPTIONS
-h {u|o|s},...
Assign a u(ser), o(perator) or s(system) hold or a com-
bination thereof to one or more jobs.
-help
Prints a listing of all options.
-u username,... | -uall
Changes are only made on those jobs which were submit-
ted by users specified in the list of usernames. For
managers it is possible to use the qhold -uall command
to set a hold for all jobs of all users.
If you use the -u or -uall switch it is be permitted to
specify a 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
qhold 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 the hold state for all jobs of
the current user.
ENVIRONMENTAL 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 qhold
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.
COMMD_PORT If set, specifies the tcp port on which
sge_commd(8) is expected to listen for com-
munication requests. Most installations will
use a services map entry instead to define
that port.
COMMD_HOST If set, specifies the host on which the par-
ticular sge_commd(8) to be used for Grid
Engine communication of the qhold client
resides. Per default the local host is used.
SEE ALSO
sge_intro(1), qalter(1), qrls(1), qsub(1).
COPYRIGHT
See sge_intro(1) for a full statement of rights and permis-
sions.
Man(1) output converted with
man2html