ICL 1900 Series George 3 Operating System Commands

WHATRVS (WV)

Function

Outputs to a line printer or operator's console a specified amount of information about a specified selection of RETRIEVE requests.

Format

WHATRVS selection parameter,output level parameter,routing parameter

The selection parameter, if present, is one of:-
    USERusername - Outstanding RVs from specified directory
    jobnumber - Outstanding RVs for specified job
    username,jobname - Outstanding RVs for specified job
    jobname,username - Outstanding RVs for specified job
    ALL - All outstanding RVs (default)

The output level parameter, if present, is FULL

The routing parameter, if present, is one of:-
    HERE
    LIST
    LIST (PROPERTY property name string)

Notes

1. The parameters are all optional and may appear in any order, except that jobnumber, username,jobname or jobname,username, if used must appear first
2. LIST always implies FULL
3. PROPERTY may be abbreviated to PR

Forbidden contexts

NOT OPERATOR

Execution

A specified amount of information about a specified selection of RETRIEVE requests is routed according to the routing parameter or output on the operator's console if no parameter is given.

Output from WHATRVS

1. If FULL is present or implied by the presence of LIST, the following heading is produced:-
   
   n RETRIEVES (selection details)
   
   This is followed by a list of outstanding RETRIEVE requests that satisfy the selection criteria, giving file description, username, jobname or job number of each requesting job and, if known, the tsn's of any mafnetic tapes selected to satisfy the RETRIEVE. This list is output in ascending order of increment.
   
   
2. If FULL is neither present nor implied, the output is:-
   
   n RETRIEVES (selection details)
   
   where n is the number of files satisfying the selection criteria
   
   
3. If there are no outstanding RETRIEVE requests covered by the selection parameters, the following message appears, whether or not FULL applies:-
   
   NO OUTSTANDING RETRIEVES (selection details)
   
   

Routing of output from WHATRVS

1. If the parameter HERE is given, the output is sent directly to the operator's console.
   FULL level output to an operator's console is terminated after that for n RETRIEVE requests and the following message is output:-
   
   OUTPUT TERMINATED
   
   The value of n is normally 100 but can be changed by use of the Restore Time Macro WVOUTLIM.
   
   
2. If LIST is given and there are outstanding RETRIEVE requests which satisfy the selection criteria, the output is sent to a file :OPERATORS.WHATRVS(n) which is listed and erased by internally issuing the command:-
   
   RJ WVLISTn,:OPERATORS,WVLISTJDF
   
   
3. If a LIST parameter with properties is given, the listing is sent to a line printer with the specified properties.

Examples

WHATRVS
WHATRVS 127,LIST

Notes

1. WHATRVS(WV) is permitted for use with the OPERATOR command to any user with the PASSIVOP privilege
2. The use of the WHATRVS(WV) command is optional and is switched on by using the Restore Time Macro WHATRET