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

qmove.1p (5599B)


  1. '\" et
  2. .TH QMOVE "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. qmove
  12. \(em move batch jobs
  13. .SH SYNOPSIS
  14. .LP
  15. .nf
  16. qmove \fIdestination job_identifier\fP...
  17. .fi
  18. .SH DESCRIPTION
  19. To move a batch job is to remove the batch job from the batch queue in
  20. which it resides and instantiate the batch job in another batch queue.
  21. A batch job is moved by a request to the batch server that manages the
  22. batch job. The
  23. .IR qmove
  24. utility is a user-accessible batch client that requests the movement of
  25. one or more batch jobs.
  26. .P
  27. The
  28. .IR qmove
  29. utility shall move those batch jobs, and only those batch jobs, for
  30. which a batch
  31. .IR job_identifier
  32. is presented to the utility.
  33. .P
  34. The
  35. .IR qmove
  36. utility shall move batch jobs in the order in which the corresponding
  37. batch
  38. .IR job_identifier s
  39. are presented to the utility.
  40. .P
  41. If the
  42. .IR qmove
  43. utility fails to process a batch
  44. .IR job_identifier
  45. successfully, the utility shall proceed to process the remaining batch
  46. .IR job_identifier s,
  47. if any.
  48. .P
  49. The
  50. .IR qmove
  51. utility shall move batch jobs by sending a
  52. .IR "Move Job Request"
  53. to the batch server that manages each batch job. The
  54. .IR qmove
  55. utility shall not exit before the batch jobs corresponding to all
  56. successfully processed batch
  57. .IR job_identifier s
  58. have been moved.
  59. .SH OPTIONS
  60. None.
  61. .SH OPERANDS
  62. The
  63. .IR qmove
  64. utility shall accept one operand that conforms to the syntax for a
  65. destination (see
  66. .IR "Section 3.3.2" ", " "Destination").
  67. .P
  68. The
  69. .IR qmove
  70. utility shall accept one or more operands that conform to the syntax
  71. for a batch
  72. .IR job_identifier
  73. (see
  74. .IR "Section 3.3.1" ", " "Batch Job Identifier").
  75. .SH STDIN
  76. Not used.
  77. .SH "INPUT FILES"
  78. None.
  79. .SH "ENVIRONMENT VARIABLES"
  80. The following environment variables shall affect the execution of
  81. .IR qmove :
  82. .IP "\fILANG\fP" 10
  83. Provide a default value for the internationalization variables that are
  84. unset or null. (See the Base Definitions volume of POSIX.1\(hy2017,
  85. .IR "Section 8.2" ", " "Internationalization Variables"
  86. the precedence of internationalization variables used to determine the
  87. values of locale categories.)
  88. .IP "\fILC_ALL\fP" 10
  89. If set to a non-empty string value, override the values of all the
  90. other internationalization variables.
  91. .IP "\fILC_CTYPE\fP" 10
  92. Determine the locale for the interpretation of sequences of bytes of
  93. text data as characters (for example, single-byte as opposed to
  94. multi-byte characters in arguments).
  95. .IP "\fILC_MESSAGES\fP" 10
  96. .br
  97. Determine the locale that should be used to affect the format and
  98. contents of diagnostic messages written to standard error.
  99. .IP "\fILOGNAME\fP" 10
  100. Determine the login name of the user.
  101. .SH "ASYNCHRONOUS EVENTS"
  102. Default.
  103. .SH STDOUT
  104. None.
  105. .SH STDERR
  106. The standard error shall be used only for diagnostic messages.
  107. .SH "OUTPUT FILES"
  108. None.
  109. .SH "EXTENDED DESCRIPTION"
  110. None.
  111. .SH "EXIT STATUS"
  112. The following exit values shall be returned:
  113. .IP "\00" 6
  114. Successful completion.
  115. .IP >0 6
  116. An error occurred.
  117. .SH "CONSEQUENCES OF ERRORS"
  118. In addition to the default behavior, the
  119. .IR qmove
  120. utility shall not be required to write a diagnostic message to standard
  121. error when the error reply received from a batch server indicates that
  122. the batch
  123. .IR job_identifier
  124. does not exist on the server. Whether or not the
  125. .IR qmove
  126. utility waits to output the diagnostic message while attempting to
  127. locate the job on other servers is implementation-defined.
  128. .LP
  129. .IR "The following sections are informative."
  130. .SH "APPLICATION USAGE"
  131. None.
  132. .SH EXAMPLES
  133. None.
  134. .SH RATIONALE
  135. The
  136. .IR qmove
  137. utility allows users to move jobs between queues.
  138. .P
  139. The alternative to using the
  140. .IR qmove
  141. utility\(emdeleting the batch job and requeuing it\(ementails
  142. considerably more typing.
  143. .P
  144. Since the means of selecting jobs based on attributes has been
  145. encapsulated in the
  146. .IR qselect
  147. utility, the only option of the
  148. .IR qmove
  149. utility concerns authorization. The
  150. .BR \-u
  151. option provides the user with the convenience of changing the user
  152. identifier under which the batch job will execute. Minimalism and
  153. consistency have taken precedence over convenience; the
  154. .BR \-u
  155. option has been deleted because the equivalent capability exists with
  156. the
  157. .BR \-u
  158. option of the
  159. .IR qalter
  160. utility.
  161. .SH "FUTURE DIRECTIONS"
  162. The
  163. .IR qmove
  164. utility may be removed in a future version.
  165. .SH "SEE ALSO"
  166. .IR "Chapter 3" ", " "Batch Environment Services",
  167. .IR "\fIqalter\fR\^",
  168. .IR "\fIqselect\fR\^"
  169. .P
  170. The Base Definitions volume of POSIX.1\(hy2017,
  171. .IR "Chapter 8" ", " "Environment Variables"
  172. .\"
  173. .SH COPYRIGHT
  174. Portions of this text are reprinted and reproduced in electronic form
  175. from IEEE Std 1003.1-2017, Standard for Information Technology
  176. -- Portable Operating System Interface (POSIX), The Open Group Base
  177. Specifications Issue 7, 2018 Edition,
  178. Copyright (C) 2018 by the Institute of
  179. Electrical and Electronics Engineers, Inc and The Open Group.
  180. In the event of any discrepancy between this version and the original IEEE and
  181. The Open Group Standard, the original IEEE and The Open Group Standard
  182. is the referee document. The original Standard can be obtained online at
  183. http://www.opengroup.org/unix/online.html .
  184. .PP
  185. Any typographical or formatting errors that appear
  186. in this page are most likely
  187. to have been introduced during the conversion of the source files to
  188. man page format. To report such errors, see
  189. https://www.kernel.org/doc/man-pages/reporting_bugs.html .