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

NAME

6       qrls - release hold on pbs batch jobs
7

SYNOPSIS

9       qrls [-h hold_list] 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

OPERANDS

41       The qrls command accepts one or more  job_identifier  operands  of  the
42       form:
43           sequence_number[.server_name][@server]
44

STANDARD ERROR

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

EXIT STATUS

50       Upon successful processing of all the operands presented  to  the  qrls
51       command, the exit status will be a value of zero.
52
53       If  the  qrls  command  fails to process any operand, the command exits
54       with a value greater than zero.
55

SEE ALSO

57       qsub(1B), qalter(1B), qhold(1B), pbs_alterjob(3B), pbs_holdjob(3B), and
58       pbs_rlsjob(3B).
59
60
61
62Local                                                                 qrls(1B)