1 10/08/80  cancel_retrieval_request, crr
 2 
 3 Syntax:  crr request_identifiers {-control_args}
 4 
 5 
 6 Function:  allows a user to delete a request for a volume retrieval
 7 that is no longer needed.
 8 
 9 
10 Arguments:
11    request_identifiers can be chosen from the following:
12 path
13    is the full or relative pathname of the segment or subtree of the
14    retrieval request to be cancelled.  The star convention is allowed.
15 -entry STR, -et STR
16    identifies the request to be cancelled by STR, the entryname portion
17    of the segment or subtree pathname.  The star convention is allowed.
18 -id ID
19    identifies the request to be cancelled specified by its request ID
20    number.  This identifier may be used to further define any path or
21    -entry identifier (see "Notes").
22 
23 
24 Control arguments:
25 -all, -a
26    indicates that all retrieval queues are to be searched starting with
27    the highest priority queue and ending with the lowest priority
28    queue.  This control argument is incompatible with the -queue
29    control argument.
30 -brief, -bf
31    suppresses messages telling the user that a particular request
32    identifier was not found or that requests were cancelled when using
33    star names or the -all control argument.
34 
35 
36 -queue N, -q N
37    specifies that retrieval queue N contains the request to be
38    cancelled, where N is a decimal integer specifying the number of the
39    queue.  If this control argument is omitted, only the default
40    priority queue is searched.  This control argument is incompatible
41    with the -all control argument.
42 -user User_id
43    specifies the name of the submitter of the requests to be cancelled,
44    if not equal to the group identifier of the process.  The User_id
45    can be Person_id.Project_id, Person_id, or .Project_id.  Both r and
46    d extended access to the queue are required.  This control argument
47    is primarily for operators and administrators.
48 
49 
50 Access required:  The user must have o extended access to the queue to
51 cancel their own requests.  The user must have r and d extended access
52 to cancel a request entered by another user.
53 
54 
55 Notes:  If any path or -entry STR request identifiers are given, only
56 one -id ID request identifier will be accepted and it must match any
57 requests selected by path or entryname.
58 
59 Multiple -id ID identifiers can be specified in a single command
60 invocation only if NO path or entry request identifiers are given.
61 
62 
63 Normally, deletion can be made only by the user who originated the
64 request.
65 
66 When star names are not used and a single request identifier matches
67 more than one request in the queue(s) searched, none of the requests
68 are cancelled.  However, a message is printed telling how many matching
69 requests there are.
70