The qselect utility allows users to acquire a list of job
identifiers that match user-specified selection criteria. The
list of identifiers returned by the qselect utility conforms to
the syntax of the batch job identifier list processed by a
utility such as qmove, qdel, and qrls. The qselect utility is
thus a powerful tool for causing another batch system utility to
act upon a set of jobs that match a list of selection criteria.
The options of the qselect utility let the user apply a number of
useful filters for selecting jobs. Each option further restricts
the selection of jobs. Many of the selection options allow the
specification of a relational operator. The FORTRAN-like syntax
of the operator—that is, ".lt."—was chosen rather than the C-like
"<=" meta-characters.
The -a option allows users to restrict the selected jobs to those
that have been submitted (or altered) to wait until a particular
time. The time period is determined by the argument of this
option, which includes both a time and an operator—it is thus
possible to select jobs waiting until a specific time, jobs
waiting until after a certain time, or those waiting for a time
before the specified time.
The -A option allows users to restrict the selected jobs to those
that have been submitted (or altered) to charge a particular
account.
The -c option allows users to restrict the selected jobs to those
whose checkpointing interval falls within the specified range.
The -l option allows users to select those jobs whose resource
limits fall within the range indicated by the value of the
option. For example, a user could select those jobs for which the
CPU time limit is greater than two hours.
The -N option allows users to select jobs by job name. For
instance, all the parts of a task that have been divided in
parallel jobs might be given the same name, and thus manipulated
as a group by means of this option.
The -q option allows users to select jobs in a specified queue.
The -r option allows users to select only those jobs with a
specified rerun criteria. For instance, a user might select only
those jobs that can be rerun for use with the qrerun utility.
The -s option allows users to select only those jobs that are in
a certain state.
The -u option allows users to select jobs that have been
submitted to execute under a particular account.
The selection criteria provided by the options of the qselect
utility allow users to select jobs based on all the appropriate
attributes that can be assigned to jobs by the qsub utility.
Historically, the qselect utility has not been a part of existing
practice; it is an improvement that has been introduced in this
volume of POSIX.1‐2017.
