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).