qhold Manual Page
qhold - hold pbs batch jobs
qhold [-h hold_list] job_identifier ...
The 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: user, admin,
(also known as operator), and system.
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 user or an operator hold on any job. The
batch administrator may place any hold on any job.
If no option is given, the USER hold will be applied to
the jobs described by the operand list.
If the job identified by is in the queued, held, or wait-
ing states, then all that occurs is that the hold type is
added to the job. The job is then placed into heldstate
if it resides in an execution queue.
If the job is in running state, then the following addi-
tional action is taken to interrupt the execution of the
job. 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 qrerun command.
The qhold command sends a HoldJob batch request to the
server as described in the general section.
-h hold_list Defines the types of holds to be placed on
The argument is a string consisting of one
or more of the letters "u", "o", or "s" in
any combination or the character "n". The
hold type associated with each letter is:
u - user
o - operator
s - system
n - none
The qhold command accepts one or more operands of the
The qhold command will write a diagnostic message to
standard error for each error occurrence.
Upon successful processing of all the operands presented to
the 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.