qrls-torque(1)

1qrls(1B)                              PBS                             qrls(1B)
2
3
4

NAME

6       qrls - release hold on pbs batch jobs
7

SYNOPSIS

9       qrls [-h hold_list] [-t array_range] job_identifier ...
10

DESCRIPTION

12       The qrls command removes or releases holds which exist on batch jobs.
13
14       A job may have one or more types of holds which make the job ineligible
15       for execution.  The types of holds are USER, OTHER,  and  SYSTEM.   The
16       different  types  of  holds  may require that the user issuing the qrls
17       command have special privilege.  Typically, the owner of the  job  will
18       be  able  to  remove  a USER hold, but not an OTHER or SYSTEM hold.  An
19       Attempt to release a hold for which the user does not have the  correct
20       privilege is an error and no holds will be released for that job.
21
22       If no -h option is specified, the USER hold will be released.
23
24       If  the  job  has no execution_time pending, the job will change to the
25       queued state.  If an execution_time is  still  pending,  the  job  will
26       change to the waiting state.
27

OPTIONS

29       -h hold_list   Defines  the types of hold to be released from the jobs.
30                      The hold_list option argument is a string consisting  of
31                      one  or more of the letters "u", "o", an "s" in any com‐
32                      bination.  The hold type associated with each letter is:
33
34                      u - USER
35
36                      o - OTHER
37
38                      s - SYSTEM
39
40       -t array_range The array_range argument is an integer id or a range  of
41                      integers. Multiple ids or id ranges can be combined in a
42                      comma  delimted  list.  Examples:   -t   1-100   or   -t
43                      1,10,50-100
44
45                      If  an array range isn't specified, the command tries to
46                      operate on the entire array. The  command  acts  on  the
47                      array (or specified range of the array) just as it would
48                      on an individual job.
49

OPERANDS

51       The qrls command accepts one or more  job_identifier  operands  of  the
52       form:
53           sequence_number[.server_name][@server]
54

STANDARD ERROR

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

EXIT STATUS

60       Upon successful processing of all the operands presented  to  the  qrls
61       command, the exit status will be a value of zero.
62
63       If  the  qrls  command  fails to process any operand, the command exits
64       with a value greater than zero.
65