qrls Manual Page
NAME
qrls - release hold on 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,
or one or more of the letters "n. The hold
type associated with each letter is:
u - USER
o - OTHER
s - SYSTEM
n - None
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), and pbs_alterjob(3B)
|