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, or one or more of the letters  "n.   The  hold
33                      type associated with each letter is:
34
35                      u - USER
36
37                      o - OTHER
38
39                      s - SYSTEM
40
41                      n - None
42

OPERANDS

44       The  qrls  command  accepts  one or more job_identifier operands of the
45       form:
46           sequence_number[.server_name][@server]
47

STANDARD ERROR

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

EXIT STATUS

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

SEE ALSO

60       qsub(1B), qalter(1B), qhold(1B), pbs_alterjob(3B), pbs_holdjob(3B), and
61       pbs_rlsjob(3B).
62
63
64
65Local                                                                 qrls(1B)