qrls(1)
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.