1QMOVE(1P)                  POSIX Programmer's Manual                 QMOVE(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
11

NAME

13       qmove — move batch jobs
14

SYNOPSIS

16       qmove destination job_identifier...
17

DESCRIPTION

19       To move a batch job is to remove the batch job from the batch queue  in
20       which  it resides and instantiate the batch job in another batch queue.
21       A batch job is moved by a request to the batch server that manages  the
22       batch  job.  The  qmove  utility is a user-accessible batch client that
23       requests the movement of one or more batch jobs.
24
25       The qmove utility shall move those batch jobs,  and  only  those  batch
26       jobs, for which a batch job_identifier is presented to the utility.
27
28       The  qmove utility shall move batch jobs in the order in which the cor‐
29       responding batch job_identifiers are presented to the utility.
30
31       If the qmove utility fails to process a batch  job_identifier  success‐
32       fully,  the  utility  shall  proceed  to  process  the  remaining batch
33       job_identifiers, if any.
34
35       The qmove utility shall move batch jobs by sending a Move  Job  Request
36       to  the  batch  server  that  manages each batch job. The qmove utility
37       shall not exit before the batch jobs corresponding to all  successfully
38       processed batch job_identifiers have been moved.
39

OPTIONS

41       None.
42

OPERANDS

44       The  qmove utility shall accept one operand that conforms to the syntax
45       for a destination (see Section 3.3.2, Destination).
46
47       The qmove utility shall accept one or more operands that conform to the
48       syntax for a batch job_identifier (see Section 3.3.1, Batch Job Identi‐
49       fier).
50

STDIN

52       Not used.
53

INPUT FILES

55       None.
56

ENVIRONMENT VARIABLES

58       The following environment  variables  shall  affect  the  execution  of
59       qmove:
60
61       LANG      Provide  a  default  value for the internationalization vari‐
62                 ables that are unset or null. (See the Base Definitions  vol‐
63                 ume  of POSIX.1‐2008, Section 8.2, Internationalization Vari‐
64                 ables the precedence of internationalization  variables  used
65                 to determine the values of locale categories.)
66
67       LC_ALL    If  set  to  a non-empty string value, override the values of
68                 all the other internationalization variables.
69
70       LC_CTYPE  Determine the locale for the interpretation of  sequences  of
71                 bytes of text data as characters (for example, single-byte as
72                 opposed to multi-byte characters in arguments).
73
74       LC_MESSAGES
75                 Determine the locale that should be used to affect the format
76                 and  contents  of  diagnostic  messages  written  to standard
77                 error.
78
79       LOGNAME   Determine the login name of the user.
80

ASYNCHRONOUS EVENTS

82       Default.
83

STDOUT

85       None.
86

STDERR

88       The standard error shall be used only for diagnostic messages.
89

OUTPUT FILES

91       None.
92

EXTENDED DESCRIPTION

94       None.
95

EXIT STATUS

97       The following exit values shall be returned:
98
99        0    Successful completion.
100
101       >0    An error occurred.
102

CONSEQUENCES OF ERRORS

104       In addition to the default behavior, the qmove  utility  shall  not  be
105       required to write a diagnostic message to standard error when the error
106       reply received from a batch server indicates that the batch job_identi‐
107       fier  does  not  exist  on the server. Whether or not the qmove utility
108       waits to output the diagnostic message while attempting to  locate  the
109       job on other servers is implementation-defined.
110
111       The following sections are informative.
112

APPLICATION USAGE

114       None.
115

EXAMPLES

117       None.
118

RATIONALE

120       The qmove utility allows users to move jobs between queues.
121
122       The  alternative  to using the qmove utility—deleting the batch job and
123       requeuing it—entails considerably more typing.
124
125       Since the means of selecting jobs based on attributes has been encapsu‐
126       lated in the qselect utility, the only option of the qmove utility con‐
127       cerns authorization. The −u option provides the user  with  the  conve‐
128       nience  of  changing the user identifier under which the batch job will
129       execute. Minimalism and consistency have taken precedence  over  conve‐
130       nience;  the −u option has been deleted because the equivalent capabil‐
131       ity exists with the −u option of the qalter utility.
132

FUTURE DIRECTIONS

134       The qmove utility may be removed in a future version.
135

SEE ALSO

137       Chapter 3, Batch Environment Services, qalter, qselect
138
139       The Base Definitions volume of  POSIX.1‐2008,  Chapter  8,  Environment
140       Variables
141
143       Portions  of  this text are reprinted and reproduced in electronic form
144       from IEEE Std 1003.1, 2013 Edition, Standard for Information Technology
145       --  Portable  Operating  System  Interface (POSIX), The Open Group Base
146       Specifications Issue 7, Copyright (C) 2013 by the Institute of Electri‐
147       cal  and  Electronics  Engineers,  Inc  and  The  Open Group.  (This is
148       POSIX.1-2008 with the 2013 Technical Corrigendum  1  applied.)  In  the
149       event of any discrepancy between this version and the original IEEE and
150       The Open Group Standard, the original IEEE and The Open Group  Standard
151       is  the  referee document. The original Standard can be obtained online
152       at http://www.unix.org/online.html .
153
154       Any typographical or formatting errors that appear  in  this  page  are
155       most likely to have been introduced during the conversion of the source
156       files to man page format. To report such errors,  see  https://www.ker
157       nel.org/doc/man-pages/reporting_bugs.html .
158
159
160
161IEEE/The Open Group                  2013                            QMOVE(1P)
Impressum