NAME
qhold - hold back Sun 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
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) 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 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 combination
thereof to one or more jobs.
-help Prints a listing of all options.
-u username,...
Changes are only made on those jobs which were submitted by
users specified in the list of usernames. Managers are allowed
to use the qhold -u "*" command to set a hold for all 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 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 Sun Grid Engine standard
configuration files.
SGE_CELL If set, specifies the default Sun Grid Engine cell. To
address a Sun 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.
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), qrls(1), qsub(1).
COPYRIGHT
See sge_intro(1) for a full statement of rights and permissions.