1QRLS(1P) POSIX Programmer's Manual QRLS(1P)
2
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
12 qrls - release batch jobs
13
15 qrls [-h hold_list] job_identifier ...
16
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 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 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 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 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 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
44 The qrls utility shall conform to the Base Definitions volume of
45 IEEE Std 1003.1-2001, Section 12.2, Utility Syntax Guidelines.
46 The following option shall be supported by the implementation:
48 -h hold_list
50 Define the types of holds to be removed from the batch job.
51 The qrls -h option shall accept a value for the hold_list option-argu‐
53 ment that is a string of alphanumeric characters in the portable char‐
54 acter set (see the Base Definitions volume of IEEE Std 1003.1-2001,
55 Section 6.1, Portable Character Set).
56 The qrls utility shall accept a value for the hold_list option-argument
58 that is a string of one or more of the characters 'u', 's', or 'o', or
59 the single character 'n' .
60 For each unique character in the hold_list option-argument, the qrls
62 utility shall add a value to the Hold_Types attribute of the batch job
63 as follows, each representing a different hold type:
64 u
66 USER
67 s
69 SYSTEM
70 o
72 OPERATOR
73 If any of these characters are duplicated in the hold_list option-argu‐
76 ment, the duplicates shall be ignored.
77 An existing Hold_Types attribute can be cleared by the following hold
79 type:
80 n
82 NO_HOLD
83 The qrls utility shall consider it an error if any hold type other than
86 'n' is combined with hold type 'n' .
87 Strictly conforming applications shall not repeat any of the characters
89 'u', 's', 'o', or 'n' within the hold_list option-argument. The qrls
90 utility shall permit the repetition of characters, but shall not assign
91 additional meaning to the repeated characters.
92 An implementation may define other hold types. The conformance document
94 for an implementation shall describe any additional hold types, how
95 they are specified, their internal behavior, and how they affect the
96 behavior of the utility.
97 If the -h option is not presented to the qrls utility, the implementa‐
99 tion shall remove the USER hold in the Hold_Types attribute.
100
103 The qrls utility shall accept one or more operands that conform to the
104 syntax for a batch job_identifier (see Batch Job Identifier ).
105
107 Not used.
108
110 None.
111
113 The following environment variables shall affect the execution of qrls:
114 LANG Provide a default value for the internationalization variables
116 that are unset or null. (See the Base Definitions volume of
117 IEEE Std 1003.1-2001, Section 8.2, Internationalization Vari‐
118 ables for the precedence of internationalization variables used
119 to determine the values of locale categories.)
120 LC_ALL If set to a non-empty string value, override the values of all
122 the other internationalization variables.
123 LC_CTYPE
125 Determine the locale for the interpretation of sequences of
126 bytes of text data as characters (for example, single-byte as
127 opposed to multi-byte characters in arguments).
128 LC_MESSAGES
130 Determine the locale that should be used to affect the format
131 and contents of diagnostic messages written to standard error.
132 LOGNAME
134 Determine the login name of the user.
135
138 Default.
139
141 None.
142
144 The standard error shall be used only for diagnostic messages.
145
147 None.
148
150 None.
151
153 The following exit values shall be returned:
154 0 Successful completion.
156 >0 An error occurred.
158
161 In addition to the default behavior, the qrls utility shall not be
162 required to write a diagnostic message to standard error when the error
163 reply received from a batch server indicates that the batch job_identi‐
164 fier does not exist on the server. Whether or not the qrls utility
165 waits to output the diagnostic message while attempting to locate the
166 job on other servers is implementation-defined.
167 The following sections are informative.
169
171 None.
172
174 None.
175
177 The qrls utility allows users, operators, and administrators to remove
178 holds from jobs.
179 The qrls utility does not support any job selection options or wildcard
181 arguments. Users may acquire a list of jobs selected by attributes
182 using the qselect utility. For example, a user could select all of
183 their held jobs.
184 The -h option allows the user to specify the type of hold that is to be
186 removed. This option allows for USER, SYSTEM, OPERATOR, and implementa‐
187 tion-defined hold types. The batch server that manages the batch job
188 will verify whether the user is authorized to remove the specified hold
189 for the batch job. If more than one type of hold has been placed on the
190 batch job, a user may wish to remove only some of them.
191 Mail is not required on release because the administrator has the tools
193 and libraries to build this option if required.
194 The qrls utility is a new utility vis-a-vis existing practice; it has
196 been defined in this volume of IEEE Std 1003.1-2001 as the natural com‐
197 plement to the qhold utility.
198
200 None.
201
203 Batch Environment Services, qhold, qselect
204
206 Portions of this text are reprinted and reproduced in electronic form
207 from IEEE Std 1003.1, 2003 Edition, Standard for Information Technology
208 -- Portable Operating System Interface (POSIX), The Open Group Base
209 Specifications Issue 6, Copyright (C) 2001-2003 by the Institute of
210 Electrical and Electronics Engineers, Inc and The Open Group. In the
211 event of any discrepancy between this version and the original IEEE and
212 The Open Group Standard, the original IEEE and The Open Group Standard
213 is the referee document. The original Standard can be obtained online
214 at http://www.opengroup.org/unix/online.html .
215IEEE/The Open Group 2003 QRLS(1P)