1 01/21/86  move_abs_request, mar
 2 
 3 Syntax as a command:  mar request_identifiers {-control_args}
 4 
 5 
 6 Function: moves a request from one absentee queue to another.  The
 7 request is always placed at the end of the target queue.
 8 
 9 
10 Arguments:
11 request_identifiers
12    you can specify them in one of the following forms:
13    path
14       is the full or relative pathname for the absentee input segment
15       of requests to be moved.  The star convention is allowed.
16    -entry STR, -et STR
17       identifies requests to be moved by STR, the entryname portion of
18       the absentee input segment pathname.  The star convention is
19       allowed.
20    -id ID
21       identifies one or more requests to be moved by
22       request_identifier.  You can use this identifier to further
23       define any path or -entry identifier (see "Notes").
24 
25 
26 Control arguments:
27 -all, -a
28    searches all queues for the requests to be moved.  It is
29    incompatible with -foreground and -queue.  (Default)
30 -brief, -bf
31    suppresses messages telling that a particular request_id was not
32    found or which requests were moved when using star names or -all.
33 -foreground, -fg
34    moves the requests contained in the foreground queue.
35 -queue N, -q N
36    specifies that queue N for the given request type contains the
37    request to be moved, where N is an integer specifying the number for
38    the queue.
39 
40 
41 -sender STR
42    moves only requests from sender STR.  You must give one or more
43    request identifiers.
44 -to_queue N, -tq N
45    specifies which queue to move the request to.  (Required)
46 
47 
48 -user User_id
49    is a character string giving the name of the submitter of the
50    request if not equal to the group ID of the process.  This control
51    argument is primarily for operators and administrators.  User_id can
52    be Person_id.Project_id, Person_id, or .Project_id.  You need both r
53    and d extended access to the queue.  This control argument causes
54    the command to use privileged message segment primitives that
55    preserve the original identity of the submitter.  You need the AIM
56    ring_1 privilege to preserve the original AIM attributes.  If ring_1
57    privilege is not present, your AIM attributes are used.  (Default:
58    only requests entered by you are moved)
59 
60 
61 Access required: You must have o extended access to the queue from
62 which the request is being taken, and a access to the queue to which
63 the request is being moved.  You must have r and d extended access to
64 move a request owned by another.
65 
66 
67 Notes: If you give any path or -entry, only one -id is accepted and it
68 must match any requests selected by path or -entry.
69 
70 You can supply multiple -id identifiers in a single invocation only if
71 you give no path or -entry.
72 
73 When you use no star names and a single request identifier matches more
74 than one request in the queue(s) searched, none of the requests are
75 moved; however, a message is printed telling how many matching requests
76 there are.
77 
78 If the request is already running, it is not moved and a message is
79 printed.