1QRLS(1P)                   POSIX Programmer's Manual                  QRLS(1P)
2
3
4

PROLOG

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

NAME

12       qrls — release batch jobs
13

SYNOPSIS

15       qrls [-h hold_list] job_identifier...
16

DESCRIPTION

18       A batch job might have one or more holds, which prevent the  batch  job
19       from  executing. A batch job from which all the holds have been removed
20       becomes eligible for execution and is said to  have  been  released.  A
21       batch job hold is removed by sending a request to the batch server that
22       manages the batch job. The qrls utility is a user-accessible client  of
23       batch  services  that  requests holds be removed from one or more batch
24       jobs.
25
26       The qrls utility shall remove one or more holds from those  batch  jobs
27       for which a batch job_identifier is presented to the utility.
28
29       The  qrls  utility  shall  remove holds from batch jobs in the order in
30       which their batch job_identifiers are presented to the utility.
31
32       If the qrls utility fails to process a  batch  job_identifier  success‐
33       fully,  the  utility  shall  proceed  to  process  the  remaining batch
34       job_identifiers, if any.
35
36       The qrls utility shall remove holds on each  batch  job  by  sending  a
37       Release Job Request to the batch server that manages the batch job.
38
39       The  qrls utility shall not exit until the holds have been removed from
40       the batch  job  corresponding  to  each  successfully  processed  batch
41       job_identifier.
42

OPTIONS

44       The  qrls  utility  shall  conform  to  the  Base Definitions volume of
45       POSIX.1‐2017, Section 12.2, Utility Syntax Guidelines.
46
47       The following option shall be supported by the implementation:
48
49       -h hold_list
50                 Define the types of holds to be removed from the batch job.
51
52                 The qrls -h option shall accept a  value  for  the  hold_list
53                 option-argument  that  is a string of alphanumeric characters
54                 in the portable character set (see the Base Definitions  vol‐
55                 ume of POSIX.1‐2017, Section 6.1, Portable Character Set).
56
57                 The  qrls  utility  shall  accept  a  value for the hold_list
58                 option-argument that is a string of one or more of the  char‐
59                 acters 'u', 's', or 'o', or the single character 'n'.
60
61                 For  each  unique character in the hold_list option-argument,
62                 the  qrls  utility  shall  add  a  value  to  the  Hold_Types
63                 attribute  of  the  batch job as follows, each representing a
64                 different hold type:
65
66                 u     USER
67
68                 s     SYSTEM
69
70                 o     OPERATOR
71
72                 If any of these characters are duplicated  in  the  hold_list
73                 option-argument, the duplicates shall be ignored.
74
75                 An  existing  Hold_Types attribute can be cleared by the fol‐
76                 lowing hold type:
77
78                 n     NO_HOLD
79
80                 The qrls utility shall consider it an error if any hold  type
81                 other than 'n' is combined with hold type 'n'.
82
83                 Strictly  conforming applications shall not repeat any of the
84                 characters 'u', 's', 'o', or 'n' within the hold_list option-
85                 argument.  The  qrls  utility  shall permit the repetition of
86                 characters, but shall not assign additional  meaning  to  the
87                 repeated characters.
88
89                 An  implementation  may  define other hold types. The confor‐
90                 mance document for an implementation shall describe any addi‐
91                 tional  hold  types,  how  they are specified, their internal
92                 behavior, and how they affect the behavior of the utility.
93
94                 If the -h option is not presented to the  qrls  utility,  the
95                 implementation  shall  remove the USER hold in the Hold_Types
96                 attribute.
97

OPERANDS

99       The qrls utility shall accept one or more operands that conform to  the
100       syntax for a batch job_identifier (see Section 3.3.1, Batch Job Identi‐
101       fier).
102

STDIN

104       Not used.
105

INPUT FILES

107       None.
108

ENVIRONMENT VARIABLES

110       The following environment variables shall affect the execution of qrls:
111
112       LANG      Provide a default value for  the  internationalization  vari‐
113                 ables  that are unset or null. (See the Base Definitions vol‐
114                 ume of POSIX.1‐2017, Section 8.2, Internationalization  Vari‐
115                 ables  the  precedence of internationalization variables used
116                 to determine the values of locale categories.)
117
118       LC_ALL    If set to a non-empty string value, override  the  values  of
119                 all the other internationalization variables.
120
121       LC_CTYPE  Determine  the  locale for the interpretation of sequences of
122                 bytes of text data as characters (for example, single-byte as
123                 opposed to multi-byte characters in arguments).
124
125       LC_MESSAGES
126                 Determine the locale that should be used to affect the format
127                 and contents  of  diagnostic  messages  written  to  standard
128                 error.
129
130       LOGNAME   Determine the login name of the user.
131

ASYNCHRONOUS EVENTS

133       Default.
134

STDOUT

136       None.
137

STDERR

139       The standard error shall be used only for diagnostic messages.
140

OUTPUT FILES

142       None.
143

EXTENDED DESCRIPTION

145       None.
146

EXIT STATUS

148       The following exit values shall be returned:
149
150        0    Successful completion.
151
152       >0    An error occurred.
153

CONSEQUENCES OF ERRORS

155       In  addition  to  the  default  behavior, the qrls utility shall not be
156       required to write a diagnostic message to standard error when the error
157       reply received from a batch server indicates that the batch job_identi‐
158       fier does not exist on the server. Whether  or  not  the  qrls  utility
159       waits  to  output the diagnostic message while attempting to locate the
160       job on other servers is implementation-defined.
161
162       The following sections are informative.
163

APPLICATION USAGE

165       None.
166

EXAMPLES

168       None.
169

RATIONALE

171       The qrls utility allows users, operators, and administrators to  remove
172       holds from jobs.
173
174       The qrls utility does not support any job selection options or wildcard
175       arguments. Users may acquire a list  of  jobs  selected  by  attributes
176       using  the  qselect  utility.  For  example, a user could select all of
177       their held jobs.
178
179       The -h option allows the user to specify the type of hold that is to be
180       removed. This option allows for USER, SYSTEM, OPERATOR, and implementa‐
181       tion-defined hold types. The batch server that manages  the  batch  job
182       will verify whether the user is authorized to remove the specified hold
183       for the batch job. If more than one type of hold has been placed on the
184       batch job, a user may wish to remove only some of them.
185
186       Mail is not required on release because the administrator has the tools
187       and libraries to build this option if required.
188
189       The qrls utility is a new utility vis-a-vis existing practice;  it  has
190       been  defined  in this volume of POSIX.1‐2017 as the natural complement
191       to the qhold utility.
192

FUTURE DIRECTIONS

194       The qrls utility may be removed in a future version.
195

SEE ALSO

197       Chapter 3, Batch Environment Services, qhold, qselect
198
199       The Base Definitions volume  of  POSIX.1‐2017,  Section  6.1,  Portable
200       Character  Set, Chapter 8, Environment Variables, Section 12.2, Utility
201       Syntax Guidelines
202
204       Portions of this text are reprinted and reproduced in  electronic  form
205       from  IEEE Std 1003.1-2017, Standard for Information Technology -- Por‐
206       table Operating System Interface (POSIX), The Open Group Base  Specifi‐
207       cations  Issue  7, 2018 Edition, Copyright (C) 2018 by the Institute of
208       Electrical and Electronics Engineers, Inc and The Open Group.   In  the
209       event of any discrepancy between this version and the original IEEE and
210       The Open Group Standard, the original IEEE and The Open Group  Standard
211       is  the  referee document. The original Standard can be obtained online
212       at http://www.opengroup.org/unix/online.html .
213
214       Any typographical or formatting errors that appear  in  this  page  are
215       most likely to have been introduced during the conversion of the source
216       files to man page format. To report such errors,  see  https://www.ker
217       nel.org/doc/man-pages/reporting_bugs.html .
218
219
220
221IEEE/The Open Group                  2017                             QRLS(1P)
Impressum