logo

oasis-root

Compiled tree of Oasis Linux based on own branch at <https://hacktivis.me/git/oasis/> git clone https://anongit.hacktivis.me/git/oasis-root.git

qselect.1p (24458B)


  1. '\" et
  2. .TH QSELECT "1P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual"
  3. .\"
  4. .SH PROLOG
  5. This manual page is part of the POSIX Programmer's Manual.
  6. The Linux implementation of this interface may differ (consult
  7. the corresponding Linux manual page for details of Linux behavior),
  8. or the interface may not be implemented on Linux.
  9. .\"
  10. .SH NAME
  11. qselect
  12. \(em select batch jobs
  13. .SH SYNOPSIS
  14. .LP
  15. .nf
  16. qselect \fB[\fR-a \fB[\fIop\fB]\fIdate_time\fB] [\fR-A \fIaccount_string\fB] [\fR-c \fB[\fIop\fB]\fIinterval\fB]
  17. [\fR-h \fIhold_list\fB] [\fR-l \fIresource_list\fB] [\fR-N \fIname\fB] [\fR-p \fB[\fIop\fB]\fIpriority\fB]
  18. [\fR-q \fIdestination\fB] [\fR-r \fIy\fR|\fIn\fB] [\fR-s \fIstates\fB] [\fR-u \fIuser_list\fB]\fR
  19. .fi
  20. .SH DESCRIPTION
  21. To select a set of batch jobs is to return the batch
  22. .IR job_identifier s
  23. for each batch job that meets a list of selection criteria. A set of
  24. batch jobs is selected by a request to a batch server. The
  25. .IR qselect
  26. utility is a user-accessible batch client that requests the selection
  27. of batch jobs.
  28. .P
  29. Upon successful completion, the
  30. .IR qselect
  31. utility shall have returned a list of zero or more batch
  32. .IR job_identifier s
  33. that meet the criteria specified by the options and option-arguments
  34. presented to the utility.
  35. .P
  36. The
  37. .IR qselect
  38. utility shall select batch jobs by sending a
  39. .IR "Select Jobs Request"
  40. to a batch server. The
  41. .IR qselect
  42. utility shall not exit until the server replies to each request
  43. generated.
  44. .P
  45. For each option presented to the
  46. .IR qselect
  47. utility, the utility shall restrict the set of selected batch jobs as
  48. described in the OPTIONS section.
  49. .P
  50. The
  51. .IR qselect
  52. utility shall not restrict selection of batch jobs except by
  53. authorization and as required by the options presented to the utility.
  54. .P
  55. When an option is specified with a mandatory or optional
  56. .IR op
  57. component to the option-argument, then
  58. .IR op
  59. shall specify a relation between the value of a certain batch job
  60. attribute and the
  61. .IR value
  62. component of the option-argument. If an
  63. .IR op
  64. is allowable on an option, then the description of the option letter
  65. indicates the
  66. .IR op
  67. as either mandatory or optional. Acceptable strings for the
  68. .IR op
  69. component, and the relation the string indicates, are shown in the
  70. following list:
  71. .IP "\fR.eq.\fR" 8
  72. The value represented by the attribute of the batch job is equal to the
  73. value represented by the option-argument.
  74. .IP "\fR.ge.\fR" 8
  75. The value represented by the attribute of the batch job is greater than
  76. or equal to the value represented by the option-argument.
  77. .IP "\fR.gt.\fR" 8
  78. The value represented by the attribute of the batch job is greater than
  79. the value represented by the option-argument.
  80. .IP "\fR.lt.\fR" 8
  81. The value represented by the attribute of the batch job is less than
  82. the value represented by the option-argument.
  83. .IP "\fR.le.\fR" 8
  84. The value represented by the attribute of the batch job is less than or
  85. equal to the value represented by the option-argument.
  86. .IP "\fR.ne.\fR" 8
  87. The value represented by the attribute of the batch job is not equal to
  88. the value represented by the option-argument.
  89. .SH OPTIONS
  90. The
  91. .IR qselect
  92. utility shall conform to the Base Definitions volume of POSIX.1\(hy2017,
  93. .IR "Section 12.2" ", " "Utility Syntax Guidelines".
  94. .P
  95. The following options shall be supported by the implementation:
  96. .IP "\fB\-a\ [\fIop\fB]\fIdate_time\fR" 10
  97. .br
  98. Restrict selection to a specific time, or a range of times.
  99. .RS 10
  100. .P
  101. The
  102. .IR qselect
  103. utility shall select only batch jobs for which the value of the
  104. .IR Execution_Time
  105. attribute is related to the Epoch equivalent of the local time
  106. expressed by the value of the
  107. .IR date_time
  108. component of the option-argument in the manner indicated by the value
  109. of the
  110. .IR op
  111. component of the option-argument.
  112. .P
  113. The
  114. .IR qselect
  115. utility shall accept a
  116. .IR date_time
  117. component of the option-argument that conforms to the syntax of the
  118. .IR time
  119. operand of the
  120. .IR touch
  121. utility.
  122. .P
  123. If the
  124. .IR op
  125. component of the option-argument is not presented to the
  126. .IR qselect
  127. utility, the utility shall select batch jobs for which the
  128. .IR Execution_Time
  129. attribute is equal to the
  130. .IR date_time
  131. component of the option-argument.
  132. .P
  133. When comparing times, the
  134. .IR qselect
  135. utility shall use the following definitions for the
  136. .IR op
  137. component of the option-argument:
  138. .IP "\fR.eq.\fR" 8
  139. The time represented by value of the
  140. .IR Execution_Time
  141. attribute of the batch job is equal to the time represented by the
  142. .IR date_time
  143. component of the option-argument.
  144. .IP "\fR.ge.\fR" 8
  145. The time represented by value of the
  146. .IR Execution_Time
  147. attribute of the batch job is after or equal to the time represented by
  148. the
  149. .IR date_time
  150. component of the option-argument.
  151. .IP "\fR.gt.\fR" 8
  152. The time represented by value of the
  153. .IR Execution_Time
  154. attribute of the batch job is after the time represented by the
  155. .IR date_time
  156. component of the option-argument.
  157. .IP "\fR.lt.\fR" 8
  158. The time represented by value of the
  159. .IR Execution_Time
  160. attribute of the batch job is before the time represented by the
  161. .IR date_time
  162. component of the option-argument.
  163. .IP "\fR.le.\fR" 8
  164. The time represented by value of the
  165. .IR Execution_Time
  166. attribute of the batch job is before or equal to the time represented
  167. by the
  168. .IR date_time
  169. component of the option-argument.
  170. .IP "\fR.ne.\fR" 8
  171. The time represented by value of the
  172. .IR Execution_Time
  173. attribute of the batch job is not equal to the time represented by the
  174. .IR date_time
  175. component of the option-argument.
  176. .P
  177. The
  178. .IR qselect
  179. utility shall accept the defined character strings for the
  180. .IR op
  181. component of the option-argument.
  182. .RE
  183. .IP "\fB\-A\ \fIaccount_string\fR" 10
  184. .br
  185. Restrict selection to the batch jobs charging a specified account.
  186. .RS 10
  187. .P
  188. The
  189. .IR qselect
  190. utility shall select only batch jobs for which the value of the
  191. .IR Account_Name
  192. attribute of the batch job matches the value of the
  193. .IR account_string
  194. option-argument.
  195. .P
  196. The syntax of the
  197. .IR account_string
  198. option-argument is unspecified.
  199. .RE
  200. .IP "\fB\-c\ [\fIop\fB]\fIinterval\fR" 10
  201. .br
  202. Restrict selection to batch jobs within a range of checkpoint
  203. intervals.
  204. .RS 10
  205. .P
  206. The
  207. .IR qselect
  208. utility shall select only batch jobs for which the value of the
  209. .IR Checkpoint
  210. attribute relates to the value of the
  211. .IR interval
  212. component of the option-argument in the manner indicated by the value
  213. of the
  214. .IR op
  215. component of the option-argument.
  216. .P
  217. If the
  218. .IR op
  219. component of the option-argument is omitted, the
  220. .IR qselect
  221. utility shall select batch jobs for which the value of the
  222. .IR Checkpoint
  223. attribute is equal to the value of the
  224. .IR interval
  225. component of the option-argument.
  226. .P
  227. When comparing checkpoint intervals, the
  228. .IR qselect
  229. utility shall use the following definitions for the
  230. .IR op
  231. component of the option-argument:
  232. .IP "\fR.eq.\fR" 8
  233. The value of the
  234. .IR Checkpoint
  235. attribute of the batch job equals the value of the
  236. .IR interval
  237. component of the option-argument.
  238. .IP "\fR.ge.\fR" 8
  239. The value of the
  240. .IR Checkpoint
  241. attribute of the batch job is greater than or equal to the value of the
  242. .IR interval
  243. component option-argument.
  244. .IP "\fR.gt.\fR" 8
  245. The value of the
  246. .IR Checkpoint
  247. attribute of the batch job is greater than the value of the
  248. .IR interval
  249. component option-argument.
  250. .IP "\fR.lt.\fR" 8
  251. The value of the
  252. .IR Checkpoint
  253. attribute of the batch job is less than the value of the
  254. .IR interval
  255. component option-argument.
  256. .IP "\fR.le.\fR" 8
  257. The value of the
  258. .IR Checkpoint
  259. attribute of the batch job is less than or equal to the value of the
  260. .IR interval
  261. component option-argument.
  262. .IP "\fR.ne.\fR" 8
  263. The value of the
  264. .IR Checkpoint
  265. attribute of the batch job does not equal the value of the
  266. .IR interval
  267. component option-argument.
  268. .P
  269. The
  270. .IR qselect
  271. utility shall accept the defined character strings for the
  272. .IR op
  273. component of the option-argument.
  274. .P
  275. The ordering relationship for the values of the interval
  276. option-argument is defined to be:
  277. .sp
  278. .RS 4
  279. .nf
  280. \&`n\(aq .gt. `s\(aq .gt. `c=\fIminutes\fR\(aq .ge. `c\(aq
  281. .fi
  282. .P
  283. .RE
  284. When comparing
  285. .IR Checkpoint
  286. attributes with an interval having the value of the single character
  287. .BR 'u' ,
  288. only equality or inequality are valid comparisons.
  289. .RE
  290. .IP "\fB\-h\ \fIhold_list\fR" 10
  291. Restrict selection to batch jobs that have a specific type of hold.
  292. .RS 10
  293. .P
  294. The
  295. .IR qselect
  296. utility shall select only batch jobs for which the value of the
  297. .IR Hold_Types
  298. attribute matches the value of the
  299. .IR hold_list
  300. option-argument.
  301. .P
  302. The
  303. .IR qselect
  304. .BR \-h
  305. option shall accept a value for the
  306. .IR hold_list
  307. option-argument that is a string of alphanumeric characters in the
  308. portable character set (see the Base Definitions volume of POSIX.1\(hy2017,
  309. .IR "Section 6.1" ", " "Portable Character Set").
  310. .P
  311. The
  312. .IR qselect
  313. utility shall accept a value for the
  314. .IR hold_list
  315. option-argument that is a string of one or more of the characters
  316. .BR 'u' ,
  317. .BR 's' ,
  318. or
  319. .BR 'o' ,
  320. or the single character
  321. .BR 'n' .
  322. .P
  323. Each unique character in the
  324. .IR hold_list
  325. option-argument of the
  326. .IR qselect
  327. utility is defined as follows, each representing a different hold type:
  328. .IP "\fRu\fP" 6
  329. USER
  330. .IP "\fRs\fP" 6
  331. SYSTEM
  332. .IP "\fRo\fP" 6
  333. OPERATOR
  334. .P
  335. If any of these characters are duplicated in the
  336. .IR hold_list
  337. option-argument, the duplicates shall be ignored.
  338. .P
  339. The
  340. .IR qselect
  341. utility shall consider it an error if any hold type other than
  342. .BR 'n'
  343. is combined with hold type
  344. .BR 'n' .
  345. .P
  346. Strictly conforming applications shall not repeat any of the characters
  347. .BR 'u' ,
  348. .BR 's' ,
  349. .BR 'o' ,
  350. or
  351. .BR 'n'
  352. within the
  353. .IR hold_list
  354. option-argument. The
  355. .IR qselect
  356. utility shall permit the repetition of characters, but shall not assign
  357. additional meaning to the repeated characters.
  358. .P
  359. An implementation may define other hold types. The conformance document
  360. for an implementation shall describe any additional hold types, how
  361. they are specified, their internal behavior, and how they affect the
  362. behavior of the utility.
  363. .RE
  364. .IP "\fB\-l\ \fIresource_list\fR" 10
  365. .br
  366. Restrict selection to batch jobs with specified resource limits and
  367. attributes.
  368. .RS 10
  369. .P
  370. The
  371. .IR qselect
  372. utility shall accept a
  373. .IR resource_list
  374. option-argument with the following syntax:
  375. .sp
  376. .RS 4
  377. .nf
  378. \fIresource_name op value \fB[\fR,,\fIresource_name op value\fR,, ...\fB]\fR
  379. .fi
  380. .P
  381. .RE
  382. .P
  383. When comparing resource values, the
  384. .IR qselect
  385. utility shall use the following definitions for the
  386. .IR op
  387. component of the option-argument:
  388. .IP "\fR.eq.\fR" 8
  389. The value of the resource of the same name in the
  390. .IR Resource_List
  391. attribute of the batch job equals the value of the value component of
  392. the option-argument.
  393. .IP "\fR.ge.\fR" 8
  394. The value of the resource of the same name in the
  395. .IR Resource_List
  396. attribute of the batch job is greater than or equal to the value of the
  397. .IR value
  398. component of the option-argument.
  399. .IP "\fR.gt.\fR" 8
  400. The value of the resource of the same name in the
  401. .IR Resource_List
  402. attribute of the batch job is greater than the value of the value
  403. component of the option-argument.
  404. .IP "\fR.lt.\fR" 8
  405. The value of the resource of the same name in the
  406. .IR Resource_List
  407. attribute of the batch job is less than the value of the value
  408. component of the option-argument.
  409. .IP "\fR.ne.\fR" 8
  410. The value of the resource of the same name in the
  411. .IR Resource_List
  412. attribute of the batch job does not equal the value of the value
  413. component of the option-argument.
  414. .IP "\fR.le.\fR" 8
  415. The value of the resource of the same name in the
  416. .IR Resource_List
  417. attribute of the batch job is less than or equal to the value of the
  418. .IR value
  419. component of the option-argument.
  420. .P
  421. When comparing the limit of a
  422. .IR Resource_List
  423. attribute with the
  424. .IR value
  425. component of the option-argument, if the limit, the value, or both are
  426. non-numeric, only equality or inequality are valid comparisons.
  427. .P
  428. The
  429. .IR qselect
  430. utility shall select only batch jobs for which the values of the
  431. .IR resource_name s
  432. listed in the
  433. .IR resource_list
  434. option-argument match the corresponding limits of the
  435. .IR Resource_List
  436. attribute of the batch job.
  437. .P
  438. Limits of
  439. .IR resource_name s
  440. present in the
  441. .IR Resource_List
  442. attribute of the batch job that have no corresponding values in the
  443. .IR resource_list
  444. option-argument shall not be considered when selecting batch jobs.
  445. .RE
  446. .IP "\fB\-N\ \fIname\fR" 10
  447. Restrict selection to batch jobs with a specified name.
  448. .RS 10
  449. .P
  450. The
  451. .IR qselect
  452. utility shall select only batch jobs for which the value of the
  453. .IR Job_Name
  454. attribute matches the value of the
  455. .IR name
  456. option-argument. The string specified in the
  457. .IR name
  458. option-argument shall be passed, uninterpreted, to the server. This
  459. allows an implementation to match ``wildcard'' patterns against batch
  460. job names.
  461. .P
  462. An implementation shall describe in the conformance document the format
  463. it supports for matching against the
  464. .IR Job_Name
  465. attribute.
  466. .RE
  467. .IP "\fB\-p\ [\fIop\fB]\fIpriority\fR" 10
  468. .br
  469. Restrict selection to batch jobs of the specified priority or range of
  470. priorities.
  471. .RS 10
  472. .P
  473. The
  474. .IR qselect
  475. utility shall select only batch jobs for which the value of the
  476. .IR Priority
  477. attribute of the batch job relates to the value of the
  478. .IR priority
  479. component of the option-argument in the manner indicated by the value
  480. of the
  481. .IR op
  482. component of the option-argument.
  483. .P
  484. If the
  485. .IR op
  486. component of the option-argument is omitted, the
  487. .IR qselect
  488. utility shall select batch jobs for which the value of the
  489. .IR Priority
  490. attribute of the batch job is equal to the value of the
  491. .IR priority
  492. component of the option-argument.
  493. .P
  494. When comparing priority values, the
  495. .IR qselect
  496. utility shall use the following definitions for the
  497. .IR op
  498. component of the option-argument:
  499. .IP "\fR.eq.\fR" 8
  500. The value of the
  501. .IR Priority
  502. attribute of the batch job equals the value of the
  503. .IR priority
  504. component of the option-argument.
  505. .IP "\fR.ge.\fR" 8
  506. The value of the
  507. .IR Priority
  508. attribute of the batch job is greater than or equal to the value of the
  509. .IR priority
  510. component option-argument.
  511. .IP "\fR.gt.\fR" 8
  512. The value of the
  513. .IR Priority
  514. attribute of the batch job is greater than the value of the
  515. .IR priority
  516. component option-argument.
  517. .IP "\fR.lt.\fR" 8
  518. The value of the
  519. .IR Priority
  520. attribute of the batch job is less than the value of the
  521. .IR priority
  522. component option-argument.
  523. .IP "\fR.lt.\fR" 8
  524. The value of the
  525. .IR Priority
  526. attribute of the batch job is less than or equal to the value of the
  527. .IR priority
  528. component option-argument.
  529. .IP "\fR.ne.\fR" 8
  530. The value of the
  531. .IR Priority
  532. attribute of the batch job does not equal the value of the
  533. .IR priority
  534. component option-argument.
  535. .RE
  536. .IP "\fB\-q\ \fIdestination\fR" 10
  537. .br
  538. Restrict selection to the specified batch queue or server, or both.
  539. .RS 10
  540. .P
  541. The
  542. .IR qselect
  543. utility shall select only batch jobs that are located at the
  544. destination indicated by the value of the
  545. .IR destination
  546. option-argument.
  547. .P
  548. The destination defines a batch queue, a server, or a batch queue at a
  549. server.
  550. .P
  551. The
  552. .IR qselect
  553. utility shall accept an option-argument for the
  554. .BR \-q
  555. option that conforms to the syntax for a destination. If the
  556. .BR \-q
  557. option is not presented to the
  558. .IR qselect
  559. utility, the utility shall select batch jobs from all batch queues at
  560. the default batch server.
  561. .P
  562. If the option-argument describes only a batch queue, the
  563. .IR qselect
  564. utility shall select only batch jobs from the batch queue of the
  565. specified name at the default batch server. The means by which
  566. .IR qselect
  567. determines the default server is implementation-defined.
  568. .P
  569. If the option-argument describes only a batch server, the
  570. .IR qselect
  571. utility shall select batch jobs from all the batch queues at that batch
  572. server.
  573. .P
  574. If the option-argument describes both a batch queue and a batch server,
  575. the
  576. .IR qselect
  577. utility shall select only batch jobs from the specified batch queue at
  578. the specified server.
  579. .RE
  580. .IP "\fB\-r\ \fRy\fR|\fRn\fR" 10
  581. Restrict selection to batch jobs with the specified rerunability
  582. status.
  583. .RS 10
  584. .P
  585. The
  586. .IR qselect
  587. utility shall select only batch jobs for which the value of the
  588. .IR Rerunable
  589. attribute of the batch job matches the value of the option-argument.
  590. .P
  591. The
  592. .IR qselect
  593. utility shall accept a value for the option-argument that consists of
  594. either the single character
  595. .BR 'y'
  596. or the single character
  597. .BR 'n' .
  598. The character
  599. .BR 'y'
  600. represents the value TRUE, and the character
  601. .BR 'n'
  602. represents the value FALSE.
  603. .RE
  604. .IP "\fB\-s\ \fIstates\fR" 10
  605. Restrict selection to batch jobs in the specified states.
  606. .RS 10
  607. .P
  608. The
  609. .IR qselect
  610. utility shall accept an option-argument that consists of any
  611. combination of the characters
  612. .BR 'e' ,
  613. .BR 'q' ,
  614. .BR 'r' ,
  615. .BR 'w' ,
  616. .BR 'h' ,
  617. and
  618. .BR 't' .
  619. .P
  620. Conforming applications shall not repeat any character in the
  621. option-argument. The
  622. .IR qselect
  623. utility shall permit the repetition of characters in the
  624. option-argument, but shall not assign additional meaning to repeated
  625. characters.
  626. .P
  627. The
  628. .IR qselect
  629. utility shall interpret the characters in the
  630. .IR states
  631. option-argument as follows:
  632. .IP "\fRe\fR" 6
  633. Represents the EXITING state.
  634. .IP "\fRq\fR" 6
  635. Represents the QUEUED state.
  636. .IP "\fRr\fR" 6
  637. Represents the RUNNING state.
  638. .IP "\fRt\fR" 6
  639. Represents the TRANSITING state.
  640. .IP "\fRh\fR" 6
  641. Represents the HELD state.
  642. .IP "\fRw\fR" 6
  643. Represents the WAITING state.
  644. .P
  645. For each character in the
  646. .IR states
  647. option-argument, the
  648. .IR qselect
  649. utility shall select batch jobs in the corresponding state.
  650. .RE
  651. .IP "\fB\-u\ \fIuser_list\fR" 10
  652. Restrict selection to batch jobs owned by the specified user names.
  653. .RS 10
  654. .P
  655. The
  656. .IR qselect
  657. utility shall select only the batch jobs of those users specified in
  658. the
  659. .IR user_list
  660. option-argument.
  661. .P
  662. The
  663. .IR qselect
  664. utility shall accept a
  665. .IR user_list
  666. option-argument that conforms to the following syntax:
  667. .sp
  668. .RS 4
  669. .nf
  670. \fIusername\fB[\fR@\fIhost\fB][\fR,,\fIusername\fB[\fR@\fIhost\fB]\fR,, ...\fB]\fR
  671. .fi
  672. .P
  673. .RE
  674. .P
  675. The
  676. .IR qselect
  677. utility shall accept only one user name that is missing a corresponding
  678. host name. The
  679. .IR qselect
  680. utility shall accept only one user name per named host.
  681. .RE
  682. .SH OPERANDS
  683. None.
  684. .SH STDIN
  685. Not used.
  686. .SH "INPUT FILES"
  687. None.
  688. .SH "ENVIRONMENT VARIABLES"
  689. The following environment variables shall affect the execution of
  690. .IR qselect :
  691. .IP "\fILANG\fP" 10
  692. Provide a default value for the internationalization variables that are
  693. unset or null. (See the Base Definitions volume of POSIX.1\(hy2017,
  694. .IR "Section 8.2" ", " "Internationalization Variables"
  695. the precedence of internationalization variables used to determine the
  696. values of locale categories.)
  697. .IP "\fILC_ALL\fP" 10
  698. If set to a non-empty string value, override the values of all the
  699. other internationalization variables.
  700. .IP "\fILC_CTYPE\fP" 10
  701. Determine the locale for the interpretation of sequences of bytes of
  702. text data as characters (for example, single-byte as opposed to
  703. multi-byte characters in arguments).
  704. .IP "\fILC_MESSAGES\fP" 10
  705. .br
  706. Determine the locale that should be used to affect the format and
  707. contents of diagnostic messages written to standard error.
  708. .IP "\fILOGNAME\fP" 10
  709. Determine the login name of the user.
  710. .IP "\fITZ\fP" 10
  711. Determine the timezone used to interpret the
  712. .IR date-time
  713. option-argument. If
  714. .IR TZ
  715. is unset or null, an unspecified default timezone shall be used.
  716. .SH "ASYNCHRONOUS EVENTS"
  717. Default.
  718. .SH STDOUT
  719. The
  720. .IR qselect
  721. utility shall write zero or more batch
  722. .IR job_identifier s
  723. to standard output.
  724. .P
  725. The
  726. .IR qselect
  727. utility shall separate the batch
  728. .IR job_identifier s
  729. written to standard output by white space.
  730. .P
  731. The
  732. .IR qselect
  733. utility shall write batch
  734. .IR job_identifier s
  735. in the following format:
  736. .sp
  737. .RS 4
  738. .nf
  739. \fIsequence_number.server_name\fR@\fIserver\fR
  740. .fi
  741. .P
  742. .RE
  743. .SH STDERR
  744. The standard error shall be used only for diagnostic messages.
  745. .SH "OUTPUT FILES"
  746. None.
  747. .SH "EXTENDED DESCRIPTION"
  748. None.
  749. .SH "EXIT STATUS"
  750. The following exit values shall be returned:
  751. .IP "\00" 6
  752. Successful completion.
  753. .IP >0 6
  754. An error occurred.
  755. .SH "CONSEQUENCES OF ERRORS"
  756. Default.
  757. .LP
  758. .IR "The following sections are informative."
  759. .SH "APPLICATION USAGE"
  760. None.
  761. .SH EXAMPLES
  762. The following example shows how a user might use the
  763. .IR qselect
  764. utility in conjunction with the
  765. .IR qdel
  766. utility to delete all of his or her jobs in the queued state without
  767. affecting any jobs that are already running:
  768. .sp
  769. .RS 4
  770. .nf
  771. qdel $(qselect -s q)
  772. .fi
  773. .P
  774. .RE
  775. .P
  776. or:
  777. .sp
  778. .RS 4
  779. .nf
  780. qselect -s q || xargs qdel
  781. .fi
  782. .P
  783. .RE
  784. .SH RATIONALE
  785. The
  786. .IR qselect
  787. utility allows users to acquire a list of job identifiers that match
  788. user-specified selection criteria. The list of identifiers returned by
  789. the
  790. .IR qselect
  791. utility conforms to the syntax of the batch job identifier list
  792. processed by a utility such as
  793. .IR qmove ,
  794. .IR qdel ,
  795. and
  796. .IR qrls .
  797. The
  798. .IR qselect
  799. utility is thus a powerful tool for causing another batch system
  800. utility to act upon a set of jobs that match a list of selection
  801. criteria.
  802. .P
  803. The options of the
  804. .IR qselect
  805. utility let the user apply a number of useful filters for selecting
  806. jobs. Each option further restricts the selection of jobs. Many of the
  807. selection options allow the specification of a relational operator. The
  808. FORTRAN-like syntax of the operator\(emthat is,
  809. .BR \(dq.lt.\(dq \(em\c
  810. was chosen rather than the C-like
  811. .BR \(dq<=\(dq
  812. meta-characters.
  813. .P
  814. The
  815. .BR \-a
  816. option allows users to restrict the selected jobs to those that have
  817. been submitted (or altered) to wait until a particular time. The time
  818. period is determined by the argument of this option, which includes
  819. both a time and an operator\(emit is thus possible to select jobs
  820. waiting until a specific time, jobs waiting until after a certain time,
  821. or those waiting for a time before the specified time.
  822. .P
  823. The
  824. .BR \-A
  825. option allows users to restrict the selected jobs to those that have
  826. been submitted (or altered) to charge a particular account.
  827. .P
  828. The
  829. .BR \-c
  830. option allows users to restrict the selected jobs to those whose
  831. checkpointing interval falls within the specified range.
  832. .P
  833. The
  834. .BR \-l
  835. option allows users to select those jobs whose resource limits fall
  836. within the range indicated by the value of the option. For example, a
  837. user could select those jobs for which the CPU time limit is greater
  838. than two hours.
  839. .P
  840. The
  841. .BR \-N
  842. option allows users to select jobs by job name. For instance, all the
  843. parts of a task that have been divided in parallel jobs might be given
  844. the same name, and thus manipulated as a group by means of this
  845. option.
  846. .P
  847. The
  848. .BR \-q
  849. option allows users to select jobs in a specified queue.
  850. .P
  851. The
  852. .BR \-r
  853. option allows users to select only those jobs with a specified rerun
  854. criteria. For instance, a user might select only those jobs that can be
  855. rerun for use with the
  856. .IR qrerun
  857. utility.
  858. .P
  859. The
  860. .BR \-s
  861. option allows users to select only those jobs that are in a certain
  862. state.
  863. .P
  864. The
  865. .BR \-u
  866. option allows users to select jobs that have been submitted to execute
  867. under a particular account.
  868. .P
  869. The selection criteria provided by the options of the
  870. .IR qselect
  871. utility allow users to select jobs based on all the appropriate
  872. attributes that can be assigned to jobs by the
  873. .IR qsub
  874. utility.
  875. .P
  876. Historically, the
  877. .IR qselect
  878. utility has not been a part of existing practice; it is an improvement
  879. that has been introduced in this volume of POSIX.1\(hy2017.
  880. .SH "FUTURE DIRECTIONS"
  881. The
  882. .IR qselect
  883. utility may be removed in a future version.
  884. .SH "SEE ALSO"
  885. .IR "Chapter 3" ", " "Batch Environment Services",
  886. .IR "\fIqdel\fR\^",
  887. .IR "\fIqrerun\fR\^",
  888. .IR "\fIqrls\fR\^",
  889. .IR "\fIqselect\fR\^",
  890. .IR "\fIqsub\fR\^",
  891. .IR "\fItouch\fR\^"
  892. .P
  893. The Base Definitions volume of POSIX.1\(hy2017,
  894. .IR "Section 6.1" ", " "Portable Character Set",
  895. .IR "Chapter 8" ", " "Environment Variables",
  896. .IR "Section 12.2" ", " "Utility Syntax Guidelines"
  897. .\"
  898. .SH COPYRIGHT
  899. Portions of this text are reprinted and reproduced in electronic form
  900. from IEEE Std 1003.1-2017, Standard for Information Technology
  901. -- Portable Operating System Interface (POSIX), The Open Group Base
  902. Specifications Issue 7, 2018 Edition,
  903. Copyright (C) 2018 by the Institute of
  904. Electrical and Electronics Engineers, Inc and The Open Group.
  905. In the event of any discrepancy between this version and the original IEEE and
  906. The Open Group Standard, the original IEEE and The Open Group Standard
  907. is the referee document. The original Standard can be obtained online at
  908. http://www.opengroup.org/unix/online.html .
  909. .PP
  910. Any typographical or formatting errors that appear
  911. in this page are most likely
  912. to have been introduced during the conversion of the source files to
  913. man page format. To report such errors, see
  914. https://www.kernel.org/doc/man-pages/reporting_bugs.html .