1 02/15/85 move_daemon_request, mdr
2
3 Syntax as a command: mdr request_identifiers -control_args
4
5
6 Function: moves a request from one I/O daemon queue to another. The
7 move can be within the same request type or from one request type to
8 another. The request is always placed at the end of the target queue.
9
10
11 Arguments:
12 request_identifiers
13 Can be specified in one of the following forms:
14 path
15 identifies a request to be moved by the full or relative pathname
16 of the input data segment. The star convention is allowed.
17 -entry STR, -et STR
18 identifies a request to be moved by STR, the entryname portion of
19 the input data segment pathname. The star convention is allowed.
20 -id ID
21 identifies one or more requests to be moved by request
22 identifier. This identifier may be used to further define any
23 path or -entry identifier see "Notes".
24
25
26 Control arguments:
27 -all, -a
28 searches all queues for the requests to be moved. The target queue
29 is not searched by -all if the source and target request types are
30 identical. This control argument is incompatible with -queue.
31 -brief, -bf
32 suppresses messages telling the user that a particular request
33 identifier was not found or that requests were moved when using star
34 names or the -all control argument.
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. If you omit -queue, all the queues are searched.
39
40
41 -request_type STR, -rqt STR
42 specifies that the request moved is found in the queues for the
43 request type identified by STR. If this control argument is not
44 specified, the default request type is "printer". Request types can
45 be listed by the print_request_types command.
46 -to_queue N, -tq N
47 specifies which queue to move the request to. If not given, the
48 default queue of the target request type is used.
49 -to_request_type STR, -to_rqt STR
50 specifies that the request should be moved to request type STR. If
51 this control argument is not specified, the original request type is
52 used. The target request types must be of the same generic type as
53 the original request type.
54
55
56 -user User_id
57 specifies the name of the submitter of the requests to be moved.
58 The default is to move only requests entered by the user executing
59 the command. The User_id can be Person_id.Project_id, Person_id, or
60 .Project_id. This control argument is primarily for the operator
61 and administrators. Both r and d extended access to the queue are
62 required. This control argument causes the command to use
63 privileged message segment primitives that preserve the original
64 identity of the submitter. If the process has access isolation
65 mechanism AIM ring one privilege, the AIM attributes of the
66 original submitter are preserved. Otherwise, the AIM attributes of
67 the current process are used.
68
69
70 Access required: The user must have o extended access to the queue
71 from which the request is being taken, and a access to the queue to
72 which the request is being moved. The user must have r and d extended
73 access to move a request owned by another user see the description of
74 the -user control argument above.
75
76
77 Notes: If any path or -entry STR request identifiers are given, only
78 one -id ID request identifier will be accepted and it must match any
79 requests selected by path or entryname.
80
81 Multiple -id ID identifiers can be specified in a single command
82 invocation only if no path or entry request identifiers are given.
83
84 When star names are not used and a single request identifier matches
85 more than one request in the queues searched, none of the requests
86 are moved. However, a message is printed telling how many matching
87 requests are found.
88
89 If the request is already running, it is not moved and a message is
90 printed to the user.