1qselect(1B) PBS qselect(1B)
2
6 qselect - select pbs batch jobs
7
9 qselect [-a [op]date_time] [-A account_string] [-e] [-c [op]interval]
10 [-h hold_list] [-l resource_list] [-N name] [-p [op]priority] [-q des‐
11 tination] [-r rerun] [-s states] [-u user_list]
12
14 The qselect command provides a method to list the job identifier of
15 those jobs which meet a list of selection criteria. Jobs are selected
16 from those owned by a single server.
17 When qselect successfully completes, it will have written to standard
19 output a list of zero or more jobs which meet the criteria specified by
20 the options. Each option acts as a filter restricting the number of
21 jobs which might be listed. With no options, the qselect command will
22 list all jobs at the server which the user is authorized to list (query
23 status of). The -u option may be used to limit the selection to jobs
24 owned by this user or other specified users.
25
27 When an option is specified with a optional op component to the option
28 argument, then op specifies a relation between the value of a certain
29 job attribute and the value component of the option argument. If an op
30 is allowable on an option, then the description of the option letter
31 will indicate the op is allowable. The only acceptable strings for the
32 op component, and the relation the string indicates, are shown in the
33 following list:
34 .eq. the value represented by the attribute of the job is equal
36 to the value represented by the option argument.
37 .ne. the value represented by the attribute of the job is not
39 equal to the value represented by the option argument.
40 .ge. the value represented by the attribute of the job is greater
42 than or equal to the value represented by the option argu‐
43 ment.
44 .gt. the value represented by the attribute of the job is greater
46 than the value represented by the option argument.
47 .le. the value represented by the attribute of the job is less
49 than or equal to the value represented by the option argu‐
50 ment.
51 .lt. the value represented by the attribute of the job is less
53 than the value represented by the option argument.
54 -a [op]date_time
56 Restricts selection to a specific time, or a range of times.
57 The qselect command selects only jobs for which the value of
59 the Execution_Time attribute is related to the date_time
60 argument by the optional op operator. The date_time argument
61 is in the form of the date_time operand of the touch(1) com‐
62 mand: [[CC]YY]MMDDhhmm[.SS]
63 where the MM is the two digits for the month, DD is the day
64 of the month, hh is the hour, mm is the minute, and the
65 optional SS is the seconds. CC is the century and YY the
66 year.
67 If op is not specified, jobs will be selected for which the
69 Execution_Time and date_time values are equal. If op is
70 specified, jobs will be selected according to the following
71 definitions:
72 .eq. Execution_Time attribute is equal to the date_time
74 argument.
75 .ne. Execution_Time attribute is not equal to the date_time
77 argument.
78 .ge. execution_Time attribute is greater than (after) or
80 equal to the date_time argument.
81 .gt. Execution_Time attribute is greater than (after) the
83 date_time argument.
84 .le. Execution_Time attribute is less than (before) or
86 equal to the date_time argument.
87 .lt. Execution_Time attribute is less than (before) the
89 date_time argument.
90 -e Restricts selection to jobs in execution queues.
92 -A account_string
94 Restricts selection to jobs whose Account_Name attribute
95 matches the specified account_string.
96 -c [op]interval
98 Restricts selection to jobs whose Checkpoint interval
99 attribute matches the specified relationship.
100 The values of the Checkpoint attribute are defined to have
102 the following ordered relationship:
103 n > s > c=minutes > c > u
104 If the optional op is not specified, jobs will be selected
105 whose Checkpoint attribute is equal to the interval argument.
106 If op is specified, jobs will be selected according to:
107 .eq. Checkpoint attribute of the job is equal to the inter‐
109 val argument.
110 .ne. Checkpoint attribute of the job is not equal to the
112 interval argument.
113 .ge. Checkpoint attribute of the job is greater than or
115 equal to the interval argument.
116 .gt. Checkpoint attribute of the job is greater than the
118 interval argument.
119 .le. Checkpoint attribute of the job is less than or equal
121 to the interval argument.
122 .lt. Checkpoint attribute of the job is less than the
124 interval argument.
125 For an interval value of "u", only ".eq." and ".ne." are
127 valid.
128 -h hold_list
130 Restricts the selection of jobs to those with a specific set
131 of hold types. Only those jobs will be selected whose
132 Hold_Types attribute exactly match the value of the hold_list
133 argument.
134 The hold_list argument is a string consisting of one or more
136 occurrences the single letter n, or one or more of the let‐
137 ters u, o, or s in any combination. If letters are dupli‐
138 cated, they are treated as if they occurred once. The let‐
139 ters represent the hold types:
140 n - none
141 u - user
142 o - other
143 s - system
144 -l resource_list
146 Restricts selection of jobs to those with specified resource
147 amounts.
148 Only those jobs will be selected whose Resource_List
150 attribute matches the specified relation with each resource
151 and value listed in the resource_list argument. The
152 resource_list is in the following format:
153 resource_nameopvalue[,resource_nameopval,...]
154 The relation operator op must be present.
155 When comparing the values of resources, the following defini‐
157 tions for the operator apply:
158 .eq. the resource value in the Resource_List attribute of
160 the job equals the value specified in resource_list.
161 .ne. the resource value in the Resource_List attribute of
163 the job is not equal to the value specified in
164 resource_list.
165 .ge. the resource value in the Resource_List attribute of
167 the job is greater than or equal to the value speci‐
168 fied in resource_list.
169 .gt. the resource value in the Resource_List attribute of
171 the job is greater than the value specified in
172 resource_list.
173 .le. the resource value in the Resource_List attribute of
175 the job is less than or equal to the value specified
176 in resource_list.
177 .lt. the resource value in the Resource_List attribute of
179 the job is less than the value specified in
180 resource_list.
181 -N name Restricts selection of jobs to those with a specific name.
183 -p [op]priority
185 Restricts selection of jobs to those with a priority that
186 matches the specified relationship. If op is not specified,
187 jobs are selected for which the job Priority attribute is
188 equal to the priority
189 If the op is specified, the relationship is defined as:
191 .eq. Priority attribute is equal to the value of the prior‐
193 ity argument.
194 .ne. Priority attribute is not equal to the value of the
196 priority argument.
197 .ge. Priority attribute is greater than or equal to the
199 value of the priority argument.
200 .gt. Priority attribute is greater than the value of the
202 priority argument.
203 .le. Priority attribute is less than or equal to the value
205 of the priority argument.
206 .lt. Priority attribute is less than the value of the pri‐
208 ority argument.
209 -q destination
211 Restricts selection to those jobs residing at the specified
212 destination.
213 The destination may be of one of the following three forms:
215 queue
216 @server
217 queue@server
218 If the -q option is not specified, jobs will be selected from
220 the default server.
221 If the destination describes only a queue, only jobs in that
223 queue on the default batch server will be selected.
224 If the destination describes only a server, then jobs in all
226 queues on that server will be selected.
227 If the destination describes both a queue and a server, then
229 only jobs in the named queue on the named server will be
230 selected.
231 -r rerun Restricts selection of jobs to those with the specified
233 Rerunable attribute. The option argument must be a single
234 character. The following two characters are supported by
235 PBS: y and n.
236 -s states Restricts job selection to those in the specified states.
238 The states argument is a character string which consists of
240 any combination of the characters: E, H, Q, R, T, and W.
241 The characters in the states argument have the following
243 interpretation:
244 E the Exiting state.
246 H the Held state.
248 Q the Queued state.
250 R the Running state.
252 T the Transiting state.
254 W the Waiting state.
256 Jobs will be selected which are in any of the specified
258 states.
259 -u user_list
261 Restricts selection to jobs owned by the specified user
262 names.
263 This provides a means of limiting the selection to jobs owned
265 by one or more users.
266 The syntax of the user_list is:
268 user_name[@host][,user_name[@host],...]
269 Host names may be wild carded on the left end, e.g.
270 "*.nasa.gov". User_name without a "@host" is equivalent to
271 "user_name@*", that is at any host. Jobs will be selected
272 which are owned by the listed users at the corresponding
273 hosts.
274
276 The list of job identifiers of selected jobs is written to standard
277 output. Each job identifier is separated by white space. Each job
278 identifier is of the form:
279 sequence_number.server_name@server
280 Where sequence_number.server is the identifier assigned at submission
281 time, see qsub. @server identifies the server which currently owns the
282 job.
283
285 The qselect command will write a diagnostic message to standard error
286 for each error occurrence.
287
289 Upon successful processing of all options presented to the qselect com‐
290 mand, the exit status will be a value of zero.
291 If the qselect command fails to process any option, the command exits
293 with a value greater than zero.
294
296 qsub(1B), qstat(1B), pbs_selectjob(3B), pbs_selstat(3B),
297 pbs_statjob(3B)
298Local qselect(1B)