Manual Reference Pages - QRLS (1)
qrls - release hold on pbs batch jobs
[-h hold_list] [-t array_range]
qrls command removes or releases holds which exist on batch jobs.
A job may have one or more types of holds which make the job
ineligible for execution.
The types of holds are
The different types of holds may require
that the user issuing the qrls command have special privilege.
Typically, the owner of the job will be able to remove a
hold, but not an
An Attempt to release a hold for which the user does not have the
correct privilege is an error and no holds will be released for that job.
option is specified, the
hold will be released.
If the job has no
pending, the job will change to the
queued state. If an
is still pending, the job will change to the
attribute is set, when the job is returned to
queued state, it may be given preference in selection for execution depending
on site policy.
The qrls command sends a
Release Job batch request to the server which owns the job.
Defines the types of hold to be released from the jobs.
option argument is a string consisting of one or more of the letters "u",
"o", an "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 qrls command accepts one or more
operands of the form:
See the description under "Job Identifier" in section 2.7.6 in this ERS.
The qrls command will write a diagnostic message to standard error for
each error occurrence.
Upon successful processing of all the operands presented to the
qrls command, the exit status will be a value of zero.
If the qrls command fails to process any operand, the
command exits with a value greater than zero.
qsub(1B), qalter(1B), qhold(1B), pbs_alterjob(3B), pbs_holdjob(3B), and
Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.