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

qrerun.1p (5018B)


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