1 04/11/83  list_imft_requests, lir
  2 
  3 Syntax:  lir {request_identifiers} {-control_args}
  4 
  5 
  6 Function: lists requests in the Inter-Multics File Transfer queues.
  7 
  8 
  9 Arguments:
 10 request_identifiers
 11    determine which requests in the selected queues (-queue/-all/-ds/-sc)
 12    belonging to the specified users (-admin/-own/-user) are listed.  If
 13    not given, all of the appropriate requests are listed.  See "Notes
 14    on request identifiers" below.
 15 
 16 
 17 List of request_identifiers:
 18 path
 19    lists all requests from the appropriate queues and users whose
 20    source pathnames match the relative pathname path.  The star
 21    convention is allowed.
 22 -entry STR, -et STR
 23    lists all requests from the appropriate queues and users whose
 24    source entry names match STR; the directory portions of the source
 25    pathnames are ignored.  The star convention is allowed.
 26 -id STR
 27    lists all requests from the appropriate queues and users whose
 28    request IDs match the STR.  Type "help request_ids.gi" for a
 29    description of the syntax of STR.
 30 
 31 
 32 Control arguments:
 33 -destination STR, -ds STR
 34    lists requests that are queued for transfer to the remote system
 35    identified by STR.  STR must be one of the names listed by the
 36    print_imft_sites command.
 37 -source STR, -sc STR
 38    lists requests that are queued for transfer from the remote system
 39    identified by STR.  STR must be one of the names listed by the
 40    print_imft_sites command.  If neither -destination nor -source is
 41    specified, the default is -destination imft.
 42 -queue N, -q N
 43    lists requests entered in priority queue N for the above destination
 44    or source where N is an integer between 1 and 4 inclusive.  (Default
 45    -- depends on the destination or source specified)
 46 -all, -a
 47    lists requests entered in all priority queues for the above
 48    destination or source.
 49 
 50 
 51 -brief, -bf
 52    displays minimal information for each request including its request
 53    ID, source pathname, and current state.  (Default)
 54 -long, -lg
 55    displays all information available for each request.
 56 -total, -tt
 57    displays only the total number of matching requests in each queue.
 58 -position, -psn
 59    includes the position within the queue of each request.
 60 -no_position, -npsn
 61    does not include the position within the queue.  (Default)
 62 
 63 
 64 -long_id, -lgid
 65    displays the complete request ID for each request.  (Default if
 66    -long is used)
 67 -short_id, -shid
 68    displays the short form of the request ID for each request.
 69    (Default if -long is not used)
 70 -absolute_pathname, -absp
 71    displayes the absolute pathname of the file or subtree associated
 72    with each request.  (Default if -long is used)
 73 -entryname, -etnm
 74    displays only the entry name of the file or subtree.  (Default if
 75    -long is not used)
 76 
 77 
 78 -admin, -am
 79    lists the matching requests submitted by any user.
 80 -own
 81    lists a matching request only if it was submitted by the user of
 82    this command.  (Default)
 83 -user STR
 84    lists a matching request only if it was submitted by the user
 85    identified by STR.
 86 
 87 
 88 List of user specifications:
 89    the STR given to the -user control argument must have one of the
 90    following forms:
 91 Person.Project
 92    lists only those matching requests entered by the specified user
 93    while logged in on the specified project.
 94 Person.*, Person
 95    lists only those matching requests entered by the specified user
 96    while logged in on any project.
 97 *.Project, .Project
 98    lists only those matching requests entered by any user logged in on
 99    the specified project.
100 *.*, *
101    lists all matching requests regardless of who entered them.
102 
103 
104 Access required: If -position, -admin, or -user is specified, at least
105 "r" extended access is required to the queues; otherwise, at least "o"
106 extended access is required.
107 
108 
109 Notes on request identifiers: If path or -entry STR request identifiers
110 are given, only one -id STR request identifier may be given in which
111 case only those requests which match one of the path or -entry STR
112 identifiers and which match the -id STR identifier are listed.
113 
114 
115 Notes:
116 If conflicting control arguments (eg: -position and -no_position, or
117 -destination and -source) are given on the command line, the rightmost
118 control argument takes effect.