10/11/88 request_info, rqi Syntax as a command: rqi type info_keys {-control_args} Syntax as an active function: [rqi type info_keys {-control_args}] Function: Prints or returns specific information about related request(s) in a request queue. Arguments: type is the request type specifying which request queue to search. Valid request types are absentee (abs), retrieval (retv), imft, io, output (out), or any specific output request type (eg, printer). info_keys is one or more keywords, separated by a space, specifying the information requested (See sections below whose titles begin with "List of keywords"). Control arguments: -admin {User_id}, -am {User_id} selects the requests of all users or of the user specified by User_id. Default is to select only your own requests. (See "Access Required and Notes below.") -all, -a searches all queues. This control argument is incompatible with -queue. -deferred_indefinitely, -dfi selects only requests that are deferred indefinitely. Such requests are not run until the operator releases them. This control argument may be used with the absentee request type only. -destination STR, -ds STR selects requests that are queued for transfer to the remote system identified by STR. STR must be one of the names listed by the print_imft_sites command. This control argument may only be used with the imft request type keyword. -entry STR, -et STR selects only requests whose entrynames match STR. You can use the star convention. Directory portions of request pathnames are ignored when selecting requests. -foreground, -fg searches only the foreground queue. (see -queue). This control argument may only be used with the absentee request type keyword. -forms {STR} selects only requests which specify output forms. If you specify STR, only requests matching STR will be chosen. This control argument may be used with the output or any specific output request type only. -id ID selects only requests whose identifier matches the specified ID. -immediate, -im selects only requests that can be run immediately upon reaching the heads of their respective queues. This excludes requests deferred indefinitely, requests deferred until a specific time, or requests that have reached the head of the queue and have been deferred by the system because their CPU time limits are higher than the maximum for the current shift; but it includes requests deferred because of load control or resource unavailability, because those conditions could change at any time. This control argument may be used with all request types except retrieval. -pathname PATH, -pn PATH, -p PATH selects only the requests matching PATH, where PATH may be an absolute pathname or relative pathname. You can use the star convention. Use of this control argument is incompatible with -et. -queue N, -q N searches only queue N. If you do not give -q, all queues are searched but nothing is printed for queues from which no requests are selected. For convenience in writing exec_coms and abbreviations, the word "foreground" ("fg") following -q is equivalent to -fg. -resource {STR}, -rsc {STR} selects only requests having a resource requirement. If you specify STR, only requests whose resource descriptions containing that string are chosen. This control argument may only be used with the absentee request type keyword. -sender STR selects only requests from sender STR. You must specify one or more request identifiers. In most cases, the sender is an RJE station identifier. This control argument may be used with the absentee request type only. -source STR, -sc STR selects requests that are queued for transfer from the remote system identified by STR. STR must be one of the names listed by the print_imft_sites command. If neither -destination nor -source is specified, the default is -destination imft. This control argument may only be used with the imft request type keyword. -user User_id selects only requests entered by the specified user. (see "Access Required and Notes below"). Access required: You must have o access to the queue(s). You must have r extended access to the queue(s) to use -am, or -user, since it is necessary to read all requests in the queue(s) to select those entered by a specified user. Notes: All queues are searched for your requests by default. Nothing is printed for queues from which no requests are chosen. When a user name is specified, with either the -admin or -user control arguments, then proxy requests are selected if either the user who entered the request, or the proxy user on whose behalf it was entered, matches the specified user name. The final entryname portion of PATH given with -pn argument, the entryname given with -et, and the RJE station name specified after -sender can be star names. If the info_key keyword is inconsistent with the type keyword, an error message is displayed. (See sections below whose titles begin with "List of keywords") The User_id arguments selected after -am or -user can have any of the following forms: Person_id.Project_id matches that user only Person_id.* matches that person on any project Person_id same as Person_id.* *.Project_id matches any user on that project .Project_id same as *.Project_id *.* same as -am with no User_id following it List of keywords common to all request types: all, a prints all request information specific to the given request type. You can't use it in the active function. directory, dr prints the directory portion of the request segment pathname. enter_time, etime, etm prints the date/time the request was entered into the queue. entry, et prints the entryname portion of the request segment pathname. message_type, type, tp prints the type of request: absentee, imft, print, punch, or retrieval. position, pos prints the position within its queue of the selected request. queue, q prints the queue the request was submitted to (1, 2, 3, 4, or fg). request_flags, flags prints the request flags grouped according to their on or off state. If there are no flags within any group, nothing is returned for that group. Individual flag states may be returned by passing the "request_info type flags" active function as the first argument to the "get_mode" command/active function. (See >doc>info>get_mode.info for more information on the usage of get_mode.) (See sections below whose titles begin with "List of request flags"). request_id, id prints the unique request identifier. submitter prints the name of the submitter of the request in the form Person.Project.Tag. state, st prints the state of the request. States may be unprocessed, deferred, transition, eligible, running, bumped, or deferred_until_process_termination. List of keywords specific to absentee request types: args prints the arguments which are input to the absin file. authorization, auth prints the requestor's authorization level. comment prints the comment string supplied by the requestor. deferred_by, dfb prints who deferred the request (operator or the requestor). deferred_time, dftime, time, dftm, tm prints the delayed creation time for the absentee process. home_dir, hd prints the requestor's initial home dir used when the absentee job logs in. initial_ring, ring, rg prints the initial login ring specified by the requestor. init_proc, ip prints the requestor's specified login responder procedure. max_cpu_time, limit, li prints the requestor's cpu limit in seconds. output_file, of prints the absolute pathname of the output file. proxy_name, pxn prints the name of the user for whom the request was submitted. resource, rsc prints the requested resource description. sender prints the name of the RJE station or other sender. List of keywords specific to output request types: bit_count, bc prints the bit count of the segment at request time. bottom_label, blbl prints the bottom page heading for each page of output. copies, cp prints the number of copies of output requested. destination, dest, ds prints the requested destination of the output. forms prints the name of special forms. heading, he prints the requested heading of the output. indent, ind, in prints the value of the requested left margin. line_length, ll prints the requested line length of the output, or "default" if it is the default value. output_conversion, ocv prints the output module indentifier, which can be print, 7punch (7-punch punch), mcc (character conversion punch), or raw (no character conversion). page_length, pl prints the requested page length of the output, or "default" if it is the default value. top_label, tlbl prints the top page heading for each page of output. List of keywords specific to retrieval request types: from_time, fmtime, fmtm prints the date/time of the requested time not to search past. new_dir, ndr prints the directory portion of the requested cross retrieval pathname. new_entry, net prints the entryname portion of the requested cross retrieval pathname. to_time, ttime, ttm prints the date/time of the requested latest time to start search with. List of keywords specific to imft request types: foreign_dir, fdr prints the directory where the branch is to be placed on the target system. foreign_entry, fet prints the entryname where the branch is to be placed on the target system. foreign_user, fu prints the Person.Project of the target recipient. List of request flags common to all request types: notify ON if the interactive submitter wants to be notified upon the starting and the completion of the request. List of request flags common to absentee request types: delete ON if the input file is to be deleted upon completion of the request. dfi ON if the submitter or the operator deferred the request such that it will not start until the operator runs it. dupt ON if processing of request is deferred until the submitters interactive process is terminated. noresources ON if required resources are currently unavailable. nostartup ON if the requester specified -nostart_up when entering the request. proxy ON if request was submitted by proxy (person other than the owner of the request). restartable ON if the request is restartable from the beginning after a premature termination. restarted ON if the request has restarted from the beginning after a premature termination. secondary ON if request is to be logged in as a secondary foreground user. set_bit_cnt ON if the output bit count should be set after every write. truncate ON if the output file is to be truncated prior to the first write. List of request flags common to output request types: center_bot_lbl ON if bottom label of output is to be centered. center_top_lbl ON if top label of output is to be centered. delete ON if the input file is to be deleted upon completion of the request. dupt ON if processing of request is deferred until the submitters interactive process is terminated. escapes ON if escape characters are to be processed for output. line_nbrs ON if output is to contain numbered lines. noendpage ON if no end of page break was requested. nonedited ON if nonprintable control characters are to processed as octal escape sequences. noseparator ON if inner head sheets of multiple copies of output are to be suppressed. single ON if ignoring line feeds and or vertical tabs in output. truncate_lines ON if individual lines are to be truncated to a specified line length in output. List of request flags common to retrieval request types: dirs ON if only subtree directories are requested. prev ON if the most previous object is requested. segs ON if only subtree segments are requested. subtree ON if the entire subtree is requested. List of request flags common to imft request types: always_chase ON if links are to be chased. default_chase ON if chasing only non-starnames. delete ON if source pathname is to be deleted immediately after a successful transfer. extend ON if source file is to added at end of target file. foreign_path_given ON if target pathname is different from the local (source) pathname. foreign_user_given ON if the target userid is different from the local (source) userid. files ON if matching only files resident to the working dir when interpreting starnames. This flag is displayed only when the request is being queued from the remote site. replace ON if target files are to be replaced rather than updated or extended. subtrees ON if matching entire subtrees when interpreting starnames. This flag is displayed only when the request is being queued from the remote site. merge_dirs ON if merging the source subtree into a target directory with a name the same as the root directory of the source substree. never_chase ON if links are not to be chased. remote_trans ON if requesting a file transfer from a remote system to the local system. replace_dirs ON if a remote entry is to be deleted (or removed if an addname) when the root directory of the source substree has the same name. update ON if source file is to replace the contents of the target file without deleting the target path or changing any of its attributes. ----------------------------------------------------------- Historical Background This edition of the Multics software materials and documentation is provided and donated to Massachusetts Institute of Technology by Group BULL including BULL HN Information Systems Inc. as a contribution to computer science knowledge. This donation is made also to give evidence of the common contributions of Massachusetts Institute of Technology, Bell Laboratories, General Electric, Honeywell Information Systems Inc., Honeywell BULL Inc., Groupe BULL and BULL HN Information Systems Inc. to the development of this operating system. Multics development was initiated by Massachusetts Institute of Technology Project MAC (1963-1970), renamed the MIT Laboratory for Computer Science and Artificial Intelligence in the mid 1970s, under the leadership of Professor Fernando Jose Corbato. Users consider that Multics provided the best software architecture for managing computer hardware properly and for executing programs. Many subsequent operating systems incorporated Multics principles. Multics was distributed in 1975 to 2000 by Group Bull in Europe , and in the U.S. by Bull HN Information Systems Inc., as successor in interest by change in name only to Honeywell Bull Inc. and Honeywell Information Systems Inc. . ----------------------------------------------------------- Permission to use, copy, modify, and distribute these programs and their documentation for any purpose and without fee is hereby granted,provided that the below copyright notice and historical background appear in all copies and that both the copyright notice and historical background and this permission notice appear in supporting documentation, and that the names of MIT, HIS, BULL or BULL HN not be used in advertising or publicity pertaining to distribution of the programs without specific prior written permission. Copyright 1972 by Massachusetts Institute of Technology and Honeywell Information Systems Inc. Copyright 2006 by BULL HN Information Systems Inc. Copyright 2006 by Bull SAS All Rights Reserved