Manual Reference Pages - QHOLD (1)
qhold - hold pbs batch jobs
[-h hold_list] [-t array_range]
qhold command requests that a server place one or more holds on
a job. A job that has a hold is not eligible for execution.
There are three supported holds:
(also known as operator), and
A user may place a
hold upon any job the user owns.
An "operator", who is a user with "operator privilege," may place ether an
hold on any job. The batch administrator may place any hold on any job.
option is given, the
hold will be applied to the jobs described by the
If the job identified by
is in the
waiting states, then all that occurs is that the hold type is added to the job.
The job is then placed into
held state if it resides in an execution queue.
If the job is in
running state, then the following additional action is taken to interrupt the
execution of the job.
This is an extension to POSIX.2d.
If checkpoint / restart is supported by the host system, requesting a hold
on a running job will (1) cause the job to be checkpointed, (2) the
resources assigned to the job will be released, and (3) the job is
placed in the
held state in the execution queue.
If checkpoint / restart is not supported, qhold will only set the
the requested hold attribute. This will have no effect unless the job
is rerun with the
The qhold command sends a
Hold Job batch request to the server as described in the general section.
Defines the types of holds to be placed on the job.
argument is a string consisting of one or more of the letters "u",
"o", or "s" in any combination.
The hold type associated with each letter is:
Repetition of characters is permitted.
The array_range argument is an integer id or a range of integers. Multiple ids
or id ranges can be combined in a comma delimted list. Examples: -t 1-100 or
If an array range isnt specified, the command tries to operate on the entire
array. The command acts on the array (or specified range of the array) just as
it would on an individual job.
The qhold command accepts one or more
operands of the form:
See the description under "Job Identifier" in section 2.7.6 in this ERS.
The qhold command will write a diagnostic message to standard error for each
Upon successful processing of all the operands presented to the
qhold command, the exit status will be a value of zero.
If the qhold command fails to process any operand, the
command exits with a value greater than zero.
qrls(1B), qalter(1B), qsub(1B), pbs_alterjob(3B), pbs_holdjob(3B),
pbs_rlsjob(3B), pbs_job_attributes(7B), pbs_resources_unicos8(7B)
Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.