NAME

       qselect - select pbs batch jobs

SYNOPSIS

       qselect  [-a  [op]date_time] [-A account_string] [-e] [-c [op]interval] [-h hold_list] [-l
       resource_list] [-N name] [-p [op]priority] [-q destination] [-r  rerun]  [-s  states]  [-u
       user_list]

DESCRIPTION

       The  qselect command provides a method to list the job identifier of those jobs which meet
       a list of selection criteria.  Jobs are selected from those owned by a single server.

       When qselect successfully completes, it will have written to standard  output  a  list  of
       zero or more jobs which meet the criteria specified by the options.  Each option acts as a
       filter restricting the number of jobs which might be listed.  With no options, the qselect
       command  will  list  all  jobs  at  the server which the user is authorized to list (query
       status of).  The -u option may be used to limit the selection to jobs owned by  this  user
       or other specified users.

OPTIONS

       When  an  option is specified with a optional op component to the option argument, then op
       specifies a relation between the value of a certain job attribute and the value  component
       of  the  option argument.  If an op is allowable on an option, then the description of the
       option letter will indicate the op is allowable.  The only acceptable strings for  the  op
       component, and the relation the string indicates, are shown in the following list:

            .eq.  the  value  represented  by  the  attribute  of  the  job is equal to the value
                  represented by the option argument.

            .ne.  the value represented by the attribute of the job is not  equal  to  the  value
                  represented by the option argument.

            .ge.  the  value  represented by the attribute of the job is greater than or equal to
                  the value represented by the option argument.

            .gt.  the value represented by the attribute of the job is  greater  than  the  value
                  represented by the option argument.

            .le.  the  value represented by the attribute of the job is less than or equal to the
                  value represented by the option argument.

            .lt.  the value represented by the attribute of  the  job  is  less  than  the  value
                  represented by the option argument.

       -a [op]date_time
                 Restricts selection to a specific time, or a range of times.

                 The  qselect command selects only jobs for which the value of the Execution_Time
                 attribute is related to the date_time argument by the optional op operator.  The
                 date_time  argument  is  in  the  form  of the date_time operand of the touch(1)
                 command: [[CC]YY]MMDDhhmm[.SS]
                 where the MM is the two digits for the month, DD is the day of the month, hh  is
                 the  hour,  mm  is  the  minute,  and the optional SS is the seconds.  CC is the
                 century and YY the year.

                 If op is not specified, jobs will be selected for which the  Execution_Time  and
                 date_time values are equal.  If op is specified, jobs will be selected according
                 to the following definitions:

                 .eq.   Execution_Time attribute is equal to the date_time argument.

                 .ne.   Execution_Time attribute is not equal to the date_time argument.

                 .ge.   execution_Time  attribute  is  greater  than  (after)  or  equal  to  the
                        date_time argument.

                 .gt.   Execution_Time attribute is greater than (after) the date_time argument.

                 .le.   Execution_Time  attribute is less than (before) or equal to the date_time
                        argument.

                 .lt.   Execution_Time attribute is less than (before) the date_time argument.

       -e        Restricts selection to jobs in execution queues.

       -A account_string
                 Restricts selection to jobs whose Account_Name attribute matches  the  specified
                 account_string.

       -c [op]interval
                 Restricts  selection  to  jobs  whose  Checkpoint interval attribute matches the
                 specified relationship.

                 The values of the Checkpoint attribute are defined to have the following ordered
                 relationship:
                     n >  s > c=minutes > c > u
                 If  the  optional  op  is  not specified, jobs will be selected whose Checkpoint
                 attribute is equal to the interval argument.  If op is specified, jobs  will  be
                 selected according to:

                 .eq.   Checkpoint attribute of the job is equal to the interval argument.

                 .ne.   Checkpoint attribute of the job is not equal to the interval argument.

                 .ge.   Checkpoint  attribute of the job is greater than or equal to the interval
                        argument.

                 .gt.   Checkpoint attribute of the job is greater than the interval argument.

                 .le.   Checkpoint attribute of the job is less than or  equal  to  the  interval
                        argument.

                 .lt.   Checkpoint attribute of the job is less than the interval argument.

                 For an interval value of "u", only ".eq." and ".ne." are valid.

       -h hold_list
                 Restricts  the  selection  of  jobs  to those with a specific set of hold types.
                 Only those jobs will be selected whose Hold_Types attribute  exactly  match  the
                 value of the hold_list argument.

                 The  hold_list  argument  is  a string consisting of one or more occurrences the
                 single letter n, or one or more of the letters u, o, or s  in  any  combination.
                 If  letters  are  duplicated,  they  are  treated as if they occurred once.  The
                 letters represent the hold types:
                   n - none
                   u - user
                   o - other
                   s - system

       -l resource_list
                 Restricts selection of jobs to those with specified resource amounts.

                 Only those jobs will be  selected  whose  Resource_List  attribute  matches  the
                 specified  relation  with  each  resource  and value listed in the resource_list
                 argument.  The resource_list is in the following format:
                 resource_nameopvalue[,resource_nameopval,...]
                 The relation operator op must be present.

                 When comparing the values  of  resources,  the  following  definitions  for  the
                 operator apply:

                 .eq.   the  resource  value in the Resource_List attribute of the job equals the
                        value specified in resource_list.

                 .ne.   the resource value in the Resource_List attribute of the job is not equal
                        to the value specified in resource_list.

                 .ge.   the  resource  value in the Resource_List attribute of the job is greater
                        than or equal to the value specified in resource_list.

                 .gt.   the resource value in the Resource_List attribute of the job  is  greater
                        than the value specified in resource_list.

                 .le.   the resource value in the Resource_List attribute of the job is less than
                        or equal to the value specified in resource_list.

                 .lt.   the resource value in the Resource_List attribute of the job is less than
                        the value specified in resource_list.

       -N name   Restricts selection of jobs to those with a specific name.

       -p [op]priority
                 Restricts  selection of jobs to those with a priority that matches the specified
                 relationship.  If op is not specified, jobs  are  selected  for  which  the  job
                 Priority attribute is equal to the priority

                 If the op is specified, the relationship is defined as:

                 .eq.   Priority attribute is equal to the value of the priority argument.

                 .ne.   Priority attribute is not equal to the value of the priority argument.

                 .ge.   Priority  attribute is greater than or equal to the value of the priority
                        argument.

                 .gt.   Priority attribute is greater than the value of the priority argument.

                 .le.   Priority attribute is less than or equal to the  value  of  the  priority
                        argument.

                 .lt.   Priority attribute is less than the value of the priority argument.

       -q destination
                 Restricts selection to those jobs residing at the specified destination.

                 The destination may be of one of the following three forms:
                     queue
                     @server
                     queue@server

                 If  the  -q  option  is  not  specified,  jobs will be selected from the default
                 server.

                 If the destination describes only a queue,  only  jobs  in  that  queue  on  the
                 default batch server will be selected.

                 If  the  destination  describes  only  a server, then jobs in all queues on that
                 server will be selected.

                 If the destination describes both a queue and a server, then only  jobs  in  the
                 named queue on the named server will be selected.

       -r rerun  Restricts  selection  of  jobs  to those with the specified Rerunable attribute.
                 The option argument must be a single character.  The  following  two  characters
                 are supported by PBS: y and n.

       -s states Restricts job selection to those in the specified states.

                 The  states  argument is a character string which consists of any combination of
                 the characters: E, H, Q, R, T, and W.

                 The characters in the states argument have the following interpretation:

                 E    the Exiting state.

                 H    the Held state.

                 Q    the Queued state.

                 R    the Running state.

                 T    the Transiting state.

                 W    the Waiting state.

                 Jobs will be selected which are in any of the specified states.

       -u user_list
                 Restricts selection to jobs owned by the specified user names.

                 This provides a means of limiting the selection to jobs owned  by  one  or  more
                 users.

                 The syntax of the user_list is:
                     user_name[@host][,user_name[@host],...]
                 Host  names  may  be  wild carded on the left end, e.g. "*.nasa.gov".  User_name
                 without a "@host" is equivalent to "user_name@*", that is  at  any  host.   Jobs
                 will be selected which are owned by the listed users at the corresponding hosts.

STANDARD OUTPUT

       The  list  of  job  identifiers  of selected jobs is written to standard output.  Each job
       identifier is separated by white space.  Each job identifier is of the form:
           sequence_number.server_name@server
       Where sequence_number.server is the identifier assigned  at  submission  time,  see  qsub.
       @server identifies the server which currently owns the job.

STANDARD ERROR

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

EXIT STATUS

       Upon successful processing of all options presented  to  the  qselect  command,  the  exit
       status will be a value of zero.

       If the qselect command fails to process any option, the command exits with a value greater
       than zero.

SEE ALSO

       qsub(1B), qstat(1B), pbs_selectjob(3B), pbs_selstat(3B), pbs_statjob(3B)