ICL 1900 Series George 3 Operating System Commands

STOPLIST (SL)

Function

Deletes all or some entries in :SYSTEM.OUTPUT of files waiting to be listed following a LISTFILE command. Note that STOPLIST is not provided to stop a listing which is in progress; TERMINATE may be used to do this.

Format

1. STOPLIST output peripheral type,PROPERTYconsole property name
2. STOPLIST output peripheral type
3. STOPLIST username, jobname, output peripheral type, file name

Forbidden contexts

NOT OPERATOR,REMOTE (Format 1)
NOT OPERATOR (Formats 2 and 3)

Execution

1. Format 1
   All entries corresponding to files waiting to be listed on the specified peripheral type on the cluster specified by the console property name are deleted from the file :SYSTEM.OUTPUT. This format allows the operator to delete all the required entries in the case where the specified peripheral was available when a LISTFILE command was analysed but has become unavailable before the listing could be produced.
   
   If the console property name is not specified, all listfiles for a peripheral of the specified type are deleted if the listing was intended for a central device.
   
   
2. Format 2
   All entries corresponding to files waiting to be listed on the specified peripheral type on the cluster the console of which was used to issue the STOPLIST command are deleted from the file :SYSTEM.OUTPUT.
   
   Note that the result is undefined if the specified peripheral is still available and a file is in the process of being listed. Once a peripheral has been allocated by GEORGE for a listing, that listing is considered to be in progress and this command cannot be used to stop the listing.
   
   
3. Format 3
   The entry or entries in :SYSTEM.OUPUT, corresponding to the specified file waiting to be listed following a LISTFILE command, are deleted. This format allows the operator to delete the required entry when a user asks that the listing of a file be abandoned. It is assumed that the user requested the listing of the file by a LISTFILE command.

If the required file is actually being listed, or if the LISTFILE command is being implemented the following message is output on the operator's console:

    REQUIRED FILE BEING LISTFILED ON UNIT n

where n is the operator's number of the device.

The filename specified in the STOPLIST command must be exactly the same as that given in the user's LISTFILE command.

If there are no files of the type specified the following message is output on the operator's console:

    NO SUCH FILES

Note that if format 1 or 2 is used, and a peripheral has already been allocated for the listing this message may occur even if the listing does not appear to have started, for example if the peripheral concerned has not yet been engaged.

Error Messages

z IS NOT A TERMINAL FILE
INVALID NUMBER OF PARAMETERS
NO PARAMETERS
z IS NOT A CONSOLE PROPERTY