1QRLS(P) POSIX Programmer's Manual QRLS(P)
2
3
4
6 qrls - release batch jobs
7
9 qrls [-h hold_list] job_identifier ...
10
12 A batch job might have one or more holds, which prevent the batch job
13 from executing. A batch job from which all the holds have been removed
14 becomes eligible for execution and is said to have been released. A
15 batch job hold is removed by sending a request to the batch server that
16 manages the batch job. The qrls utility is a user-accessible client of
17 batch services that requests holds be removed from one or more batch
18 jobs.
19
20 The qrls utility shall remove one or more holds from those batch jobs
21 for which a batch job_identifier is presented to the utility.
22
23 The qrls utility shall remove holds from batch jobs in the order in
24 which their batch job_identifiers are presented to the utility.
25
26 If the qrls utility fails to process a batch job_identifier success‐
27 fully, the utility shall proceed to process the remaining batch
28 job_identifiers, if any.
29
30 The qrls utility shall remove holds on each batch job by sending a
31 Release Job Request to the batch server that manages the batch job.
32
33 The qrls utility shall not exit until the holds have been removed from
34 the batch job corresponding to each successfully processed batch
35 job_identifier.
36
38 The qrls utility shall conform to the Base Definitions volume of
39 IEEE Std 1003.1-2001, Section 12.2, Utility Syntax Guidelines.
40
41 The following option shall be supported by the implementation:
42
43 -h hold_list
44 Define the types of holds to be removed from the batch job.
45
46 The qrls -h option shall accept a value for the hold_list option-argu‐
47 ment that is a string of alphanumeric characters in the portable char‐
48 acter set (see the Base Definitions volume of IEEE Std 1003.1-2001,
49 Section 6.1, Portable Character Set).
50
51 The qrls utility shall accept a value for the hold_list option-argument
52 that is a string of one or more of the characters 'u' , 's' , or 'o' ,
53 or the single character 'n' .
54
55 For each unique character in the hold_list option-argument, the qrls
56 utility shall add a value to the Hold_Types attribute of the batch job
57 as follows, each representing a different hold type:
58
59 u
60 USER
61
62 s
63 SYSTEM
64
65 o
66 OPERATOR
67
68
69 If any of these characters are duplicated in the hold_list option-argu‐
70 ment, the duplicates shall be ignored.
71
72 An existing Hold_Types attribute can be cleared by the following hold
73 type:
74
75 n
76 NO_HOLD
77
78
79 The qrls utility shall consider it an error if any hold type other than
80 'n' is combined with hold type 'n' .
81
82 Strictly conforming applications shall not repeat any of the characters
83 'u' , 's' , 'o' , or 'n' within the hold_list option-argument. The qrls
84 utility shall permit the repetition of characters, but shall not assign
85 additional meaning to the repeated characters.
86
87 An implementation may define other hold types. The conformance document
88 for an implementation shall describe any additional hold types, how
89 they are specified, their internal behavior, and how they affect the
90 behavior of the utility.
91
92 If the -h option is not presented to the qrls utility, the implementa‐
93 tion shall remove the USER hold in the Hold_Types attribute.
94
95
97 The qrls utility shall accept one or more operands that conform to the
98 syntax for a batch job_identifier (see Batch Job Identifier ).
99
101 Not used.
102
104 None.
105
107 The following environment variables shall affect the execution of qrls:
108
109 LANG Provide a default value for the internationalization variables
110 that are unset or null. (See the Base Definitions volume of
111 IEEE Std 1003.1-2001, Section 8.2, Internationalization Vari‐
112 ables for the precedence of internationalization variables used
113 to determine the values of locale categories.)
114
115 LC_ALL If set to a non-empty string value, override the values of all
116 the other internationalization variables.
117
118 LC_CTYPE
119 Determine the locale for the interpretation of sequences of
120 bytes of text data as characters (for example, single-byte as
121 opposed to multi-byte characters in arguments).
122
123 LC_MESSAGES
124 Determine the locale that should be used to affect the format
125 and contents of diagnostic messages written to standard error.
126
127 LOGNAME
128 Determine the login name of the user.
129
130
132 Default.
133
135 None.
136
138 The standard error shall be used only for diagnostic messages.
139
141 None.
142
144 None.
145
147 The following exit values shall be returned:
148
149 0 Successful completion.
150
151 >0 An error occurred.
152
153
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
165 None.
166
168 None.
169
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 IEEE Std 1003.1-2001 as the natural com‐
191 plement to the qhold utility.
192
194 None.
195
197 Batch Environment Services , qhold , qselect
198
200 Portions of this text are reprinted and reproduced in electronic form
201 from IEEE Std 1003.1, 2003 Edition, Standard for Information Technology
202 -- Portable Operating System Interface (POSIX), The Open Group Base
203 Specifications Issue 6, Copyright (C) 2001-2003 by the Institute of
204 Electrical and Electronics Engineers, Inc and The Open Group. In the
205 event of any discrepancy between this version and the original IEEE and
206 The Open Group Standard, the original IEEE and The Open Group Standard
207 is the referee document. The original Standard can be obtained online
208 at http://www.opengroup.org/unix/online.html .
209
210
211
212IEEE/The Open Group 2003 QRLS(P)