QSELECT(1)                 POSIX Programmer's Manual                QSELECT(1)



PPRROOLLOOGG
       This manual page is part of the POSIX Programmer's Manual.  The OS
       implementation of this interface may differ (consult the corresponding
       OS manual page for details of OS behavior), or the interface may not be
       implemented on OS.

NNAAMMEE
       qselect -- select batch jobs

SSYYNNOOPPSSIISS
       qselect [[-a [[_o_p]]_d_a_t_e___t_i_m_e]] [[-A _a_c_c_o_u_n_t___s_t_r_i_n_g]] [[-c [[_o_p]]_i_n_t_e_r_v_a_l]]
           [[-h _h_o_l_d___l_i_s_t]] [[-l _r_e_s_o_u_r_c_e___l_i_s_t]] [[-N _n_a_m_e]] [[-p [[_o_p]]_p_r_i_o_r_i_t_y]]
           [[-q _d_e_s_t_i_n_a_t_i_o_n]] [[-r _y|_n]] [[-s _s_t_a_t_e_s]] [[-u _u_s_e_r___l_i_s_t]]

DDEESSCCRRIIPPTTIIOONN
       To select a set of batch jobs is to return the batch _j_o_b___i_d_e_n_t_i_f_i_e_rs
       for each batch job that meets a list of selection criteria. A set of
       batch jobs is selected by a request to a batch server. The _q_s_e_l_e_c_t
       utility is a user-accessible batch client that requests the selection
       of batch jobs.

       Upon successful completion, the _q_s_e_l_e_c_t utility shall have returned a
       list of zero or more batch _j_o_b___i_d_e_n_t_i_f_i_e_rs that meet the criteria
       specified by the options and option-arguments presented to the utility.

       The _q_s_e_l_e_c_t utility shall select batch jobs by sending a _S_e_l_e_c_t _J_o_b_s
       _R_e_q_u_e_s_t to a batch server. The _q_s_e_l_e_c_t utility shall not exit until the
       server replies to each request generated.

       For each option presented to the _q_s_e_l_e_c_t utility, the utility shall
       restrict the set of selected batch jobs as described in the OPTIONS
       section.

       The _q_s_e_l_e_c_t utility shall not restrict selection of batch jobs except
       by authorization and as required by the options presented to the
       utility.

       When an option is specified with a mandatory or optional _o_p component
       to the option-argument, then _o_p shall specify a relation between the
       value of a certain batch job attribute and the _v_a_l_u_e component of the
       option-argument. If an _o_p is allowable on an option, then the
       description of the option letter indicates the _o_p as either mandatory
       or optional. Acceptable strings for the _o_p component, and the relation
       the string indicates, are shown in the following list:

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

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

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

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

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

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

OOPPTTIIOONNSS
       The _q_s_e_l_e_c_t utility shall conform to the Base Definitions volume of
       POSIX.1-2017, _S_e_c_t_i_o_n _1_2_._2, _U_t_i_l_i_t_y _S_y_n_t_a_x _G_u_i_d_e_l_i_n_e_s.

       The following options shall be supported by the implementation:

       --aa [[_o_p]]_d_a_t_e___t_i_m_e
                 Restrict selection to a specific time, or a range of times.

                 The _q_s_e_l_e_c_t utility shall select only batch jobs for which
                 the value of the _E_x_e_c_u_t_i_o_n___T_i_m_e attribute is related to the
                 Epoch equivalent of the local time expressed by the value of
                 the _d_a_t_e___t_i_m_e component of the option-argument in the manner
                 indicated by the value of the _o_p component of the option-
                 argument.

                 The _q_s_e_l_e_c_t utility shall accept a _d_a_t_e___t_i_m_e component of the
                 option-argument that conforms to the syntax of the _t_i_m_e
                 operand of the _t_o_u_c_h utility.

                 If the _o_p component of the option-argument is not presented
                 to the _q_s_e_l_e_c_t utility, the utility shall select batch jobs
                 for which the _E_x_e_c_u_t_i_o_n___T_i_m_e attribute is equal to the
                 _d_a_t_e___t_i_m_e component of the option-argument.

                 When comparing times, the _q_s_e_l_e_c_t utility shall use the
                 following definitions for the _o_p component of the option-
                 argument:

                 .eq.    The time represented by value of the _E_x_e_c_u_t_i_o_n___T_i_m_e
                         attribute of the batch job is equal to the time
                         represented by the _d_a_t_e___t_i_m_e component of the option-
                         argument.

                 .ge.    The time represented by value of the _E_x_e_c_u_t_i_o_n___T_i_m_e
                         attribute of the batch job is after or equal to the
                         time represented by the _d_a_t_e___t_i_m_e component of the
                         option-argument.

                 .gt.    The time represented by value of the _E_x_e_c_u_t_i_o_n___T_i_m_e
                         attribute of the batch job is after the time
                         represented by the _d_a_t_e___t_i_m_e component of the option-
                         argument.

                 .lt.    The time represented by value of the _E_x_e_c_u_t_i_o_n___T_i_m_e
                         attribute of the batch job is before the time
                         represented by the _d_a_t_e___t_i_m_e component of the option-
                         argument.

                 .le.    The time represented by value of the _E_x_e_c_u_t_i_o_n___T_i_m_e
                         attribute of the batch job is before or equal to the
                         time represented by the _d_a_t_e___t_i_m_e component of the
                         option-argument.

                 .ne.    The time represented by value of the _E_x_e_c_u_t_i_o_n___T_i_m_e
                         attribute of the batch job is not equal to the time
                         represented by the _d_a_t_e___t_i_m_e component of the option-
                         argument.

                 The _q_s_e_l_e_c_t utility shall accept the defined character
                 strings for the _o_p component of the option-argument.

       --AA _a_c_c_o_u_n_t___s_t_r_i_n_g
                 Restrict selection to the batch jobs charging a specified
                 account.

                 The _q_s_e_l_e_c_t utility shall select only batch jobs for which
                 the value of the _A_c_c_o_u_n_t___N_a_m_e attribute of the batch job
                 matches the value of the _a_c_c_o_u_n_t___s_t_r_i_n_g option-argument.

                 The syntax of the _a_c_c_o_u_n_t___s_t_r_i_n_g option-argument is
                 unspecified.

       --cc [[_o_p]]_i_n_t_e_r_v_a_l
                 Restrict selection to batch jobs within a range of checkpoint
                 intervals.

                 The _q_s_e_l_e_c_t utility shall select only batch jobs for which
                 the value of the _C_h_e_c_k_p_o_i_n_t attribute relates to the value of
                 the _i_n_t_e_r_v_a_l component of the option-argument in the manner
                 indicated by the value of the _o_p component of the option-
                 argument.

                 If the _o_p component of the option-argument is omitted, the
                 _q_s_e_l_e_c_t utility shall select batch jobs for which the value
                 of the _C_h_e_c_k_p_o_i_n_t attribute is equal to the value of the
                 _i_n_t_e_r_v_a_l component of the option-argument.

                 When comparing checkpoint intervals, the _q_s_e_l_e_c_t utility
                 shall use the following definitions for the _o_p component of
                 the option-argument:

                 .eq.    The value of the _C_h_e_c_k_p_o_i_n_t attribute of the batch
                         job equals the value of the _i_n_t_e_r_v_a_l component of the
                         option-argument.

                 .ge.    The value of the _C_h_e_c_k_p_o_i_n_t attribute of the batch
                         job is greater than or equal to the value of the
                         _i_n_t_e_r_v_a_l component option-argument.

                 .gt.    The value of the _C_h_e_c_k_p_o_i_n_t attribute of the batch
                         job is greater than the value of the _i_n_t_e_r_v_a_l
                         component option-argument.

                 .lt.    The value of the _C_h_e_c_k_p_o_i_n_t attribute of the batch
                         job is less than the value of the _i_n_t_e_r_v_a_l component
                         option-argument.

                 .le.    The value of the _C_h_e_c_k_p_o_i_n_t attribute of the batch
                         job is less than or equal to the value of the
                         _i_n_t_e_r_v_a_l component option-argument.

                 .ne.    The value of the _C_h_e_c_k_p_o_i_n_t attribute of the batch
                         job does not equal the value of the _i_n_t_e_r_v_a_l
                         component option-argument.

                 The _q_s_e_l_e_c_t utility shall accept the defined character
                 strings for the _o_p component of the option-argument.

                 The ordering relationship for the values of the interval
                 option-argument is defined to be:


                     `n' .gt. `s' .gt. `c=_m_i_n_u_t_e_s' .ge. `c'

                 When comparing _C_h_e_c_k_p_o_i_n_t attributes with an interval having
                 the value of the single character ''uu'', only equality or
                 inequality are valid comparisons.

       --hh _h_o_l_d___l_i_s_t
                 Restrict selection to batch jobs that have a specific type of
                 hold.

                 The _q_s_e_l_e_c_t utility shall select only batch jobs for which
                 the value of the _H_o_l_d___T_y_p_e_s attribute matches the value of
                 the _h_o_l_d___l_i_s_t option-argument.

                 The _q_s_e_l_e_c_t --hh option shall accept a value for the _h_o_l_d___l_i_s_t
                 option-argument that is a string of alphanumeric characters
                 in the portable character set (see the Base Definitions
                 volume of POSIX.1-2017, _S_e_c_t_i_o_n _6_._1, _P_o_r_t_a_b_l_e _C_h_a_r_a_c_t_e_r _S_e_t).

                 The _q_s_e_l_e_c_t utility shall accept a value for the _h_o_l_d___l_i_s_t
                 option-argument that is a string of one or more of the
                 characters ''uu'', ''ss'', or ''oo'', or the single character ''nn''.

                 Each unique character in the _h_o_l_d___l_i_s_t option-argument of the
                 _q_s_e_l_e_c_t utility is defined as follows, each representing a
                 different hold type:

                 u     USER

                 s     SYSTEM

                 o     OPERATOR

                 If any of these characters are duplicated in the _h_o_l_d___l_i_s_t
                 option-argument, the duplicates shall be ignored.

                 The _q_s_e_l_e_c_t utility shall consider it an error if any hold
                 type other than ''nn'' is combined with hold type ''nn''.

                 Strictly conforming applications shall not repeat any of the
                 characters ''uu'', ''ss'', ''oo'', or ''nn'' within the _h_o_l_d___l_i_s_t option-
                 argument. The _q_s_e_l_e_c_t utility shall permit the repetition of
                 characters, but shall not assign additional meaning to the
                 repeated characters.

                 An implementation may define other hold types. The
                 conformance document for an implementation shall describe any
                 additional hold types, how they are specified, their internal
                 behavior, and how they affect the behavior of the utility.

       --ll _r_e_s_o_u_r_c_e___l_i_s_t
                 Restrict selection to batch jobs with specified resource
                 limits and attributes.

                 The _q_s_e_l_e_c_t utility shall accept a _r_e_s_o_u_r_c_e___l_i_s_t option-
                 argument with the following syntax:


                     _r_e_s_o_u_r_c_e___n_a_m_e _o_p _v_a_l_u_e [[,,_r_e_s_o_u_r_c_e___n_a_m_e _o_p _v_a_l_u_e,, ...]]

                 When comparing resource values, the _q_s_e_l_e_c_t utility shall use
                 the following definitions for the _o_p component of the option-
                 argument:

                 .eq.    The value of the resource of the same name in the
                         _R_e_s_o_u_r_c_e___L_i_s_t attribute of the batch job equals the
                         value of the value component of the option-argument.

                 .ge.    The value of the resource of the same name in the
                         _R_e_s_o_u_r_c_e___L_i_s_t attribute of the batch job is greater
                         than or equal to the value of the _v_a_l_u_e component of
                         the option-argument.

                 .gt.    The value of the resource of the same name in the
                         _R_e_s_o_u_r_c_e___L_i_s_t attribute of the batch job is greater
                         than the value of the value component of the option-
                         argument.

                 .lt.    The value of the resource of the same name in the
                         _R_e_s_o_u_r_c_e___L_i_s_t attribute of the batch job is less than
                         the value of the value component of the option-
                         argument.

                 .ne.    The value of the resource of the same name in the
                         _R_e_s_o_u_r_c_e___L_i_s_t attribute of the batch job does not
                         equal the value of the value component of the option-
                         argument.

                 .le.    The value of the resource of the same name in the
                         _R_e_s_o_u_r_c_e___L_i_s_t attribute of the batch job is less than
                         or equal to the value of the _v_a_l_u_e component of the
                         option-argument.

                 When comparing the limit of a _R_e_s_o_u_r_c_e___L_i_s_t attribute with
                 the _v_a_l_u_e component of the option-argument, if the limit, the
                 value, or both are non-numeric, only equality or inequality
                 are valid comparisons.

                 The _q_s_e_l_e_c_t utility shall select only batch jobs for which
                 the values of the _r_e_s_o_u_r_c_e___n_a_m_es listed in the _r_e_s_o_u_r_c_e___l_i_s_t
                 option-argument match the corresponding limits of the
                 _R_e_s_o_u_r_c_e___L_i_s_t attribute of the batch job.

                 Limits of _r_e_s_o_u_r_c_e___n_a_m_es present in the _R_e_s_o_u_r_c_e___L_i_s_t
                 attribute of the batch job that have no corresponding values
                 in the _r_e_s_o_u_r_c_e___l_i_s_t option-argument shall not be considered
                 when selecting batch jobs.

       --NN _n_a_m_e   Restrict selection to batch jobs with a specified name.

                 The _q_s_e_l_e_c_t utility shall select only batch jobs for which
                 the value of the _J_o_b___N_a_m_e attribute matches the value of the
                 _n_a_m_e option-argument. The string specified in the _n_a_m_e
                 option-argument shall be passed, uninterpreted, to the
                 server. This allows an implementation to match ``wildcard''
                 patterns against batch job names.

                 An implementation shall describe in the conformance document
                 the format it supports for matching against the _J_o_b___N_a_m_e
                 attribute.

       --pp [[_o_p]]_p_r_i_o_r_i_t_y
                 Restrict selection to batch jobs of the specified priority or
                 range of priorities.

                 The _q_s_e_l_e_c_t utility shall select only batch jobs for which
                 the value of the _P_r_i_o_r_i_t_y attribute of the batch job relates
                 to the value of the _p_r_i_o_r_i_t_y component of the option-argument
                 in the manner indicated by the value of the _o_p component of
                 the option-argument.

                 If the _o_p component of the option-argument is omitted, the
                 _q_s_e_l_e_c_t utility shall select batch jobs for which the value
                 of the _P_r_i_o_r_i_t_y attribute of the batch job is equal to the
                 value of the _p_r_i_o_r_i_t_y component of the option-argument.

                 When comparing priority values, the _q_s_e_l_e_c_t utility shall use
                 the following definitions for the _o_p component of the option-
                 argument:

                 .eq.    The value of the _P_r_i_o_r_i_t_y attribute of the batch job
                         equals the value of the _p_r_i_o_r_i_t_y component of the
                         option-argument.

                 .ge.    The value of the _P_r_i_o_r_i_t_y attribute of the batch job
                         is greater than or equal to the value of the _p_r_i_o_r_i_t_y
                         component option-argument.

                 .gt.    The value of the _P_r_i_o_r_i_t_y attribute of the batch job
                         is greater than the value of the _p_r_i_o_r_i_t_y component
                         option-argument.

                 .lt.    The value of the _P_r_i_o_r_i_t_y attribute of the batch job
                         is less than the value of the _p_r_i_o_r_i_t_y component
                         option-argument.

                 .lt.    The value of the _P_r_i_o_r_i_t_y attribute of the batch job
                         is less than or equal to the value of the _p_r_i_o_r_i_t_y
                         component option-argument.

                 .ne.    The value of the _P_r_i_o_r_i_t_y attribute of the batch job
                         does not equal the value of the _p_r_i_o_r_i_t_y component
                         option-argument.

       --qq _d_e_s_t_i_n_a_t_i_o_n
                 Restrict selection to the specified batch queue or server, or
                 both.

                 The _q_s_e_l_e_c_t utility shall select only batch jobs that are
                 located at the destination indicated by the value of the
                 _d_e_s_t_i_n_a_t_i_o_n option-argument.

                 The destination defines a batch queue, a server, or a batch
                 queue at a server.

                 The _q_s_e_l_e_c_t utility shall accept an option-argument for the
                 --qq option that conforms to the syntax for a destination. If
                 the --qq option is not presented to the _q_s_e_l_e_c_t utility, the
                 utility shall select batch jobs from all batch queues at the
                 default batch server.

                 If the option-argument describes only a batch queue, the
                 _q_s_e_l_e_c_t utility shall select only batch jobs from the batch
                 queue of the specified name at the default batch server. The
                 means by which _q_s_e_l_e_c_t determines the default server is
                 implementation-defined.

                 If the option-argument describes only a batch server, the
                 _q_s_e_l_e_c_t utility shall select batch jobs from all the batch
                 queues at that batch server.

                 If the option-argument describes both a batch queue and a
                 batch server, the _q_s_e_l_e_c_t utility shall select only batch
                 jobs from the specified batch queue at the specified server.

       --rr y|n    Restrict selection to batch jobs with the specified
                 rerunability status.

                 The _q_s_e_l_e_c_t utility shall select only batch jobs for which
                 the value of the _R_e_r_u_n_a_b_l_e attribute of the batch job matches
                 the value of the option-argument.

                 The _q_s_e_l_e_c_t utility shall accept a value for the option-
                 argument that consists of either the single character ''yy'' or
                 the single character ''nn''.  The character ''yy'' represents the
                 value TRUE, and the character ''nn'' represents the value FALSE.

       --ss _s_t_a_t_e_s Restrict selection to batch jobs in the specified states.

                 The _q_s_e_l_e_c_t utility shall accept an option-argument that
                 consists of any combination of the characters ''ee'', ''qq'', ''rr'',
                 ''ww'', ''hh'', and ''tt''.

                 Conforming applications shall not repeat any character in the
                 option-argument. The _q_s_e_l_e_c_t utility shall permit the
                 repetition of characters in the option-argument, but shall
                 not assign additional meaning to repeated characters.

                 The _q_s_e_l_e_c_t utility shall interpret the characters in the
                 _s_t_a_t_e_s option-argument as follows:

                 e     Represents the EXITING state.

                 q     Represents the QUEUED state.

                 r     Represents the RUNNING state.

                 t     Represents the TRANSITING state.

                 h     Represents the HELD state.

                 w     Represents the WAITING state.

                 For each character in the _s_t_a_t_e_s option-argument, the _q_s_e_l_e_c_t
                 utility shall select batch jobs in the corresponding state.

       --uu _u_s_e_r___l_i_s_t
                 Restrict selection to batch jobs owned by the specified user
                 names.

                 The _q_s_e_l_e_c_t utility shall select only the batch jobs of those
                 users specified in the _u_s_e_r___l_i_s_t option-argument.

                 The _q_s_e_l_e_c_t utility shall accept a _u_s_e_r___l_i_s_t option-argument
                 that conforms to the following syntax:


                     _u_s_e_r_n_a_m_e[[@_h_o_s_t]][[,,_u_s_e_r_n_a_m_e[[@_h_o_s_t]],, ...]]

                 The _q_s_e_l_e_c_t utility shall accept only one user name that is
                 missing a corresponding host name. The _q_s_e_l_e_c_t utility shall
                 accept only one user name per named host.

OOPPEERRAANNDDSS
       None.

SSTTDDIINN
       Not used.

IINNPPUUTT FFIILLEESS
       None.

EENNVVIIRROONNMMEENNTT VVAARRIIAABBLLEESS
       The following environment variables shall affect the execution of
       _q_s_e_l_e_c_t:

       _L_A_N_G      Provide a default value for the internationalization
                 variables that are unset or null. (See the Base Definitions
                 volume of POSIX.1-2017, _S_e_c_t_i_o_n _8_._2, _I_n_t_e_r_n_a_t_i_o_n_a_l_i_z_a_t_i_o_n
                 _V_a_r_i_a_b_l_e_s the precedence of internationalization variables
                 used to determine the values of locale categories.)

       _L_C___A_L_L    If set to a non-empty string value, override the values of
                 all the other internationalization variables.

       _L_C___C_T_Y_P_E  Determine the locale for the interpretation of sequences of
                 bytes of text data as characters (for example, single-byte as
                 opposed to multi-byte characters in arguments).

       _L_C___M_E_S_S_A_G_E_S
                 Determine the locale that should be used to affect the format
                 and contents of diagnostic messages written to standard
                 error.

       _L_O_G_N_A_M_E   Determine the login name of the user.

       _T_Z        Determine the timezone used to interpret the _d_a_t_e_-_t_i_m_e
                 option-argument. If _T_Z is unset or null, an unspecified
                 default timezone shall be used.

AASSYYNNCCHHRROONNOOUUSS EEVVEENNTTSS
       Default.

SSTTDDOOUUTT
       The _q_s_e_l_e_c_t utility shall write zero or more batch _j_o_b___i_d_e_n_t_i_f_i_e_rs to
       standard output.

       The _q_s_e_l_e_c_t utility shall separate the batch _j_o_b___i_d_e_n_t_i_f_i_e_rs written to
       standard output by white space.

       The _q_s_e_l_e_c_t utility shall write batch _j_o_b___i_d_e_n_t_i_f_i_e_rs in the following
       format:


           _s_e_q_u_e_n_c_e___n_u_m_b_e_r_._s_e_r_v_e_r___n_a_m_e@_s_e_r_v_e_r

SSTTDDEERRRR
       The standard error shall be used only for diagnostic messages.

OOUUTTPPUUTT FFIILLEESS
       None.

EEXXTTEENNDDEEDD DDEESSCCRRIIPPTTIIOONN
       None.

EEXXIITT SSTTAATTUUSS
       The following exit values shall be returned:

        0    Successful completion.

       >0    An error occurred.

CCOONNSSEEQQUUEENNCCEESS OOFF EERRRROORRSS
       Default.

       _T_h_e _f_o_l_l_o_w_i_n_g _s_e_c_t_i_o_n_s _a_r_e _i_n_f_o_r_m_a_t_i_v_e_.

AAPPPPLLIICCAATTIIOONN UUSSAAGGEE
       None.

EEXXAAMMPPLLEESS
       The following example shows how a user might use the _q_s_e_l_e_c_t utility in
       conjunction with the _q_d_e_l utility to delete all of his or her jobs in
       the queued state without affecting any jobs that are already running:


           qdel $(qselect -s q)

       or:


           qselect -s q || xargs qdel

RRAATTIIOONNAALLEE
       The _q_s_e_l_e_c_t utility allows users to acquire a list of job identifiers
       that match user-specified selection criteria. The list of identifiers
       returned by the _q_s_e_l_e_c_t utility conforms to the syntax of the batch job
       identifier list processed by a utility such as _q_m_o_v_e, _q_d_e_l, and _q_r_l_s.
       The _q_s_e_l_e_c_t 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 _q_s_e_l_e_c_t 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, ""..lltt..""--was chosen rather than the C-like ""<<=="" meta-
       characters.

       The --aa 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 --AA option allows users to restrict the selected jobs to those that
       have been submitted (or altered) to charge a particular account.

       The --cc option allows users to restrict the selected jobs to those whose
       checkpointing interval falls within the specified range.

       The --ll 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 --NN 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 --qq option allows users to select jobs in a specified queue.

       The --rr 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 _q_r_e_r_u_n utility.

       The --ss option allows users to select only those jobs that are in a
       certain state.

       The --uu 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 _q_s_e_l_e_c_t utility
       allow users to select jobs based on all the appropriate attributes that
       can be assigned to jobs by the _q_s_u_b utility.

       Historically, the _q_s_e_l_e_c_t utility has not been a part of existing
       practice; it is an improvement that has been introduced in this volume
       of POSIX.1-2017.

FFUUTTUURREE DDIIRREECCTTIIOONNSS
       The _q_s_e_l_e_c_t utility may be removed in a future version.

SSEEEE AALLSSOO
       _C_h_a_p_t_e_r _3, _B_a_t_c_h _E_n_v_i_r_o_n_m_e_n_t _S_e_r_v_i_c_e_s, _q_d_e_l, _q_r_e_r_u_n, _q_r_l_s, _q_s_e_l_e_c_t,
       _q_s_u_b, _t_o_u_c_h

       The Base Definitions volume of POSIX.1-2017, _S_e_c_t_i_o_n _6_._1, _P_o_r_t_a_b_l_e
       _C_h_a_r_a_c_t_e_r _S_e_t, _C_h_a_p_t_e_r _8, _E_n_v_i_r_o_n_m_e_n_t _V_a_r_i_a_b_l_e_s, _S_e_c_t_i_o_n _1_2_._2, _U_t_i_l_i_t_y
       _S_y_n_t_a_x _G_u_i_d_e_l_i_n_e_s

CCOOPPYYRRIIGGHHTT
       Portions of this text are reprinted and reproduced in electronic form
       from IEEE Std 1003.1-2017, Standard for Information Technology --
       Portable Operating System Interface (POSIX), The Open Group Base
       Specifications Issue 7, 2018 Edition, Copyright (C) 2018 by the
       Institute of Electrical and Electronics Engineers, Inc and The Open
       Group.  In the event of any discrepancy between this version and the
       original IEEE and The Open Group Standard, the original IEEE and The
       Open Group Standard is the referee document. The original Standard can
       be obtained online at http://www.opengroup.org/unix/online.html .

       Any typographical or formatting errors that appear in this page are
       most likely to have been introduced during the conversion of the source
       files to man page format. To report such errors, see
       https://www.kernel.org/doc/man-pages/reporting_bugs.html .



IEEE/The Open Group                  2017                           QSELECT(1)
