NAME

       qrls - release hold on pbs batch jobs

SYNOPSIS

       qrls [-h hold_list] job_identifier ...

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 privilege.  Typically, the owner of the job will be able to remove a USER hold,
       but  not  an  OTHER  or  SYSTEM  hold.  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.

OPTIONS

       -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", an  "s"  in  any  combination.
                      The hold type associated with each letter is:

                      u - USER

                      o - OTHER

                      s - SYSTEM

OPERANDS

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

STANDARD ERROR

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

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.

SEE ALSO

       qsub(1B), qalter(1B), qhold(1B), pbs_alterjob(3B), pbs_holdjob(3B), and pbs_rlsjob(3B).

Local                                                                                                   qrls(1B)