qselect Manual Page

     NAME
          qselect - select batch jobs

     SYNOPSIS
          qselect [-a [op]date_time] [-A account_string] [-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.  For the
          user without special privilege, that would be those jobs
          owned by the user.

     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.

          -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 specifying a user name
                    when the qselect user may have different user
                    names on different hosts.

                    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.

qsub | qstat | qdel | qalter | qhold | qmsg | qmove | qrls | qrerun | qselect | qsig