qrls

(Release hold on PBS batch jobs)

5.715.99 Synopsis

qrls [{-h <HOLD LIST>|-t <array_range>}] <JOBID>[ <JOBID>] ...

5.715.100 Description

The 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 USER, OTHER, and SYSTEM. The different types of holds may require that the user issuing the qrls command have special privileges. A user may always remove a USER hold on their own jobs, but only privileged users can remove OTHER or SYSTEM holds. 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.

If no -h option is specified, the USER hold will be released.

If the job has no execution_time pending, the job will change to the queued state. If an execution_time is still pending, the job will change to the waiting state.

If you run qrls on an array sub-job, pbs_server will correct the slot limit holds for the array to which it belongs.

5.715.101 Options

Command	Name	Description
-h	hold_list	Defines the types of hold to be released from the jobs. The hold_list option argument is a string consisting of one or more of the letters "u", "o", and "s" in any combination. The hold type associated with each letter is: u – USER o – OTHER s – SYSTEM
-t	array_range	The array_range argument is an integer id or a range of integers. Multiple ids or id ranges can be combined in a comma delimited list. Examples: -t 1-100 or -t 1,10,50-100 If an array range isn't 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.

Command

Name

Description

-h

hold_list

Defines the types of hold to be released from the jobs. The hold_list option argument is a string consisting of one or more of the letters "u", "o", and "s" in any combination. The hold type associated with each letter is:

u – USER
o – OTHER
s – SYSTEM

-t

array_range

The array_range argument is an integer id or a range of integers. Multiple ids or id ranges can be combined in a comma delimited list. Examples: -t 1-100 or -t 1,10,50-100

If an array range isn't 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.

5.715.102 Operands

The qrls command accepts one or more job_identifier operands of the form:

sequence_number[.server_name][@server]

5.715.103 Examples

> qrls -h u 3233 release user hold on job 3233

5.715.104 Standard error

The qrls command will write a diagnostic message to standard error for each error occurrence.

5.715.105 Exit status

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.