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

NAME

6       qrls - release batch jobs
7

SYNOPSIS

9       qrls [-h hold_list] job_identifier ...
10

DESCRIPTION

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

OPTIONS

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

OPERANDS

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

STDIN

101       Not used.
102

INPUT FILES

104       None.
105

ENVIRONMENT VARIABLES

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

ASYNCHRONOUS EVENTS

132       Default.
133

STDOUT

135       None.
136

STDERR

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

OUTPUT FILES

141       None.
142

EXTENDED DESCRIPTION

144       None.
145

EXIT STATUS

147       The following exit values shall be returned:
148
149        0     Successful completion.
150
151       >0     An error occurred.
152
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 IEEE Std 1003.1-2001 as the natural com‐
191       plement to the qhold utility.
192

FUTURE DIRECTIONS

194       None.
195

SEE ALSO

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)
Impressum